Grid 宫格布局

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

平台差异说明

基本使用

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

<template>
    <u-grid :col="3">
        <u-grid-item>
            <u-icon name="photo" :size="46"></u-icon>
            <view class="grid-text">图片</view>
        </u-grid-item>
        <u-grid-item>
            <u-icon name="lock" :size="46"></u-icon>
            <view class="grid-text">锁头</view>
        </u-grid-item>
        <u-grid-item>
            <u-icon name="hourglass" :size="46"></u-icon>
            <view class="grid-text">沙漏</view>
        </u-grid-item>
    </u-grid>
</template>
<style scoped lang="scss">
    .grid-text {
        font-size: 28rpx;
        margin-top: 4rpx;
        color: $u-type-info;
    }
</style>

给宫格设置右上角的角标和图标

可以通过uView的badge(注意Badge在此需要设置相关定位属性，详见Badge)或者image设置宫格有右上角的内容

<template>
    <u-grid :col="3">
        <u-grid-item>
            <u-badge count="9" :offset="[20, 20]"></u-badge>
            <u-icon name="photo" :size="46"></u-icon>
            <view class="grid-text">图片</view>
        </u-grid-item>
        <u-grid-item>
            <image src="/static/image/icon/hot5.png" class="badge-icon"></image>
            <u-icon name="lock" :size="46"></u-icon>
            <view class="grid-text">锁头</view>
        </u-grid-item>
        <u-grid-item>
            <u-icon name="hourglass" :size="46"></u-icon>
            <view class="grid-text">沙漏</view>
        </u-grid-item>
    </u-grid>
</template>
<style scoped lang="scss">
    .badge-icon {
        position: absolute;
        top: 14rpx;
        right: 40rpx;
        width: 30rpx;
        height: 30rpx;
    }
    .grid-text {
        font-size: 28rpx;
        margin-top: 4rpx;
        color: $u-type-info;
    }
</style>

实现宫格的左右滑动

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

<template>
    <swiper class="swiper" @change="change">
        <swiper-item>
            <u-grid :col="3" @click="click" hover-class="hover-class">
                <u-grid-item v-for="(item, index) in list" :index="index" :key="index">
                    <u-icon :name="item" :size="46"></u-icon>
                    <text class="grid-text">{{ '宫格' + (index + 1) }}</text>
                </u-grid-item>
            </u-grid>
        </swiper-item>
        <swiper-item>
            <u-grid :col="3" @click="click">
                <u-grid-item v-for="(item, index) in list" :index="index + 9" :key="index">
                    <u-icon :name="item" :size="46"></u-icon>
                    <text class="grid-text">{{ '宫格' + (index + 1) }}</text>
                </u-grid-item>
            </u-grid>
        </swiper-item>
        <swiper-item>
            <u-grid :col="3" @click="click">
                <u-grid-item v-for="(item, index) in list" :index="index + 18" :key="index">
                    <u-icon :name="item" :size="46"></u-icon>
                    <text class="grid-text">{{ '宫格' + (index + 1) }}</text>
                </u-grid-item>
            </u-grid>
        </swiper-item>
    </swiper>
    <view class="indicator-dots" v-if="isSwiper">
        <view class="indicator-dots-item" :class="[current == 0 ? 'indicator-dots-active' : '']">
        </view>
        <view class="indicator-dots-item" :class="[current == 1 ? 'indicator-dots-active' : '']">
        </view>
        <view class="indicator-dots-item" :class="[current == 2 ? 'indicator-dots-active' : '']">
        </view>
    </view>
</template>
<script>
    export default {
        data() {
            return {
                current: 0,
                list: ['integral', 'kefu-ermai', 'coupon', 'gift', 'scan', 'pause-circle', 'wifi', 'email', 'list']
            };
        },
        methods: {
            change(e) {
                this.current = e.detail.current;
            }
        }
    };
</script>
<style scoped lang="scss">
    /* 下方这些scss变量为uView内置变量，详见开发  组件-指南-内置样式 */
    .grid-text {
        font-size: 28rpx;
        margin-top: 4rpx;
        color: $u-type-info;
    }
    .swiper {
        height: 480rpx;
    }
    .indicator-dots {
        margin-top: 40rpx;
        display: flex;
        justify-content: center;
        align-items: center;
    }
    .indicator-dots-item {
        background-color: $u-tips-color;
        height: 6px;
        width: 6px;
        border-radius: 10px;
        margin: 0 3px;
    }
    .indicator-dots-active {
        background-color: $u-type-primary;
    }
</style>

API

Grid Props

Grid-item Props

Grid Event

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

Grid Event

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