目录

grid-view

网格布局容器和瀑布流布局容器。

起始版本: 2.0.6

约束与限制:

  1. 仅支持作为<scroll-view>的子节点使用。

  2. 按需渲染节点,具备更好的性能。

  3. 仅针对在末尾增删元素做优化,尽量避免在中间插入子元素。

  4. 子节点过多时仍会影响布局性能。

  5. 暂不支持scroll-view组件中使用多个grid-view组件。

属性:

名称 类型 默认值 必填 描述
type string "aligned" 否 布局方式。可选值为aligned(网格布局)或masonry(瀑布流布局)。
cross-axis-count number 2 否 交叉轴元素数量,即网格的列数,需大于0。
max-cross-axis-extent number 0 否 交叉轴元素最大范围,0表示不限制,需大于等于0。
main-axis-gap number 0 否 主轴方向间隔,单位:px,需大于等于0。
cross-axis-gap number 0 否 交叉轴方向间隔,单位:px,需大于等于0。
padding Array [0, 0, 0, 0] 否 长度为4的数组,按top、right、bottom、left顺序指定内边距,单位:px。

当type="masonry"时,grid-view的子元素需注意以下事项:

  1. 需具有可见的宽高(clientWidth和clientHeight)。例如:设置display: block属性;使用<image>组件时,应当手动指定高度或设置mode="widthFix"。
  2. 若使用padding、margin等影响盒模型的CSS属性,需同时设置box-sizing: border-box。

示例:

  1. 网格布局示例(type="aligned"):

    hxml文件:

    <scroll-view type="custom" scroll-y="true" style="height: 400px">
      <grid-view type="aligned"
        cross-axis-count="3"
        main-axis-gap="10"
        cross-axis-gap="10"
        padding="[10, 10, 10, 10]">
        <view class="grid-item">Item 1</view>
        <view class="grid-item">Item 2</view>
        <view class="grid-item">Item 3</view>
        <view class="grid-item">Item 4</view>
        <view class="grid-item">Item 5</view>
        <view class="grid-item">Item 6</view>
      </grid-view>
    </scroll-view>

    js文件:

    Page({
      data: {}
    });

    css文件:

    .grid-item {
        height: 100px;
        background-color: #e0f0ff;
        display: flex;
        align-items: center;
        justify-content: center;
    }
  2. 瀑布流布局示例(type="masonry"):

    hxml文件:

    <scroll-view type="custom" scroll-y="true" style="height: 500px">
      <grid-view type="masonry"
        cross-axis-count="2"
        main-axis-gap="10"
        cross-axis-gap="10"
        padding="[10, 10, 10, 10]">
        <view class="masonry-item item-1">短内容</view>
        <view class="masonry-item item-2">较长内容,用于展示瀑布流效果</view>
        <view class="masonry-item item-3">中等长度内容</view>
        <view class="masonry-item item-4">这是一段更长的内容,用来演示瀑布流布局中不同高度子元素的排列效果</view>
        <view class="masonry-item item-5">内容</view>
        <view class="masonry-item item-6">补充内容</view>
      </grid-view>
    </scroll-view>

    js文件:

    Page({
      data: {}
    });

    css文件:

    .masonry-item {
        display: block;
        padding: 16px;
        box-sizing: border-box;
        border-radius: 8px;
        color: #ffffff;
    }
    
    .item-1 { background-color: #67c23a; }
    .item-2 { background-color: #e6a23c; }
    .item-3 { background-color: #409eff; }
    .item-4 { background-color: #f56c6c; }
    .item-5 { background-color: #9b59b6; }
    .item-6 { background-color: #1abc9c; }