全部产品

Grid 宫格

当业务新上线时,可以通过蒙板引导的形式给与用户强制的信息传达。全蒙层引导是一种很重的操作引导,除非页面功能的重大变动,否则不建议使用。小的变化可以用 Tips 引导。

用法

宫格列数:根据需求可以选择 2、3、4、5 列宫格。

宫格行数:数目不受限制。

宫格样式:圆形底、方形底。

文字限制:标题字数不超过5个中文字符;描述文字不超过限制区域,超过自动截断无法继续输入。

是否有虚线分割:页面比较复杂的建议不要线,页面比较单一的建议要线。

扫码体验

image.png

示例代码

// API-DEMO page/component/grid/grid.json
{
  "defaultTitle": "Grid",
  "usingComponents":{
    "grid": "mini-antui/es/grid/index"
  }
}

<!-- API-DEMO page/component/grid/grid.axml -->
<view style="margin-top: 10px;" />
<grid onGridItemClick="onItemClick" columnNum="{{3}}" list="{{list3}}" />
<view style="margin-top: 10px;" />
<grid onGridItemClick="onItemClick" columnNum="{{3}}" list="{{list1}}" />
<view style="margin-top: 10px;" />
<grid onGridItemClick="onItemClick" columnNum="{{3}}" list="{{list3}}" hasLine="{{false}}" />

// API-DEMO page/component/grid/grid.js
Page({
  data: {
    list1: [
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
      },
    ],
    list3: [
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
      {
        icon: 'https://gw.alipayobjects.com/zos/rmsportal/VBqNBOiGYkCjqocXjdUj.png',
        text: '标题文字',
        desc: '描述信息',
      },
    ],
  },
  onItemClick(ev) {
    my.alert({
      content: ev.detail.index,
    });
  },
});

/*  API-DEMO page/component/grid/grid.css */
.am-grid {
  display: flex;
  flex-direction: row;
  flex-wrap: wrap;
  background-color: white;
}

.am-grid-4 {
  padding-top: 7px;
  padding-bottom: 7px;
}

.am-grid-5 {
  padding-top: 6px;
  padding-bottom: 7px;
}

.am-grid-item {
  text-align: center;
  position: relative;
}

.am-grid-3 .am-grid-border {
  position: absolute;
  left: 0;
  bottom: 0;
  width: 100%;
  height: 100%;
  border-bottom: 1rpx solid #eee;
  border-right: 1rpx solid #eee;
  box-sizing: border-box;
}

.am-grid-3 .am-grid-right {
  border-right: none;
}

.am-grid-3 .am-grid-bottom {
  border-bottom: none;
}

.am-grid-3 .am-grid-top {
  height: calc(100% - 15px);
}

.am-grid-item-wrapper {
  position: absolute;
  left: 0;
  bottom: 0;
  width: 100%;
  height: 100%;
  display: flex;
  justify-content: center;
  align-items: center;
  flex-direction: column;
}

.am-grid-2 .am-grid-item-wrapper {
  flex-direction: row;
  justify-content: flex-start;
}

.am-grid-icon-container {
  display: flex;
  justify-content: center;
  align-items: center;
}

.am-grid-icon {
  flex: 1;
  width: 36px;
  height: 36px;
}

.am-grid-text-wrapper {
  display: flex;
  flex-direction: column;
  align-items: flex-start;
}

.am-grid-3 .am-grid-text-wrapper {
  align-items: center;
}

.am-grid-3 .am-grid-text {
  height: 20px;
  line-height: 20px;
}

.am-grid-3 .am-grid-desc {
  height: 17px;
  line-height: 17px;
}

.am-grid-text {
  color: #333;
  font-size: 14px;
  line-height: 1;
  margin-top: 14px;
}

.am-grid-desc {
  color: #999;
  font-size: 12px;
}

.am-grid-2 .am-grid-item.has-desc {
  padding-top: 70px;
}

.am-grid-3 .am-grid-item {
  padding-top: 125px;
}

.am-grid-3.am-grid-no-line {
  padding: 8px 16px 0 16px;
}

.am-grid-no-line .am-grid-item {
  padding-top: 110px;
}

.am-grid-2 .am-grid-item {
  padding-top: 64px;
}


.am-grid-4 .am-grid-item {
  padding-top: 68px;
}

.am-grid-4.circular .am-grid-item {
  padding-top: 82px;
}

.am-grid-3 {
  padding: 0 16px;
}

.am-grid-3 .am-grid-text {
  margin-top: 12px;
}

.am-grid-no-line .am-grid-border {
  border-right: none;
  border-bottom: none;
}

.am-grid-4.circular {
  padding-top: 3px;
}

.am-grid-4.circular .am-grid-icon-container {
  margin-top: 13px;
  padding: 8px;
  border-radius: 50%;
  background-color: #D8D8D8;
}

.am-grid-2 .am-grid-icon-container {
  margin-left: 16px;
}

.am-grid-2 .am-grid-icon {
  width: 28px;
  height: 28px;
}

.am-grid-4 .am-grid-icon-container {
  margin-top: 7px;
}

.am-grid-4 .am-grid-icon {
  height: 28px;
  width: 28px;
}

.am-grid-4.circular .am-grid-icon {
  width: 26px;
  height: 26px;
  flex: 1;
}

.am-grid-4.circular .am-grid-text {
  height: 16px;
  line-height: 16px;
}

.am-grid-5 .am-grid-item {
  padding-top: 75px;
}

.am-grid-5 .am-grid-icon {
  border-radius: 50%;
  width: 43px;
  height: 43px;
}

.am-grid-2 .am-grid-text {
  margin-top: 0;
  margin-left: 12px;
  height: 24px;
  line-height: 24px;
  font-size: 17px;
}

.am-grid-2 .am-grid-desc {
  margin-left: 12px;
  height: 16px;
  line-height: 16px;
}

.am-grid-4 .am-grid-text {
  font-size: 13px;
  height: 13px;
  line-height: 13px;
  margin-top: 7px;
}
.am-grid-5 .am-grid-text {
  font-size: 12px;
  margin-top: 7px;
}

属性

属性名描述类型默认值必选
list宫格数据。Array<icon, text>[]
onGridItemClick点击宫格项回调。(index: Number) => void-
columnNum每行显示几列。2、3、4、53
circular是否圆角。Booleanfalse
hasLine是否有边框。Booleantrue