网格布局容器和瀑布流布局容器。
起始版本: 2.0.6
约束与限制:
属性:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| 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的子元素需注意以下事项:
示例:
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;
} 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; }