首页/新闻资讯/正文详情

Vue 3 + Element Plus:表格「行内可编辑单元格」组件设计与实战

发布时间:2026/11/16 16:37:05 来源:云帆数科 栏目:资讯中心
Vue 3 + Element Plus:表格「行内可编辑单元格」组件设计与实战
列表页里「点一下就能改数据」是很常见但细节很多的需求。很多人第一反应是在el-table 的插槽里塞个el-input 功能是能跑通但一旦遇到下面这些场景就会很痛苦数字列要 限制只能输数字、限制小数位 点击进入编辑、 回车确认、Esc 取消、失焦提交 编辑态要 自动聚焦 配合表格的 分组小计、合并单元格 一起用单元格要 受控 数据源可控、可回滚。本文基于一个真实管理系统的实现拆解一个可复用的EditableCell 组件。文末会重点讲几个新手极易踩的坑nextTick 聚焦时机、数字过滤正则、失焦与输入的冲突。一、需求拆解先明确组件要解决什么非编辑态 显示格式化后的文本 一个悬停才出现的「编辑」小图标编辑态 变成输入框并 自动聚焦 文本列 直接双向绑定数字列 只能输数字和小数点且 小数位受控 交互 心跳式三件套 —— 回车提交、Esc 取消、失焦提交受控 组件自身不持有「落地值」一切通过modelValue 单向流入、update:modelValue 流出父组件决定何时生效、何时回滚。一句话总结 这是一个完全受控的、可复用的行内编辑单元 。二、组件设计受控 v-model 语义采用 Vue 3 标准的v-model 约定props.modelValue —— 当前值父组件传入编辑时输入框跟着它走props.displayValue —— 非编辑态展示文本可能和modelValue 不同例如金额要格式化、空值显示- props.editing —— 是否处于编辑态 由父组件控制 而不是组件自己猜props.numeric —— 是否数字列决定要不要做输入过滤props.decimalScale —— 允许的小数位默认 2。为什么要让editing 由父组件控制因为「哪些行、哪些列现在处于编辑态」往往关联着表格的草稿态、批量保存、分组小计等 页面级状态 组件自己持有会失控。组件只负责「把编辑行为上报」父组件负责「决定状态」。三、完整代码实现!-- EditableCell.vue -- template div classeditable-cell :class{ is-editing: editing } clickhandleEdit !-- 编辑态输入框 -- el-input v-ifediting refinputRef :model-valuemodelValue sizesmall inputhandleInput blur$emit(blur) keydown.enter$event.target.blur() keydown.esc$emit(cancel) / !-- 非编辑态文本 悬停图标 -- template v-else span classeditable-cell__text{{ displayValue }}/span el-icon classeditable-cell__iconEditPen //el-icon /template /div /template script setup import { nextTick, ref, watch } from vue import { EditPen } from element-plus/icons-vue const props defineProps({ modelValue: { type: [String, Number], default: }, displayValue: { type: String, default: - }, editing: Boolean, numeric: Boolean, decimalScale: { type: Number, default: 2 }, }) const emit defineEmits([edit, update:modelValue, blur, cancel]) const inputRef ref() // 进入编辑态后等 DOM 渲染完成再聚焦 watch( () props.editing, async (editing) { if (!editing) return await nextTick() inputRef.value?.focus() }, ) // 点击非编辑态区域 - 通知父组件进入编辑 const handleEdit () { if (!props.editing) emit(edit) } // 输入处理文本直接回传数字列做过滤 const handleInput (value) { if (!props.numeric) { emit(update:modelValue, value) return } const cleaned String(value) .replace(/[^\d.]/g, ) // 去掉数字和小数点以外的字符 .replace(/\.(?.*\.)/g, ) // 只保留一个小数点 const [integer , decimal] cleaned.split(.) emit( update:modelValue, decimal undefined ? integer : ${integer}.${decimal.slice(0, props.decimalScale)}, ) } /script style scoped .editable-cell { display: inline-flex; align-items: center; min-width: 70px; min-height: 28px; cursor: text; } .editable-cell.is-editing { width: 100%; } .editable-cell__text { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } .editable-cell__icon { flex: none; margin-left: 5px; color: #1677ff; opacity: 0; /* 默认隐藏 */ transition: opacity 0.15s ease; } .editable-cell:hover .editable-cell__icon { opacity: 1; /* 悬停时出现 */ } /style关键实现点① 数字输入过滤核心正则const cleaned String(value) .replace(/[^\d.]/g, ) // 1. 只留数字和点 .replace(/\.(?.*\.)/g, ) // 2. 多个点只留一个第一条正则把所有非「数字/小数点」的字符清空。第二条正则是亮点\.(?.*\.) 表示「后面还跟着一个点的点」把它替换掉最终只保留一个小数点。然后split(.) 拆整数/小数decimal.slice(0, decimalScale) 截断小数位。② 自动聚焦 —— 为什么要await nextTick()因为输入框是用v-ifediting 渲染的editing 变true 的那一刻el-input 还没挂到 DOM 上。直接在 watch 里inputRef.value?.focus() 会拿到undefined 。必须await nextTick() 等渲染完成后再聚焦。③ 回车 失焦Esc 取消1. keydown.enter$event.target.blur() 回车触发 blur自然走到「失焦提交」逻辑2.keydown.esc$emit(cancel) Esc 走取消父组件可以把草稿值回滚。四、配合 el-table 分组小计使用光有单元格不够真正复杂的是把它嵌进一张「带分组小计」的表格里。下面是父页面的大致用法el-table :datatableRows :span-methodtableSpanMethod border el-table-column label资产编号 min-width135 template #default{ row } !-- 明细行可编辑 -- EditableCell v-ifrow._rowType detail :model-valuerow.assetNo :display-valuedisplayText(row.assetNo) :editingrow._isDraft || isEditing(row, assetNo) editbeginEdit(row, assetNo) update:model-valueupdateCell(row, assetNo, $event) blurfinishEdit(row, assetNo) cancelcancelEdit(row, assetNo) / !-- 小计行只读 -- span v-else classsummary-label小计/span /template /el-table-column /el-table父页面需要维护几个状态const editingCell ref({ _key: , field: }) // 当前编辑的单元格 const isEditing (row, field) editingCell.value._key row._key editingCell.value.field field const beginEdit (row, field) { editingCell.value { _key: row._key, field } } const updateCell (row, field, value) { if (!row._isDraft) row._isDraft true // 进入草稿态 row[field] value } const finishEdit () { editingCell.value { _key: , field: } } const cancelEdit () { finishEdit() }几个设计要点row._rowType 区分「明细行」和「小计行」小计行不渲染EditableCell 直接显示小计 row._isDraft 标记草稿行新行进来时天然是草稿态可直接编辑已有行点一下才进入编辑编辑态是「页级唯一」的 用editingCell 记录「当前是哪一行哪一列」保证同一时间只有一个单元格在编辑避免表格里一堆输入框互相抢焦点。这样就把「单元格交互」和「页面状态管理」分层了EditableCell 无脑上报父组件统筹草稿、分组、保存/回滚。五、踩坑清单坑表现解法直接在 watch 里 focus拿不到 input聚焦失效await nextTick() 后再 focus数字列没做过滤能输字母、多个小数点正则过滤 截断小数位editing 由组件自己管理多行多列同时进入编辑、状态混乱交给父组件页级唯一失焦提交与 Esc 取消冲突Esc 后仍被 blur 提交Esc 用独立cancel 事件不走 blur空值展示null /undefined单元格空白displayValue 兜底为-点击输入框冒泡触发外层点击循环进入编辑编辑态下handleEdit 直接 return六、更轻量的备选方案如果只是个别列需要「随手改」不想引入完整组件也可以在表格插槽里直接用el-input。el-input :model-valuerow[item.key] sizesmall input(val) handleInput(val, row, item.key) blur$emit(blur, row, item.key) keydown.enter$event.target.blur() /优点是无editing 状态、代码更短缺点是没法做「点击图标才进编辑」「Esc 取消回滚」这类精细交互数字校验也要自己写。 完整组件适合强交互、高复用场景轻量写法适合一次性场景 按需选择即可。七、总结一个合格的行内可编辑单元格本质上是三件事的分层1. 组件层EditableCell 只负责渲染 上报edit /update:modelValue /blur /cancel 完全受控、无状态2. 页面层 维护「当前编辑单元格」「草稿态」等页级状态决定生效与回滚3. 表格层span-method 行类型 处理分组小计、合并单元格等展示逻辑。核心细节记住两个就够了 nextTick 才能拿 DOM 聚焦 、 数字列要用正则过滤 小数位截断 。把这两点吃透剩下都是业务拼装。

相关推荐

基于Flask与SQLite的社团管理系统:从报名到签到全流程实践
基于Flask与SQLite的社团管理系统:从报名到签到全流程实践

简介:一套完整的社团管理系统源码,基于Java的SpringBoot框架构建,采用浏览器服务器架构与模型视图控制器分层设计,适合计算机相关专业学生、教师及企业开发人员用于课程设计、毕业设计或项目实战参考。系统覆盖社团信息管理、成员… · 2026/11/4 20:07:42

RTK是什么?为什么测绘和工程都离不开它
RTK是什么?为什么测绘和工程都离不开它

很多新手第一次听到"RTK"都是一脸懵:四个字母,前不着村后不着店,老师傅却天天挂在嘴边。这篇把 RTK 讲透–它是什么、凭什么能把定位做到厘米级、为什么测绘和工程离不了它。RTK是什么:一台"能算出差分"的定位设备 RTK 全称"实时动态差分定位",是… · 2026/11/16 8:56:04

Spring Boot+Vue财务系统源码部署与改造:从跑通到避坑指南
Spring Boot+Vue财务系统源码部署与改造:从跑通到避坑指南

简介:基于SpringBoot与Vue的财务管理系统完整源码包,聚焦中小型企业财务信息化场景,适合Java方向的毕业设计、课程设计以及需要快速搭建可演示项目的开发者。系统功能覆盖首页、个人中心、员工管理、部门管理、员工工资与工资调整、资产类别、… · 2026/11/15 18:40:59

电工作业操作类别保姆级教程:特种作业证没拿就别想上岗
电工作业操作类别保姆级教程:特种作业证没拿就别想上岗

电工作业操作类别保姆级教程:特种作业证没拿就别想上岗 你还在为找不到电工工作发愁?别怪行业门槛高,只怪你手里还没攥紧电工作业操作类别证书。现在绝大多数用人单位,尤其是建筑工地、电力公司、工业厂区,都要求电工必须持有国家认可的特种作业操作证。… · 2026/11/16 21:11:22

电工证的准考证怎么查 别踩坑了,现在查证流程全在这儿了
电工证的准考证怎么查 别踩坑了,现在查证流程全在这儿了

电工证的准考证怎么查 别踩坑了,现在查证流程全在这儿了 怕考不过白交培训费?别让电工证的准考证查不到耽误你整个职业发展。现在越来越多的建筑工人都开始意识到,电工证是从事电气作业的“敲门砖”,但很多人却在查准考证这一步就卡住了。今天我们就来聊… · 2026/11/16 21:11:22

安灯要电工证吗 2026河南最新政策解读
安灯要电工证吗 2026河南最新政策解读

安灯要电工证吗 2026河南最新政策解读 怕考不过白交培训费?安灯要电工证吗,这个问题其实很多人都在问,尤其是像洛阳涧西区从事房建工程的朋友们,电工证几乎是岗位硬门槛。2026年河南最新政策对特种作业证书的要求更加细化,尤其是像安灯这类岗位… · 2026/11/16 21:11:22

电工作业规范引用名录值不值得考?实操考试心里没底怕挂科的你必须看
电工作业规范引用名录值不值得考?实操考试心里没底怕挂科的你必须看

电工作业规范引用名录值不值得考?实操考试心里没底怕挂科的你必须看 实操考试心里没底怕挂科,尤其是准备报考电工证的你,肯定最关心的就是考试内容和规范引用名录到底靠不靠谱。电工作业规范引用名录不仅是考试的重点,也是你未来工作中必须遵守的“铁律”… · 2026/11/16 21:11:22

苏州哪里有考电工证的官方回应来了,学历不高也能报!
苏州哪里有考电工证的官方回应来了,学历不高也能报!

苏州哪里有考电工证的官方回应来了,学历不高也能报! 你是不是也担心学历不高报不了电工证?别急,官方回应来了, 苏州哪里有考电工证的… · 2026/11/16 21:11:22

韩国考电工证方法全攻略,考前押题怎么用不被坑
韩国考电工证方法全攻略,考前押题怎么用不被坑

韩国考电工证方法全攻略,考前押题怎么用不被坑 你是不是正在为【韩国考电工证方法】发愁?不知道从哪报名,怕被中介骗钱,还担心考试内容不熟悉?别急,这篇文章就告诉你怎么稳妥搞定,不走弯路,还能掌握【考前押题】技巧。… · 2026/11/16 21:10:21

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/16 3:21:55

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/16 3:01:18

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/16 8:30:17

电工证培训的通知在哪考?别再被中介骗了
电工证培训的通知在哪考?别再被中介骗了

电工证培训的通知在哪考?别再被中介骗了 你是不是还在为 电工证培训的通知在哪考 发愁?网上搜了一堆信息,结果要么是挂羊头卖狗肉的培训机构,要么就是打着“包过”旗号的骗子?别急,今天我来给你讲讲, 电工证培训的通知… · 2026/11/16 0:00:34

高级电工证企业认可吗保姆级教程:实操考试心里没底怕挂科?看完这些建议再考不迟
高级电工证企业认可吗保姆级教程:实操考试心里没底怕挂科?看完这些建议再考不迟

高级电工证企业认可吗保姆级教程:实操考试心里没底怕挂科?看完这些建议再考不迟 你是不是也这样,站在高压电工实操考试的设备前,手心冒汗,生怕一个操作失误就被判不合格?实操考试心里没底怕挂科,这是很多准备考高级电工证的人的真实写照。别担心,今天… · 2026/11/16 0:00:34

电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享
电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享

电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 怕考不过白交培训费?你不是一个人,信阳的李师傅去年刚转岗做电工,就因为没搞清楚电工证去哪个部门考核,差点交了8000块的培训费。别急,下面这份实操考试全攻略,告诉你电工证到底值不值得考… · 2026/11/16 0:00:34

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:43

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:57

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:48

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码