t-grid

Grid 宫格

组件介绍

t-grid 宫格组件以灵活的栅格系统为核心，通过配置列数和可选边框，以及自定义子项样式，实现整齐划一的布局，为内容展示提供清晰有序的视觉体验。

平台兼容

Harmony	H5	Android	iOS	小程序	UTS
✅	✅	✅	✅	✅	✅

基础用法

基础用法参考 demo/grid/grid.uvue，通过 t-grid-item 子组件定义宫格项。

<!-- 基础宫格 -->
<t-grid :column="4">
  <t-grid-item icon="home" label="首页"></t-grid-item>
  <t-grid-item icon="search" label="搜索"></t-grid-item>
  <t-grid-item icon="message" label="消息"></t-grid-item>
  <t-grid-item icon="user" label="我的"></t-grid-item>
</t-grid>

<!-- 三列宫格 -->
<t-grid :column="3">
  <t-grid-item icon="photo" label="相册"></t-grid-item>
  <t-grid-item icon="camera" label="拍照"></t-grid-item>
  <t-grid-item icon="video" label="视频"></t-grid-item>
</t-grid>

Props

属性名	说明	类型	默认值
path	点击组件后跳转的页面路径；为空时仅响应事件	string	''
hover	是否启用点击效果	boolean	false
type	组件主题类型，可选 info、primary、error、warning、success	string	''
disabled	是否禁用	boolean	false
effect	组件显示主题，可选 normal、dark、light、plain	string	'normal'
size	组件尺寸，可选 large、medium、small、mini	string	'medium'
column	网格列数	number	4
childClass	统一设置子组件的样式，如果子组件也设置了样式，则合并。优先级低于子组件	string	''
childIconClass	统一设置子组件图标的样式，如果子组件也设置了样式，则合并。优先级低于子组件	string	's-70'
childLabelClass	统一设置子组件标题文本样式，如果子组件也设置了样式，则合并。优先级低于子组件	string	''

Events

事件名	说明	回调参数
click	点击时触发	-
transitionend	动画结束时触发	-
initFinished	组件初始化完成时触发，返回组件节点信息	-
touchstart	触摸开始时触发	-
touchend	触摸结束时触发	-
touchmove	触摸移动时触发	-
touchcancel	触摸取消时触发	-

Slots

插槽名	说明
default	默认插槽，放置 t-grid-item 子组件