You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

3.4 KiB

title description spline isComponent
Grid 宫格 用于功能入口布局,将页面或特定区域切分成若干等大的区块,形成若干功能入口。 data true

引入

全局引入,在 miniprogram 根目录下的app.json中配置,局部引入,在需要引入的页面或组件的index.json中配置。

"usingComponents": {
  "t-grid": "tdesign-miniprogram/grid/grid",
  "t-grid-item": "tdesign-miniprogram/grid-item/grid-item"
}

代码演示

组件类型

基础宫格

{{ base }}

带说明的宫格

{{ description }}

带边框的宫格

{{ border }}

带徽章的宫格

{{ badge }}

可滑动的宫格

{{ scroll }}

组件样式

可传图标的宫格

{{ icon-grid }}

多行宫格

{{ multiple }}

卡片宫格

{{ card }}

API

Grid Props

名称 类型 默认值 说明 必传
align String center 内容对齐方式。可选项left/center N
border Boolean / Object false 边框,默认不显示。值为 true 则显示默认边框,值类型为 object 则表示自定义边框样式。TS 类型:boolean | { color?: string; width?: string; style?: 'solid' | 'dashed' | 'dotted' | 'double' | 'groove' | 'inset' | 'outset' } N
column Number 4 每一行的列数量;为 0 时等于固定大小 N
external-classes Array - 组件类名,用于设置组件外层元素类名。['t-class'] N
gutter Number - 间隔大小 N
hover Boolean false 是否开启点击反馈 N
theme String default 宫格的风格。可选项default/card N

GridItem Props

名称 类型 默认值 说明 必传
badge-props Object null 透传至 Badge 属性。TS 类型:BadgePropsBadge API Documents详细类型定义 N
description String / Slot - 文本以外的更多描述,辅助信息。可以通过 Props 传入文本,也可以自定义标题节点 N
external-classes Array - 组件类名,分别用于设置组件外层元素、图片、文本、描述等元素类名。['t-class', 't-class-image', 't-class-text', 't-class-description'] N
icon String / Object - 图标名称。值为字符串表示图标名称,值为 Object 类型,表示透传至 icon N
image String / Slot - 图片,可以是图片地址,也可以自定义图片节点 N
image-props Object - 透传至 Image 组件 N
jump-type String navigate-to 链接跳转类型。可选项redirect-to/switch-tab/relaunch/navigate-to N
layout String vertical 内容布局方式。可选项vertical/horizontal N
text String / Slot - 文本,可以通过 Props 传入文本,也可以自定义标题节点 N
url String - 点击后的跳转链接 N