Skip to content

Table 表格 0.1.39

用于展示多条结构类似的数据, 可对数据进行排序等操作。

基础用法

通过data设置表格数据。

html
<wd-table :data="dataList">
  <wd-table-col prop="name" label="姓名"></wd-table-col>
  <wd-table-col prop="school" label="求学之所"></wd-table-col>
  <wd-table-col prop="major" label="专业"></wd-table-col>
</wd-table>
ts
const dataList = reactive([
  {
    name: '赵云',
    school: '武汉市阳逻妇幼保健学院',
    major: '计算机科学与技术专业'
  },
  {
    name: '孔明',
    school: '武汉市阳逻卧龙学院',
    major: '计算机科学与技术专业'
  },
  {
    name: '刘备',
    school: '武汉市阳逻编织学院',
    major: '计算机科学与技术专业'
  }
])

固定列

通过fixed设置表格列是否固定展示,默认false

提示

目前仅支持固定在左侧,且固定列组件的排列顺序要和实际想要展示的顺序相同。

html
<wd-table :data="dataList">
  <wd-table-col prop="name" label="姓名" fixed></wd-table-col>
  <wd-table-col prop="school" label="求学之所"></wd-table-col>
  <wd-table-col prop="major" label="专业"></wd-table-col>
</wd-table>

显示索引

通过index设置表格是否显示序号列,默认为false。同时也可以传入对象对序号列进行配置,参数同TableColumnProps

html
<wd-table :data="dataList" height="328px" :index="true">
  <wd-table-col prop="name" label="姓名" :sortable="true"></wd-table-col>
  <wd-table-col prop="grade" label="分数" :sortable="true"></wd-table-col>
  <wd-table-col prop="hobby" label="一言以蔽之" :sortable="true" :width="160"></wd-table-col>
</wd-table>

<wd-table :data="dataList" height="328px" :index="{ align: 'center', width: 200 }">
  <wd-table-col prop="name" label="姓名" :sortable="true" align="center"></wd-table-col>
  <wd-table-col prop="grade" label="分数" :sortable="true" align="center"></wd-table-col>
  <wd-table-col prop="hobby" label="一言以蔽之" :sortable="true" :width="160"></wd-table-col>
</wd-table>

斑马纹

通过stripe设置表格是否展示斑马纹,默认true

html
<wd-table :data="dataList" :stripe="false">
  <wd-table-col prop="name" label="姓名"></wd-table-col>
  <wd-table-col prop="school" label="求学之所"></wd-table-col>
  <wd-table-col prop="major" label="专业"></wd-table-col>
</wd-table>

边框

通过border设置表格是否展示边框,默认true

html
<wd-table :data="dataList" :border="false">
  <wd-table-col prop="name" label="姓名"></wd-table-col>
  <wd-table-col prop="school" label="求学之所"></wd-table-col>
  <wd-table-col prop="major" label="专业"></wd-table-col>
</wd-table>

表格高度

通过height设置表格高度,默认为80vh

html
<wd-table :data="dataList" height="328px">
  <wd-table-col prop="name" label="姓名"></wd-table-col>
  <wd-table-col prop="school" label="求学之所"></wd-table-col>
  <wd-table-col prop="major" label="专业"></wd-table-col>
</wd-table>

排序事件

当存在列参与排序时,点击会触发sort-method排序事件。

html
<wd-table :data="dataList" @sort-method="handleSort">
  <wd-table-col prop="name" label="姓名"></wd-table-col>
  <wd-table-col prop="school" label="求学之所" :sortable="true"></wd-table-col>
  <wd-table-col prop="major" label="专业"></wd-table-col>
</wd-table>
ts
function handleSort(e) {
  console.log('这里是排序事件')
}

自定义列模板

自定义列的显示内容,可组合其他组件使用。 通过 Scoped slot 可以获取到 row, index 的数据,用法参考 demo。

html
<wd-table :data="dataList" @sort-method="handleSort">
  <wd-table-col prop="name" label="姓名" fixed="true" width="320rpx" :sortable="true"></wd-table-col>
  <wd-table-col prop="grade" label="分数" width="220rpx" :sortable="true">
    <template #value="{row}">
      <view class="custom-class">
        <text>{{ row.grade }}</text>
        <text>同比{{ row.compare }}</text>
      </view>
    </template>
  </wd-table-col>
  <wd-table-col prop="hobby" label="一言以蔽之" :sortable="true"></wd-table-col>
  <wd-table-col prop="school" label="求学之所"></wd-table-col>
  <wd-table-col prop="major" label="专业"></wd-table-col>
  <wd-table-col prop="gender" label="性别"></wd-table-col>
  <wd-table-col prop="graduation" label="学成时间"></wd-table-col>
</wd-table>
ts
import { ref } from 'vue'

const dataList = ref<Record<string, any>[]>([
  {
    name: '张飞',
    school: '武汉市阳逻杀猪学院',
    major: '计算机科学与技术专业',
    gender: '男',
    graduation: '2022年1月12日',
    grade: 56,
    compare: '10%',
    hobby: '燕人张飞在此!'
  },
  {
    name: '关羽',
    school: '武汉市阳逻绿豆学院',
    major: '计算机科学与技术专业',
    gender: '男',
    graduation: '2022年1月12日',
    grade: 66,
    compare: '11%',
    hobby: '颜良文丑,以吾观之,如土鸡瓦犬耳。'
  },
  {
    name: '刘备',
    school: '武汉市阳逻编织学院',
    major: '计算机科学与技术专业',
    gender: '男',
    graduation: '2022年1月12日',
    grade: 45,
    compare: '1%',
    hobby: '我得空明,如鱼得水也'
  },
  {
    name: '赵云',
    school: '武汉市阳逻妇幼保健学院',
    major: '计算机科学与技术专业',
    gender: '男',
    graduation: '2022年1月12日',
    grade: 69,
    compare: '14%',
    hobby: '子龙,子龙,世无双'
  },
  {
    name: '孔明',
    school: '武汉市阳逻卧龙学院',
    major: '计算机科学与技术专业',
    gender: '男',
    graduation: '2022年1月12日',
    grade: 88,
    compare: '21%',
    hobby: '兴汉讨贼,克复中原'
  },
  {
    name: '姜维',
    school: '武汉市阳逻停水停电技术学院',
    major: '计算机科学与技术专业',
    gender: '男',
    graduation: '2022年1月12日',
    grade: 87,
    compare: '32%',
    hobby: '我计不成,乃天命也!'
  }
])

/**
 * 排序
 * @param e
 */
function handleSort(e) {
  dataList.value = dataList.value.reverse()
}
css
.custom-class {
  height: 80rpx;
  width: 220rpx;
  display: flex;
  flex-direction: col;
  align-items: center;
}

Attributes

参数说明类型可选值默认值最低版本
data显示的数据Array--0.0.39
border是否带有边框boolean-true0.0.39
stripe是否为斑马纹表boolean-true0.0.39
heightTable 的高度,默认为80vhstring-80vh0.0.39
rowHeight行高number / string-500.0.39
showHeader是否显示表头boolean-true0.0.39
ellipsis是否超出 2 行隐藏boolean-true0.0.39
index是否显示索引列,可传入boolean也可传入 column 配置boolean / TableColumnPropsfalse1.2.19

Events

事件名称说明参数最低版本
sort-method指定数据按照哪个属性进行排序,仅当 sortable 设置为 true 的时候有效TableColumn:当前点击列数据0.0.39
row-click当某一行被点击时会触发该事件{rowIndex:number} 点击行的下标0.0.39

TableColumn Attributes

参数说明类型可选值默认值最低版本
prop字段名称,对应列内容的字段名string--0.0.39
label显示的标题string--0.0.39
width对应列的宽度,单位为 pxnumber / string-1000.0.39
sortable是否开启列排序boolean-false0.0.39
fixed是否固定本列boolean-false0.0.39
align列的对齐方式AlignTypeleft, center, rightleft0.0.39

TableColumn Slot

name说明参数最低版本
value自定义列的内容,1.2.16 新增index参数{ row: Object, index: number }0.1.22

Released under the MIT License.

Released under the MIT License.