跳到主要内容

可编辑表格

Alt text

应用场景:方便地对表格数据进行增删改查,如用于数据管理,例如对用户信息、产品清单、订单记录等进行编辑和更新。可以通过表格添加、修改或删除数据,实现数据的维护和管理。

Demo地址:【可编辑表格】基本使用


基本操作

整体配置

基础配置

新增按钮文案

Alt text

操作配置

动态配置操作

开启后可连线配置操作列数据,所有操作配置可通过逻辑连线动态修改

实时保存

开启后编辑后会直接保存数据,开启后,支持新增多条数据,新增/编辑中的数据在提交时也会同步提交 实时保存未开启情况下,每次只允许新增一条数据,未保存数据不会被提交

点击切换编辑态

开启后点击对应单元格,这一行会转变到编辑态

隐藏操作列

开启后隐藏操作这一列

隐藏新增按钮

开启后隐藏下方的新增按钮,可以从外部连线调用新增一行事件新增数据

单行编辑

开启后同时只可以编辑一行,默认可以编辑多行

Alt text

可展开行配置

含children字段的数据行,为可展开行, 父节点行数据只读:开启后,含children字段数据行,所有内容为只读,且无编辑按钮 注:输入时添加children字段数组,就是子节点

Alt text

勾选配置

开启后可以勾选,开启动态设置勾选项可以连线输入想要勾选项的勾选标识(_key)组成的数组

Alt text

数据变化事件

开启后新建数据变化事件可以监听到整个可编辑表格数据的变化,包括增加和编辑、删除,输入数据是变化后的可编辑表格数据

Alt text

列配置

聚焦到想要编辑的列的列头,可编辑列属性、删除列,点击表格可以新增列

列名、字段

配置这一列的列名和字段, 列名:列头显示文字,字段:列数据在数据项中对应的路径

Alt text

类型

可配置这一行的类型,一般展示的时候是展示文字(除开关以外),点击编辑进入编辑态就是对应的输入类型。 一些特殊的可以设置相应配置,如下拉框和多选框可以设置对应的默认选项,或者是通过输入修改列配置来修改

Alt text

Alt text

输入框

输出字符串数据

下拉框

数据源配置

Alt text

  1. 通过右侧配置项 配置 数据源
  2. 通过 修改列配置 事件传入
多选框
日期

输出 YYYY-MM-DD 格式的数据

开关

输出 布尔 数据

数字输入框

输出 数字 数据

开关配置

打开文案:按钮打开时,只读态下文案,默认为“打开” 关闭文案:按钮关闭时,只读态下文案,默认为“关闭”

必填

开启后,该项必填

只读

开启后,该项只读 只读配置,只对输入数据生效 若有新增操作,新增数据项仍可编辑只读项


逻辑编排

Alt text

输入数据

输入改变可编辑表格的数据,传入的列表中对象是设置的字段,如

Alt text

// 数组类型,key-value
[
{
"title": "名称"
}
]

修改列配置

输入配置列的,如下拉框的选项等,按每一列的字段分配如,这里配置title字段列下拉框的选项 目前仅支持修改 下拉类型的数据源字段,如:

{
// 列对应字段
"name": {
// 下拉数据
"options": [
{
label: '下拉项1',
value: "1"
}
]
}
}

Alt text

提交数据

输出可编辑表格的数据,可以获取到此时表格的数据并进行后续操作,格式如下:

Alt text

新增一行

等价于默认的新增一行,新增一行数据,且这一行是编辑态。

修改操作配置

动态修改操作配置,如自动保存、隐藏删除按钮,需要在编辑项内开启此功能

Alt text

{
// 实时保存
useAutoSave: true,
// 隐藏操作列
hideAllOperation: true,
// 隐藏新增按钮
hideAddBtn: true,
// 默认可编辑
defaultEditable: true,

// 只读态操作 - 隐藏编辑按钮
hideModifyBtn: true,
// 只读态操作 - 隐藏删除按钮
hideDeleteBtn: true,

// 编辑态操作 - 隐藏保存按钮
hideSaveBtn: true,
// 编辑态操作 - 隐藏删除按钮
hideDeleteBtnInEdit: true,
// 编辑态操作 - 隐藏取消按钮
hideCancelBtn: true
}

样式

整体样式

点击整个表格进行编辑

布局风格

支持 默认/适中布局/紧凑布局,默认为适中布局

Alt text

固定表头

可设置表头可滚动的高度,单位px

Alt text

列样式

聚焦(点击)到想要编辑到的列

列宽

设置某一列的宽度

Alt text

文字对齐

Alt text

提示

开启后可以在列头添加提示

Alt text

Alt text

说明

实时保存未开启情况下

每次只允许新增一条数据 未保存数据不会被提交

含children数据情况下

children数据只支持编辑/删除操作,不支持新增

特殊场景案例

仅新增数据可编辑

配置:

  • 隐藏 只读态 编辑按钮
  • 隐藏 只读态 删除按钮
  • 开启 实时保存
  • 隐藏 编辑态 保存按钮
  • 隐藏 编辑态 取消按钮