Grid 宫格布局 | zxUI是一套基于Vue.js开发的uni-app跨平台UI框架，提供了丰富的组件、布局及界面库。

# Grid 宫格布局

宫格组件一般用于同时展示多个同类项目的场景，可以给宫格的项目设置徽标组件(badge)，或者图标等，也可以扩展为左右滑动的轮播形式。

# 平台差异说明

App（vue）	App（nvue）	H5	小程序
√	√	√	√

# 基本使用

该组件外层为zx-grid组件包裹，通过col设置内部宫格的列数
内部通过zx-grid-item组件的slot设置宫格的内容
如果不需要宫格的边框，可以设置border为false

<template>
    <view>
        <zx-grid
                :border="false"
                @click="click"
        >
            <zx-grid-item
                    v-for="(baseListItem,baseListIndex) in baseList"
                    :key="baseListIndex"
            >
                <zx-icon
                        :customStyle="{paddingTop:20+'rpx'}"
                        :name="baseListItem.name"
                        :size="22"
                ></zx-icon>
                <text class="grid-text">{{baseListItem.title}}</text>
            </zx-grid-item>
        </zx-grid>
        <zx-toast ref="uToast" />
    </view>
</template>

<script>
    export default {
        data() {
            return {
                baseList: [{
                    name: 'photo',
                    title: '图片'
                    },
                    {
                        name: 'lock',
                        title: '锁头'
                    },
                    {
                        name: 'star',
                        title: '星星'
                    },
                ]
            }
        },
        methods: {
            click(name) {
                this.$refs.uToast.success(`点击了第${name}个`)
            }
        }
    }
</script>

<style lang="scss">
    .grid-text {
        font-size: 14px;
        color: #909399;
        padding: 10rpx 0 20rpx 0rpx;
        /* #ifndef APP-PLUS */
        box-sizing: border-box;
        /* #endif */
    }
</style>

# 绑定点击事件&自定义列数

<template>
    <view>
        <zx-grid
                :border="false"
                col="4"
        >
            <zx-grid-item
                    v-for="(listItem,listIndex) in list"
                    :key="listIndex"
            >
                <zx-icon
                        :customStyle="{paddingTop:20+'rpx'}"
                        :name="listItem.name"
                        :size="22"
                ></zx-icon>
                <text class="grid-text">{{listItem.title}}</text>
            </zx-grid-item>
        </zx-grid>
        <zx-toast ref="uToast" />
    </view>
</template>

<script>
    export default {
        data() {
            return {
                list: [{
                    name: 'photo',
                    title: '图片'
                    },
                    {
                        name: 'lock',
                        title: '锁头'
                    },
                    {
                        name: 'star',
                        title: '星星'
                    },
                    {
                        name: 'hourglass',
                        title: '沙漏'
                    },
                    {
                        name: 'home',
                        title: '首页'
                    },
                    {
                        name: 'star',
                        title: '音量'
                    },
                ],
            }
        },
        methods: {
            click(name) {
                this.$refs.uToast.success(`点击了第${name}个`)
            }
        }
    }
</script>

<style lang="scss">
    .grid-text {
        font-size: 14px;
        color: #909399;
        padding: 10rpx 0 20rpx 0rpx;
        /* #ifndef APP-PLUS */
        box-sizing: border-box;
        /* #endif */
    }
</style>

# 实现宫格的左右滑动

结合uni的swiper组件可以实现宫格的左右滑动，因为swiper特性的关系，请指定swiper的高度，否则swiper的高度不会被内容撑开，可以自定义swiper的指示器，达到更高的灵活度

<template>
    <view>
        <swiper
                :indicator-dots="true"
                class="swiper"
        >
            <swiper-item>
                <zx-grid :border="true">
                    <zx-grid-item
                            :customStyle="{width:220+'rpx',height:220+'rpx'}"
                            v-for="(item, index) in swiperList"
                            :index="index"
                            :key="index"
                    >
                        <zx-icon
                                :customStyle="{paddingTop:20+'rpx'}"
                                :name="item"
                                :size="22"
                        ></zx-icon>
                        <text class="grid-text">{{ '宫格' + (index + 1) }}</text>
                    </zx-grid-item>
                </zx-grid>
            </swiper-item>
            <swiper-item>
                <zx-grid :border="true">
                    <zx-grid-item
                            :customStyle="{width:220+'rpx',height:220+'rpx'}"
                            v-for="(item, index) in swiperList"
                            :index="index + 9"
                            :key="index"
                    >
                        <zx-icon
                                :customStyle="{paddingTop:20+'rpx'}"
                                :name="item"
                                :size="22"
                        ></zx-icon>
                        <text class="grid-text">{{ '宫格' + (index + 1) }}</text>
                    </zx-grid-item>
                </zx-grid>
            </swiper-item>
            <swiper-item>
                <zx-grid :border="true">
                    <zx-grid-item
                            :customStyle="{width:220+'rpx',height:220+'rpx'}"
                            v-for="(item, index) in swiperList"
                            :index="index + 18"
                            :key="index"
                    >
                        <zx-icon
                                :customStyle="{paddingTop:20+'rpx'}"
                                :name="item"
                                :size="22"
                        ></zx-icon>
                        <text class="grid-text">{{ "宫格" + (index + 1) }}</text>
                    </zx-grid-item>
                </zx-grid>
            </swiper-item>
        </swiper>
    </view>
</template>

<script>
	export default {
		data() {
			return {
                swiperList: ['integral', 'kefzx-ermai', 'coupon', 'gift', 'scan', 'pause-circle', 'wifi', 'email', 'list'],
			};
		}
	};
</script>

<style lang="scss">
    .swiper {
        height: 720rpx;
    }

    .grid-text {
        font-size: 14px;
        color: #909399;
        padding: 10rpx 0 20rpx 0rpx;
        /* #ifndef APP-PLUS */
        box-sizing: border-box;
        /* #endif */
    }
</style>

# API

# Grid Props

参数	说明	类型	默认值	可选值
col	宫格的列数	String \| Number	3	-
border	是否显示宫格的边框	Boolean	true	false
align	宫格的对齐方式，用于控制只有一两个宫格时的对齐场景	String	left	center / right

# Grid-item Props

参数	说明	类型	默认值	可选值
name	宫格的name	String \| Number	-	-
bgColor	宫格的背景颜色	String	transparent(背景透明)	-

# Grid Event

注意：请在<zx-grid></zx-grid>上监听此事件

事件名	说明	回调参数
click	点击宫格触发	name

# Grid-item Event

注意：请在<zx-grid-item></zx-grid-item>上监听此事件

事件名	说明	回调参数
click	点击宫格触发	name