草庐IT

Ant Design Pro使用之--EditableProTable 可编辑表格

Ara_tsubomi 2024-06-11 原文

前言--EditableProTable 与 ProTable的对比

首先:可编辑表格 EditableProTable 与 ProTable 的功能基本相同;

但是如果用ProTable的话,增和改一般是采用弹出浮层表单的方式,为了让结构看起来清晰,一般还会将这个弹出框抽成一个子组件。这无疑就多写了些步骤。当然,如果表格数据项很多,表单项种类多的话,我个人还是建议用ProTable+弹出浮层表单进行增改操作,这样更清晰明了,也是别人能一眼看清结构的操作,弹出层中ProForm对于各类表单项的支持度也比较好,用EditableProTable的话,有些特殊表单项的某些特定设置可能很难生效,而且如果表单项种类多的话,写在同一个组件中也显得代码杂乱;

所以对于一些稍微简单的表格,比如就只有5项内的数据,或者用到的表单项比较单一,比如只需要文本框和下拉选择框这种基本的表单项类型,且不需要查询表格的情况下(因为EditableProTable关掉了查询表单和操作栏),可以使用EditableProTable可编辑表格,增和改也可以很方便地在同一个组件设置完成。

基本使用

EditableProTable大部分的api都是和ProTable相同的,如果本身对于ProTable不是很熟悉,可以看我之前的关于ProTable的文章:《Ant Design Pro使用之--ProTable踩坑小计及样式调整碎碎念》,对于ProTable有基本的了解之后,看EditableProTable就会简单许多。

在这里只说几个EditableProTable特有的主要属性及相关用法吧:

比如下面是一个例子:

const actionRef = useRef<ActionType>();
const [editableKeys, setEditableRowKeys] = useState<React.Key[]>([]);
const [form] = Form.useForm();

<EditableProTable
      columns={columns}
      actionRef={actionRef}
      options={false}
      request={getData}
      loading={false}
      rowKey="id"
      recordCreatorProps={{
        position: 'bottom',
        record: () => ({ id: (Math.random() * 1000000).toFixed(0) }),
        creatorButtonText: '新增企业地址',
      }}
      editable={{
        type: 'multiple',
        editableKeys,
        onlyAddOneLineAlertMessage: '请先保存地址后再新增',
        onSave: async (rowKey, data) => {
          save(data);
        },
        form,
        onCancel: () => {
          actionRef.current?.reload();
          return Promise.resolve();
        },
        onChange: setEditableRowKeys,
        actionRender: (_row, _config, dom) => [dom.save, dom.cancel],
      }}
    />

其中columns和request都是和ProTable相同的用法,便不再赘述,主要来说一下recordCreatorProps和editable两个属性:

1.recordCreatorProps:新建一行数据的相关配置。主要有以下小点:

  • record:由于每次新增时都需要唯一的key,所以新增一行的时要保证证 recordCreatorProps.record key 唯一,不然会导致编辑出错,所以我这里为了避免与后端返回的id相冲,就取了个很大的随机数;
  • position:通过配置  position="top"|"bottom" 可以配置增加按钮和增加的这一行是增加在表格头还是表格尾部;
  • 另外就是关于新建按钮的配置了,如果不想要这样的按钮,也可以通过recordCreatorProps={false}就可以关掉按钮,同时使用 actionRef.current?.addEditRecord(row)  来控制新建行。相关配置放在下面了,官网也有详细解释。
    recordCreatorProps = {
      // 要增加到哪个节点下,一般用于多重嵌套表格
      parentKey: React.key,
      // 顶部添加还是末尾添加
      position: 'bottom',
      // 新增一行的方式,默认是缓存,取消后就会消失
      // 如果设置为 dataSource 会触发 onchange,取消后也不会消失,只能删除
      newRecordType: 'dataSource',
      // 不写 key ,会使用 index 当行 id
      record: {},
      // 设置按钮文案
      creatorButtonText: '新增一行',
      // 按钮的样式设置,可以设置按钮是否显示
      // 这样可以做最大行限制和最小行限制之类的功能
      style: {
        display: 'none',
      },
      // https://ant.design/components/button-cn/#API
      ...antButtonProps,
    };

2.editable:可编辑表格的相关配置,在官网写的已经超详细了,以下就是官网解释及我的理解:

属性描述类型默认值
type可编辑表格的类型,单行编辑或者多行编辑single | multiple-
form

可编辑表格的 form 实例,使用 Form.useForm 生成后使用,如果其他地方用不到form实例的话,也可以不用绑

FormInstance-
formProps可以配置 form 的属性,但是不支持 onFinishFormProps-
editableKeys

正在编辑的行,受控属性。 默认 key 会使用 rowKey 的配置,如果没有配置会使用 index,建议使用 rowKey。

可以与下面的onChange合并使用,在onChange的时候更改key即可

Key[]-
onChange

行数据被修改的时候触发。

可以与editableKeys合并使用,更改key

(editableKeys: Key[], editableRows: T[]) => void-
onSave

保存一行的时候触发。

这里可以拿到row数据,进行数据的提交等操作

(key: Key, row: T,originRow:T,newLine?:newLineConfig) => Promise<any>-
saveText保存一行的文字React.ReactNode保存
onDelete删除一行的时候触发(key: Key, row: T) => Promise<any>-
deleteText删除一行的文字React.ReactNode删除
onCancel

取消编辑一行时触发

最终需要返回一个promise

(key: Key, row: T,originRow:T,newLine?:newLineConfig) => Promise<any>-
cancelText取消编辑一行的文字React.ReactNode取消
actionRender

自定义编辑模式的操作栏。

第三个参数是默认按钮defaultDom,默认有保存(defaultDom.save),取消(defaultDom.cancel),删除(defaultDom.delete)按钮,可以自行配置

(row: T, config: ActionRenderConfig<T>) => ReactNode[]-
deletePopconfirmMessage删除时弹出的确认框提示消息ReactNode删除此行?

onlyOneLineEditor

AlertMessage

只能编辑一行的的提示ReactNode只能同时编辑一行

onlyAddOneLine

AlertMessage

只能同时新增一行的提示ReactNode只能新增一行

3.除了EditableProTable中的这些属性外,columns中有需要注意的就是:

  • valueType:通过设置valueType类型:valueType: 'select',或者valueType: 'date',等来设置表单项类型,这一点和ProTable是相通的;
  • formItemProps:通过formItemProps可以快速便捷地对于表单项进行配置,如添加校验,设置占位字符等。
    formItemProps: () => {
       return {
         rules: [{ required: true, message: '请输入地址名称' }],
       };
    },

小结

大概要注意的也就以上了吧,但还是建议在充分理解了ProTable之后,再使用EditableProTable会比较顺畅,不然会被很多东西卡住......如果对于本文或者相关用法还有什么疑问的话,也请让我知道吧,互相学习嘛~

有关Ant Design Pro使用之--EditableProTable 可编辑表格的更多相关文章

  1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

    我正在学习如何使用Nokogiri,根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

  2. ruby - 使用 RubyZip 生成 ZIP 文件时设置压缩级别 - 2

    我有一个Ruby程序,它使用rubyzip压缩XML文件的目录树。gem。我的问题是文件开始变得很重,我想提高压缩级别,因为压缩时间不是问题。我在rubyzipdocumentation中找不到一种为创建的ZIP文件指定压缩级别的方法。有人知道如何更改此设置吗?是否有另一个允许指定压缩级别的Ruby库? 最佳答案 这是我通过查看ruby​​zip内部创建的代码。level=Zlib::BEST_COMPRESSIONZip::ZipOutputStream.open(zip_file)do|zip|Dir.glob("**/*")d

  3. ruby - 为什么我可以在 Ruby 中使用 Object#send 访问私有(private)/ protected 方法? - 2

    类classAprivatedeffooputs:fooendpublicdefbarputs:barendprivatedefzimputs:zimendprotecteddefdibputs:dibendendA的实例a=A.new测试a.foorescueputs:faila.barrescueputs:faila.zimrescueputs:faila.dibrescueputs:faila.gazrescueputs:fail测试输出failbarfailfailfail.发送测试[:foo,:bar,:zim,:dib,:gaz].each{|m|a.send(m)resc

  4. ruby-on-rails - 使用 Ruby on Rails 进行自动化测试 - 最佳实践 - 2

    很好奇,就使用ruby​​onrails自动化单元测试而言,你们正在做什么?您是否创建了一个脚本来在cron中运行rake作业并将结果邮寄给您?git中的预提交Hook?只是手动调用?我完全理解测试,但想知道在错误发生之前捕获错误的最佳实践是什么。让我们理所当然地认为测试本身是完美无缺的,并且可以正常工作。下一步是什么以确保他们在正确的时间将可能有害的结果传达给您? 最佳答案 不确定您到底想听什么,但是有几个级别的自动代码库控制:在处理某项功能时,您可以使用类似autotest的内容获得关于哪些有效,哪些无效的即时反馈。要确保您的提

  5. ruby - 在 Ruby 中使用匿名模块 - 2

    假设我做了一个模块如下:m=Module.newdoclassCendend三个问题:除了对m的引用之外,还有什么方法可以访问C和m中的其他内容?我可以在创建匿名模块后为其命名吗(就像我输入“module...”一样)?如何在使用完匿名模块后将其删除,使其定义的常量不再存在? 最佳答案 三个答案:是的,使用ObjectSpace.此代码使c引用你的类(class)C不引用m:c=nilObjectSpace.each_object{|obj|c=objif(Class===objandobj.name=~/::C$/)}当然这取决于

  6. ruby - 使用 ruby​​ 和 savon 的 SOAP 服务 - 2

    我正在尝试使用ruby​​和Savon来使用网络服务。测试服务为http://www.webservicex.net/WS/WSDetails.aspx?WSID=9&CATID=2require'rubygems'require'savon'client=Savon::Client.new"http://www.webservicex.net/stockquote.asmx?WSDL"client.get_quotedo|soap|soap.body={:symbol=>"AAPL"}end返回SOAP异常。检查soap信封,在我看来soap请求没有正确的命名空间。任何人都可以建议我

  7. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声? - 2

    关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题?更新问题,以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点?我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等),但我确实想创建一个输出文件。

  8. ruby-on-rails - 'compass watch' 是如何工作的/它是如何与 rails 一起使用的 - 2

    我在我的项目目录中完成了compasscreate.和compassinitrails。几个问题:我已将我的.sass文件放在public/stylesheets中。这是放置它们的正确位置吗?当我运行compasswatch时,它不会自动编译这些.sass文件。我必须手动指定文件:compasswatchpublic/stylesheets/myfile.sass等。如何让它自动运行?文件ie.css、print.css和screen.css已放在stylesheets/compiled。如何在编译后不让它们重新出现的情况下删除它们?我自己编译的.sass文件编译成compiled/t

  9. ruby - 使用 ruby​​ 将 HTML 转换为纯文本并维护结构/格式 - 2

    我想将html转换为纯文本。不过,我不想只删除标签,我想智能地保留尽可能多的格式。为插入换行符标签,检测段落并格式化它们等。输入非常简单,通常是格式良好的html(不是整个文档,只是一堆内容,通常没有anchor或图像)。我可以将几个正则表达式放在一起,让我达到80%,但我认为可能有一些现有的解决方案更智能。 最佳答案 首先,不要尝试为此使用正则表达式。很有可能你会想出一个脆弱/脆弱的解决方案,它会随着HTML的变化而崩溃,或者很难管理和维护。您可以使用Nokogiri快速解析HTML并提取文本:require'nokogiri'h

  10. ruby - 在 64 位 Snow Leopard 上使用 rvm、postgres 9.0、ruby 1.9.2-p136 安装 pg gem 时出现问题 - 2

    我想为Heroku构建一个Rails3应用程序。他们使用Postgres作为他们的数据库,所以我通过MacPorts安装了postgres9.0。现在我需要一个postgresgem并且共识是出于性能原因你想要pggem。但是我对我得到的错误感到非常困惑当我尝试在rvm下通过geminstall安装pg时。我已经非常明确地指定了所有postgres目录的位置可以找到但仍然无法完成安装:$envARCHFLAGS='-archx86_64'geminstallpg--\--with-pg-config=/opt/local/var/db/postgresql90/defaultdb/po

随机推荐