Table 表格
表格组件一般用于展示大量结构化数据的场景
平台差异说明
App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 头条小程序 | QQ小程序 |
---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ | √ |
基本使用
本组件标签类似HTML的table表格,由table
、tr
、th
、td
四个组件组成
table
组件裹在最外层,可以配置一些基础参数tr
组件用于显示”行”数据th
组件用于显示表头内容,类似td
,不同之处在于字体加粗了,也带有背景颜色,也可以直接用td
替代th
td
组件不是最小单位,为了合并单元格时,内部可以嵌入tr
和td
组件
<template>
<u-table>
<u-tr>
<u-th>学校</u-th>
<u-th>班级</u-th>
<u-th>年龄</u-th>
</u-tr>
<u-tr>
<u-td>浙江大学</u-td>
<u-td>二年级</u-td>
<u-td>22</u-td>
</u-tr>
<u-tr>
<u-td>清华大学</u-td>
<u-td>05班</u-td>
<u-td>20</u-td>
</u-tr>
</u-table>
</template>
合并单元格
注意
由于微信小程序编译后特殊的元素结构,目前合并单元格暂不支持微信小程序端
- 可以在
td
组件嵌入多个tr
,就会得到多行,tr
中再嵌入td
,就可以合并单元格,可以通过width
参数 设置单元格的百分比长度,默认为每个单元格平均分tr
的长度
下面的示例为合并”行”单元格的写法,设置td
的width
为33.33333%,第一行的第一个td
宽度占据三分之一
<u-table>
<u-tr>
<u-td width="33.33333%">浙江大学</u-td>
<u-td>
<u-tr>
<u-td>二年级</u-td>
<u-td>22</u-td>
</u-tr>
<u-tr>
<u-td>二年级</u-td>
<u-td>22</u-td>
</u-tr>
</u-td>
</u-tr>
<u-tr>
<u-td>清华大学</u-td>
<u-td>05班</u-td>
<u-td>20</u-td>
</u-tr>
</u-table>
下面的示例为合并”列”单元格的写法,设置td
的width
为66.66666%,第一行的第一个td
宽度占据总宽度的三分之二
<u-table>
<u-tr>
<u-td width="66.66666%">浙江大学</u-td>
<u-td>
二年级
</u-td>
</u-tr>
<u-tr>
<u-td>清华大学</u-td>
<u-td>05班</u-td>
<u-td>20</u-td>
</u-tr>
</u-table>
API
Table Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
border-color | 表格边框的颜色 | String | #e4e7ed | - |
bg-color | 表格的背景颜色 | String | #ffffff | - |
align | 单元格的内容对齐方式,作用类似css的text-align | String | center | left / right |
padding | 单元格的内边距,同css的padding 写法 | String | 10rpx 0 | - |
font-size | 单元格字体大小,单位rpx | String | Number | 28 | - |
color | 单元格字体颜色 | String | #606266 | - |
th-style | th 单元格的样式,对象形式(将th 所需参数放在table 组件,是为了避免每一个th 组件要写一遍) | Object | {} | - |
Td Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
width | 单元格宽度百分比或者具体带单位的值,如30%, 200rpx等,一般使用百分比,单元格宽度默认为均分tr 的长度 | String | Number | auto | - |
Th Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
width | 标题单元格宽度百分比或者具体带单位的值,如30%, 200rpx等,一般使用百分比,单元格宽度默认为均分tr 的长度 | String | Number | - | - |