Table 表格

表格组件一般用于展示大量结构化数据的场景

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

本组件标签类似HTML的table表格,由tabletrthtd四个组件组成

  • table组件裹在最外层,可以配置一些基础参数
  • tr组件用于显示”行”数据
  • th组件用于显示表头内容,类似td,不同之处在于字体加粗了,也带有背景颜色,也可以直接用td替代th
  • td组件不是最小单位,为了合并单元格时,内部可以嵌入trtd组件
  1. <template>
  2. <u-table>
  3. <u-tr>
  4. <u-th>学校</u-th>
  5. <u-th>班级</u-th>
  6. <u-th>年龄</u-th>
  7. </u-tr>
  8. <u-tr>
  9. <u-td>浙江大学</u-td>
  10. <u-td>二年级</u-td>
  11. <u-td>22</u-td>
  12. </u-tr>
  13. <u-tr>
  14. <u-td>清华大学</u-td>
  15. <u-td>05班</u-td>
  16. <u-td>20</u-td>
  17. </u-tr>
  18. </u-table>
  19. </template>

合并单元格

注意

由于微信小程序编译后特殊的元素结构,目前合并单元格暂不支持微信小程序端

  • 可以在td组件嵌入多个tr,就会得到多行,tr中再嵌入td,就可以合并单元格,可以通过width参数 设置单元格的百分比长度,默认为每个单元格平均分tr的长度

下面的示例为合并”行”单元格的写法,设置tdwidth为33.33333%,第一行的第一个td宽度占据三分之一

  1. <u-table>
  2. <u-tr>
  3. <u-td width="33.33333%">浙江大学</u-td>
  4. <u-td>
  5. <u-tr>
  6. <u-td>二年级</u-td>
  7. <u-td>22</u-td>
  8. </u-tr>
  9. <u-tr>
  10. <u-td>二年级</u-td>
  11. <u-td>22</u-td>
  12. </u-tr>
  13. </u-td>
  14. </u-tr>
  15. <u-tr>
  16. <u-td>清华大学</u-td>
  17. <u-td>05班</u-td>
  18. <u-td>20</u-td>
  19. </u-tr>
  20. </u-table>

下面的示例为合并”列”单元格的写法,设置tdwidth为66.66666%,第一行的第一个td宽度占据总宽度的三分之二

  1. <u-table>
  2. <u-tr>
  3. <u-td width="66.66666%">浙江大学</u-td>
  4. <u-td>
  5. 二年级
  6. </u-td>
  7. </u-tr>
  8. <u-tr>
  9. <u-td>清华大学</u-td>
  10. <u-td>05班</u-td>
  11. <u-td>20</u-td>
  12. </u-tr>
  13. </u-table>

API

Table Props

参数说明类型默认值可选值
border-color表格边框的颜色String#e4e7ed-
bg-color表格的背景颜色String#ffffff-
align单元格的内容对齐方式,作用类似css的text-alignStringcenterleft / right
padding单元格的内边距,同css的padding写法String10rpx 0-
font-size单元格字体大小,单位rpxString | Number28-
color单元格字体颜色String#606266-
th-styleth单元格的样式,对象形式(将th所需参数放在table组件,是为了避免每一个th组件要写一遍)Object{}-

Td Props

参数说明类型默认值可选值
width单元格宽度百分比或者具体带单位的值,如30%, 200rpx等,一般使用百分比,单元格宽度默认为均分tr的长度String | Numberauto-

Th Props

参数说明类型默认值可选值
width标题单元格宽度百分比或者具体带单位的值,如30%, 200rpx等,一般使用百分比,单元格宽度默认为均分tr的长度String | Number--