龙空技术网

极致舒适的Vue可编辑表格

前端小兮 557

前言:

现在我们对“element ui 表格编辑”大概比较珍视,朋友们都想要剖析一些“element ui 表格编辑”的相关知识。那么小编在网摘上收集了一些关于“element ui 表格编辑””的相关文章,希望各位老铁们能喜欢,各位老铁们快快来了解一下吧!

使用ElementPlus的Table啥都好,就是没有可编辑表格!!!

既然UI库不支持,那我们实现一个可编辑表格是很难的事么?难么?不难么?...

个人觉得如果是业务固定的可编辑表格,使用ElementPlus实现都不难。但是如果需要的是一个通用的可编辑表格,这好像还真说不好。

对于通用的可编辑表格,网上的实现方案也是五花八门,但是看下来多少都有些问题。个人认为一个通用的可编辑表格需要给使用方提供以下能力:

支持新增、删除、编辑、保存定义可编辑列定义表单组件,既可以是原生标签,也可以是自定义组件定义表单校验规则定义数据展示部分定义操作区域几乎无学习成本

实现了以上需求的可编表格,就可以满足基本的生产需求了。

在<el-table>组件的基础上实现可编辑表格,保留<el-table>的使用方式不变,还能提供可编辑功能。同时可编辑功能的配置与<el-table>的使用风格一致,降低学习成本。

放心食用:演示地址

放心食用:Editable可编辑表格体验

准备数据

const tableData = [  {    date: '2016-05-03',    name: 'Tom',    address: 'No. 189, Grove St, Los Angeles',  },  {    date: '2016-05-02',    name: 'Tom',    address: 'No. 189, Grove St, Los Angeles',  },  {    date: '2016-05-04',    name: 'Tom',    address: 'No. 189, Grove St, Los Angeles',  },  {    date: '2016-05-01',    name: 'Tom',    address: 'No. 189, Grove St, Los Angeles',  },]
基础表格

基础表格的用法与<el-table>几乎没有区别,唯一的不同就是<el-table>中的data,在<EditTable>中被data-source替换。

<section>  <h1>无编辑效果</h1>  <EditTable class="edit-table" :data-source="tableData">    <EditTableColumn prop="date" label="时间"> </EditTableColumn>    <EditTableColumn prop="name" label="姓名"> </EditTableColumn>    <EditTableColumn prop="address" label="地址"> </EditTableColumn>  </EditTable></section>
可修改表格

<EditTableColumn>存在一个#default默认插槽和一个#edit具名插槽,默认插槽和具名插槽都提供了row、actions、$index等值。

可修改表格是在基础表格上给<EditTableColumn>添加名为edit的具名插槽<template #edit>。

通过row可以获取到当前行的数据。插槽中的表单组件可通过v-model="row.*"对编辑值进行双向绑定。通过actions可以获取编辑表格的能力,通过action.startEditable($index)开启编辑,action.cancelEditable($index)取消编辑,action.saveEditable保存编辑。

<section>  <h1>可编辑效果</h1>  <EditTable class="edit-table" :data-source="tableData">    <EditTableColumn prop="date" label="时间">      <template #edit="{ row }">        <input v-model="row.date" />      </template>    </EditTableColumn>    <EditTableColumn prop="name" label="姓名">      <template #edit="{ row }">        <input v-model="row.name" />      </template>    </EditTableColumn>    <EditTableColumn prop="address" label="地址">      <template #edit="{ row }">        <input v-model="row.address" />      </template>    </EditTableColumn>    <EditTableColumn label="操作">      <template #default="{ actions, $index }">        <button @click="actions.startEditable($index)">操作</button>      </template>      <template #edit="{ actions, $index }">        <button @click="actions.saveEditable($index)">保存</button>        <button @click="actions.cancelEditable($index)">取消</button>      </template>    </EditTableColumn>  </EditTable></section>
删除效果

在上述表格的操作区域增加删除按钮,删除按钮点击时调用actions.delete($index)用来删除当前行。

<section>  <h1>删除效果</h1>  <EditTable class="edit-table" :data-source="tableData">    <EditTableColumn prop="date" label="时间">      <template #edit="{ row }">        <input v-model="row.date" />      </template>    </EditTableColumn>    <EditTableColumn prop="name" label="姓名">      <template #edit="{ row }">        <input v-model="row.name" />      </template>    </EditTableColumn>    <EditTableColumn prop="address" label="地址">      <template #edit="{ row }">        <input v-model="row.address" />      </template>    </EditTableColumn>    <EditTableColumn label="操作">      <template #default="{ actions, $index }">        <button @click="actions.startEditable($index)">操作</button>        <button @click="actions.deleteRow($index)">删除</button>      </template>      <template #edit="{ actions, $index }">        <button @click="actions.saveEditable($index)">保存</button>        <button @click="actions.cancelEditable($index)">取消</button>        <button @click="actions.deleteRow($index)">删除</button>      </template>    </EditTableColumn>  </EditTable></section>
新增效果

组件<EditTable>并不需要提供新增按钮,如果直接将新增按钮封装在组件内,那么这个组件就太呆了。因此<EditTable>只提供了actions.addRow方法,调用方可以根据自己的需求完成新增功能。

<script lang="ts" setup>import { ref } from 'vue';import EditTable from '@/components/EditTable.vue';import EditTableColumn from '@/components/EditTableColumn.vue';const tableData = [...];const addEditTableRef = ref<InstanceType<typeof EditTable>>();</script><template>  <div class="wrapper">    <section>      <h1>新增效果</h1>      <EditTable ref="addEditTableRef" class="edit-table" :data-source="tableData">        <EditTableColumn prop="date" label="时间">          <template #edit="{ row }">            <input v-model="row.date" />          </template>        </EditTableColumn>        <EditTableColumn prop="name" label="姓名">          <template #edit="{ row }">            <input v-model="row.name" />          </template>        </EditTableColumn>        <EditTableColumn prop="address" label="地址">          <template #edit="{ row }">            <input v-model="row.address" />          </template>        </EditTableColumn>        <EditTableColumn label="操作">          <template #default="{ actions, $index }">            <button @click="actions.startEditable($index)">操作</button>            <button @click="actions.deleteRow($index)">删除</button>          </template>          <template #edit="{ actions, $index }">            <button @click="actions.saveEditable($index)">保存</button>            <button @click="actions.cancelEditable($index)">取消</button>            <button @click="actions.deleteRow($index)">删除</button>          </template>        </EditTableColumn>      </EditTable>      <button @click="addEditTableRef?.editActions.addRow()">新增</button>    </section>  </div></template>
表单校验

组件<EditTableColumn>允许验证用户的输入是否符合规范,来找到和纠正错误。只需要为<EditTableColumn :rules="rules">的rules属性传入约定的验证规则,高级用法可参考async-validator。

总之校验规则和表单的校验规则一致。

<section>  <h1>表单校验效果</h1>  <EditTable ref="formEditTableRef" class="edit-table" :data-source="tableData">    <EditTableColumn      prop="date"      label="时间"      :rules="[{ required: true, message: '时间是必填项', trigger: 'blur' }]"    >      <template #edit="{ row }">        <input v-model="row.date" />      </template>    </EditTableColumn>    <EditTableColumn      prop="name"      label="姓名"      :rules="[{ required: true, message: '姓名是必填项', trigger: 'blur' }]"    >      <template #edit="{ row }">        <input v-model="row.name" />      </template>    </EditTableColumn>    <EditTableColumn      prop="address"      label="地址"      :rules="[{ required: true, message: '地址是必填项', trigger: 'blur' }]"    >      <template #edit="{ row }">        <input v-model="row.address" />      </template>    </EditTableColumn>    <EditTableColumn label="操作">      <template #default="{ actions, $index }">        <button @click="actions.startEditable($index)">操作</button>        <button @click="actions.deleteRow($index)">删除</button>      </template>      <template #edit="{ actions, $index }">        <button @click="actions.saveEditable($index)">保存</button>        <button @click="actions.cancelEditable($index)">取消</button>        <button @click="actions.deleteRow($index)">删除</button>      </template>    </EditTableColumn>  </EditTable>  <button @click="formEditTableRef?.editActions.addRow()">新增</button></section>
获取编辑后的表单数据

组件<EditTable>对外暴露了resultData响应式对象,可以用来获取表格的最新数据。

<section>  <h1>获取编辑结果</h1>  <EditTable ref="formEditTableRef" class="edit-table" :data-source="tableData">    <EditTableColumn      prop="date"      label="时间"      :rules="[{ required: true, message: '时间是必填项', trigger: 'blur' }]"    >      <template #edit="{ row }">        <input v-model="row.date" />      </template>    </EditTableColumn>    <EditTableColumn      prop="name"      label="姓名"      :rules="[{ required: true, message: '姓名是必填项', trigger: 'blur' }]"    >      <template #edit="{ row }">        <input v-model="row.name" />      </template>    </EditTableColumn>    <EditTableColumn      prop="address"      label="地址"      :rules="[{ required: true, message: '地址是必填项', trigger: 'blur' }]"    >      <template #edit="{ row }">        <input v-model="row.address" />      </template>    </EditTableColumn>    <EditTableColumn label="操作">      <template #default="{ actions, $index }">        <button @click="actions.startEditable($index)">操作</button>        <button @click="actions.deleteRow($index)">删除</button>      </template>      <template #edit="{ actions, $index }">        <button @click="actions.saveEditable($index)">保存</button>        <button @click="actions.cancelEditable($index)">取消</button>        <button @click="actions.deleteRow($index)">删除</button>      </template>    </EditTableColumn>  </EditTable>  <button @click="formEditTableRef?.editActions.addRow()">新增</button>  <p>获取数据:{{ formEditTableRef?.resultData }}</p></section>
另一种数据配置

组件<EditTable>除了支持data-source的方式配置数据外,还支持request属性传入返回数据的函数。

<script lang="ts" setup name="Page-B">import { ref } from 'vue';import EditTable from '@/components/EditTable.vue';import EditTableColumn from '@/components/EditTableColumn.vue';const loadData = async () => [  {    date: '2016-05-03',    name: 'Tom',    address: 'No. 189, Grove St, Los Angeles',  },  {    date: '2016-05-02',    name: 'Tom',    address: 'No. 189, Grove St, Los Angeles',  },  {    date: '2016-05-04',    name: 'Tom',    address: 'No. 189, Grove St, Los Angeles',  },  {    date: '2016-05-01',    name: 'Tom',    address: 'No. 189, Grove St, Los Angeles',  },];</script><template>  <div class="wrapper">    <section>      <h1>另一种数据配置</h1>      <EditTable class="edit-table" :request="loadData">        <EditTableColumn prop="date" label="时间"> </EditTableColumn>        <EditTableColumn prop="name" label="姓名"> </EditTableColumn>        <EditTableColumn prop="address" label="地址"> </EditTableColumn>      </EditTable>    </section>  </div></template>
EditTable 属性

属性名

说明

类型

可选值

默认值

data-source

显示的数据

array

request

动态数据,如果同时配置了data-source和request,则最终渲染为两个数据的和

function

EditTable 方法

方法名

说明

参数

editActions.addRow

增加一行可编辑态的行

row

editActions.deleteRow

删除指定行,不论该行是编辑态还是非编辑态都会被删除

$index

editActions.startEditable

指定行变为编辑态

$index

editActions.saveEditable

保存编辑态并触发表单校验,如果校验通过,编辑数据会被更新到表格中。

$index

editActions.cancelEditable

指定行取消编辑态

$index

原文链接:

标签: #element ui 表格编辑 #vue中table表格修改默认选中行颜色 #vue table编辑 #elementui编辑表格