docs_vue2/one/docs/components/table.md
Justineo 32632e796e docs: update docs
Change-Id: I76d0f72679cd75085f5ffd42f641daa198cafe11

docs: update docs for alert/autocomplete/carousel, etc.

Change-Id: Ib7507f4979024f53c127e4b64b88560b93999db7

fix: update for autocomplete filter

Change-Id: Ie54556715fa52838aeb6caaa19b4f9a9f14b490f

docs: add docs for calendar/transfer/cascader

Change-Id: I655b3cb3d25dd0649de9ae7e224e7063a40dd079

fix: add more demos for input/textarea

Change-Id: Iada527ca82643a435a4775110b332155512d62a7

docs: add docs for uploader,select,table, etc.

Change-Id: Ib034fd5cc9d9a420d4e002956ae925175783c5f3

docs: adjust formatting and punc.

docs: adjust docs for uploader, etc.

Change-Id: If06c8c1102eafce43f5802a333676fc9e62cd474

docs: add docs for nav

Change-Id: If56a653ec53f19239606128fd30cae80f8e10025

docs: improve anchor demos

Change-Id: I6ac1c08cc8905924d0062def1f8921fe1f302f15

docs: refine wording and format

docs: update docs for check-button-group desc

Change-Id: Ica7d6d0692250f0be6bd330b1ad4cc41938afd46
2021-10-25 20:10:29 +08:00

5.8 KiB

Table 表格

:::tip Table 组件需要配合 Column 组件使用。 :::

示例

内容密度

可选的 ui 尺寸属性值:compact / loose

高级

允许自定义唯一键、设定选择模式以及进行排序。

筛选

使用 Column 组件的 filter 插槽来开启自定义筛选功能。

内部滚动模式

允许启用内部滚动模式,以达到固定表头表底的效果。

固定列

使用 Tablescroll 属性及 Column 组件的 fixed 属性来控制固定列的位置。

展开行

支持将带有子数据的行进行展开。

表头描述

使用 desc 属性或 desc 插槽来为表头增加描述信息。

排序

使用 order 属性和 order-by 属性来指定表头上的排序状态。

监听 sort 事件来处理排序状态的变化。

设置 allowed-orders 属性来自定义允许的排序状态。

加载状态

使用 loading 属性来指定表格处于加载状态。

API

属性

名称 类型 默认值 描述
ui string= - [^ui]
data Array<Object> - 表格数据。
key-field string - 用于指定充当表格数据的键的列标志符。值对应 data 属性中数据项的某个字段名称。对应字段的值则会作为行元素的 key 属性输出。当 selectable 属性为 true 时,也可以用来指定在存在纵向合并单元格的情况下以哪一列的不同行作为选择项,此时值必须来自内部某个 Column 组件的 field 属性。
selectable boolean false 是否支持表格行的选择。
select-mode string 'multiple' 选择模式,支持的值为 single / multiple,分别对应于单选/多选模式。
selected `Array<*> *` []
expandable boolean false 是否允许展开行。
expanded Array<*> [] [^expanded]
order `string boolean` false
order-by string - 用于指定当前基于哪一列进行了排序,值必须来自内部某个 Column 组件的 field 属性。
scroll number - 指定滚动区域的最大高度,当超出此高度时,表格将进入固定表头和底部只允许数据区域滚动的模式。
loading boolean false 指定表格是否处于加载状态。
allowed-orders Array [false, 'desc', 'asc'] [^allowed-orders]

^^^ui 预设样式。

+++枚举值

描述
compact 紧凑样式。
loose 宽松样式。
s 小尺寸样式。
m 中尺寸样式。
+++
^^^

^^^selected :::badges .sync :::

已选行。当 select-mode 属性为 'multiple' 时为已选行 key-field 对应字段值的数组;为 'single' 时为已选行 key-field 对应字段值。 ^^^

^^^expanded :::badges .sync :::

已展开行。为已展开行 key-field 对应字段值的数组。 ^^^

^^^allowed-orders 在表格层级指定列的排序范围。

+++值范围

描述
false 不排序。
'asc' 升序。
'desc' 降序。
+++
^^^

插槽

名称 描述
default 用于定义表格列,只能包含 Column 组件。
no-data 用于定义无数据时要展现的内容。
foot 表格脚部内容,整个区域将打通成为一个容器,不再保留分列。
sub-row [^slot-sub-row]

^^^slot-sub-row 展开行后子行的内容。使用此插槽时,内容会作为行展开下方通栏显式的子行内容。使用此插槽时会覆盖 Columnsub-row 插槽内容。

作用域参数为 data 内当前行数据中的所有字段,以及当前行对应索引值 index。 ^^^

事件

名称 描述
select [^event-select]
sort [^event-sort]

^^^event-select 切换已选项时触发。回调参数为 (selected, item, selectedItems)

+++参数详情

名称 类型 描述
selected boolean true 表示已选择,false 则表示取消选择。
item Object 选择状态发生变化的 data 属性中的数据项。当存在纵向合并单元格且以相应行作为键进行选择时,将返回第一条相关的 data 数据项。
selectedItems `Object<string, Object Array>`
+++
^^^

^^^event-sort 进行排序时触发的事件。回调参数为 (field, order)

+++参数详情

名称 类型 描述
field string 基于哪一列进行排序。值来自对应 Column 组件的 field 属性。
order `string boolean`
+++
^^^