使用 Tabulator 驱动故障工单表:体验重要度搜索、排序与单元格编辑

プログラミング・Web開発カテゴリを表すパンダのイラスト 编程・Web开发

关于本文
本文是通过利用生成式 AI 的自动化生成流程创建的。我们查阅了 Tabulator 官方的表格、搜索和编辑 API,并利用 8 条虚拟故障工单创建了用于确认筛选和屏幕状态变化的教程。

验证状态:🧪 筛选逻辑已通过测试·浏览器显示尚未确认
我们已在 Node.js 中确认 8 项检查通过。GitHub Pages 公共 URL 的可访问性、实际浏览器中的单元格编辑、智能手机显示以及嵌入 WordPress 尚未进行验证。

使用 Tabulator 驱动故障工单表:体验重要度搜索、排序与单元格编辑

是否可以在网页上制作像 Excel 一样可以排序的表格,而无需新建服务器或数据库?使用 JavaScript 库 Tabulator,就可以统一处理列表的绘制、筛选、分页以及单元格编辑等功能。表格外侧的搜索框和按钮可以通过您自己的 JavaScript 进行连接。

本次的目标不仅仅是显示一个外观漂亮的表格。“重要度高的事件有多少件?”、“如果只看网络方面会怎样?”、“编辑真的被保存了吗?”我们要通过虚拟数据来确认这些问题。我们将现场所需的筛选思路(如故障管理或文章制作管理)融入到一个小型实验中。

首先运行:实时演示

无需外部账户或 API 密钥。只要页面打开,就可以尝试以下步骤。

  1. 将重要度的选择从“全部”更改为“高”。从原来的8条变为3条是预期的结果。

  2. 在搜索框中输入“网络”。在结合重要程度“高”的条件下2条并确认结果。

  3. 清除搜索框,选择表格中“状态(可编辑)”的单元格。该设计允许从准备好的选项中更改为“处理中”、“已完成”等状态。

  4. 点击“添加1条虚拟工单”来更改列表,通过“恢复最初的8条”来回到初始输入状态。

这里重要的是,即使显示内容发生了变化,也并不意味着已保存到数据库中这一区别。由于教学材料仅在浏览器内存中运行,重新加载页面后将恢复为初始数据。在没有保存功能的情况下,绝不能将编辑结果显示为“注册完成”。

制作了什么样的界面

项目内容
库Tabulator 6.3.1,MIT许可
方式从 GitHub Pages 分发静态 HTML、CSS 和 JavaScript
外部服务运行时不依赖业务 API、数据库和外部 CDN
数据8条虚构内容。不使用真实企业、员工及故障日志
操作重要度、搜索、列排序、状态单元格编辑、添加、初始化
数据保存不保存。关闭浏览器后操作结果将消失
已确认筛选、0条、总计、复制分离等8项逻辑
未确认实际浏览器渲染、公开URL、各终端显示、WordPress嵌入

表格中准备了编号、目标服务、故障概要、重要度、状态以及经过时间。虚构的目标服务为“网络”、“邮件”、“网页”和“认证”。如果套用实际的生产故障或内部系统信息,公开演示页面可能会导致信息泄露,因此在设计之初就准备好了虚构数据。

会发生什么?用数字追踪条件的变化

初始数据为8行。其中重要度为“高”的是编号101、104和105共3行,经过时间分别为45分钟、70分钟和55分钟。总计为 170分钟。此外,如果搜索“网络”,将会筛选出101和104共2行,经过时间的总计变为 115分钟。

操作显示条数显示行经过时间总计
不指定任何条件8件305分
重要度“高”3件170分
重要度“高”且つ“网络”2件115分
用不存在的词搜索0件0分

从这个结果中,原始数据的8条数量和当前显示对象的数量可以分开考虑。即使变成0条,原始数据也没有被删除。这就像在现场被告知“搜索不到”时,去区分是搜索条件太苛刻,还是数据本身就不存在一样。

※上表是由教材的虚拟数据计算出的逻辑预期结果,并非实际测量浏览器渲染的记录。在逻辑测试中,已确认8条、3条、2条、0条,共计170分钟。

代码机制:不自研库

Tabulator本身是已发布的第三方库,并非自研。我们使用了官方的v6.3.1版本,并将用于分发的JavaScript和CSS打包到了教材的 vendor/ 文件夹中。由于采用的不是每次打开页面都连接到其他网站最新库的架构,因此可以降低因外部CDN停止服务或意外升级版本而导致行为发生变化的风险。不过,更新分发包以及确认漏洞等维护工作仍然存在。

表格的连接部分采用了以下设计理念。

const table = new Tabulator("#table", {
  data: initialTickets,
  layout: "fitColumns",
  pagination: true,
  paginationSize: 5,
  columns: [
    {title: "番号", field: "id"},
    {title: "対象", field: "service"},
    {title: "状態", field: "status",
      editor: "list",
      editorParams: {values: ["未対応", "調査中", "対応中", "完了"]}}
  ]
});

这是为了解释机制而缩短的摘录。实际的完整版本位于Daily Code的 app.mjs 中,仅凭直接复制是无法构成完整代码的。 需要HTML的 #table 元素、加载Tabulator以及定义虚拟数据。

你可以向库的 setFilter 传递一个函数,用于判断目标行是否符合条件。本次我们只保留同时满足重要度和关键字的行。

table.setFilter(row => matches(row, priority.value, keyword.value));

当输入框发生变化时,会重新设置筛选器,getData("active")并通过它获取当前显示的对象数据,从而更新条目数和总时间。列标题的排序是Tabulator的功能,但重要度的字符串顺序并不一定符合业务上的严重程度顺序。如果要针对实际业务进行扩展,应当明确定义“高・中・低”的排序。

实际制作的文件与静态发布

在教材中,我们将用于显示的 index.html、外观的 style.css、屏幕操作的 app.mjs以及逻辑的 logic.mjs 进行了拆分。库本身固定配置在 vendor/tabulator.min.js 和 vendor/tabulator.min.css 中。使用方以及MIT许可证的全文也保留在同一个 vendor/ 中。

虽然不使用外部CDN,但要打开GitHub Pages的静态页面需要常规的网络通信。此外,将HTML file://直接打开时,浏览器可能会拒绝加载 JavaScript 模块。这种情况下,请按照教材 README 中的步骤启动本地 HTTP 服务器。Python 自带的 http.server 仅用于开发环境,不适合用于生产发布。

修改一处以加深理解

请尝试将重要程度从“高”改为“中”。如果你原本只关注高优任务,却混入了“中”,那么显示的数量自然会发生变化。接着清空搜索栏,此时仅保留重要程度作为筛选条件。通过这个操作,你可以体验到组合多个条件的 AND 搜索与取消其中一个条件的操作之间的区别。

另一个对比是编辑状态单元格。如果在界面上将“处理中”切换为“已完成”,该数据也仅存在于浏览器内存中。如果在刷新页面后该值恢复原状,说明修改并未被持久化保存。这是符合预期的设计。如果是企业级系统,则不能在编辑操作刚完成时显示成功,而是需要确认服务器已接受更新的结果。

当运行不正常时

症状检查位置处理方法
表格未显示vendor/tabulator.min.js 是否可以获取确认演示的相对路径与布局
样式错乱vendor/tabulator.min.css 是否可以获取确认 CSS 与 JS 的版本是否一致
打开本地 HTML 但功能无效控制台(Console)中是否存在 CORS 或 module 错误http://localhost 通过服务进行分发并确认
搜索结果为 0 条是否同时指定了重要度和字符串条件?解除其中一个条件后重新搜索
编辑后却恢复了原状本教程没有保存目标位置在实际工作中,需另外设计保存 API 和响应确认
显示条数不同是否修改了编辑、添加或筛选条件?通过“恢复前 8 条”重新进行实验

在实际工作中使用的注意事项

如果要真正处理故障工单,就必须确定浏览权限、更新权限、操作记录、同时编辑、公开范围、出错时的恢复以及个人信息的处理方式。Tabulator 是用于绘制和操作表格的工具,它并不会自动提供认证、审计追踪或保存目标位置。

此外,如果将大量数据分发到客户端,仅通过显示上的筛选隐藏并不能起到信息保护的作用。重要信息需要设计为仅从服务器传递具有权限的数据。在添加 CSV 导出或保存功能时,也需要谨慎决定如何处理个人信息或被解释为公式的值。,此处特意将其限定为完全在浏览器内完成的小型实验。表格的操作性首先进行理解,并将业务层面的保存、权限和审计与前端操作区分开来考虑,从而避免产生“引入库就能完成业务系统”的误解。

总结

使用 Tabulator,即使在静态的 HTML、CSS 和 JavaScript 中,也能制作出支持搜索、排序和状态更改的列表。请尝试将重要度设为“高”时显示 3 条、再通过“网络”筛选时显示 2 条的操作,并通过数字来确认画面的变化。

应用场景不仅限于缺陷管理。它还可以应用于常见问题(FAQ)搜索、虚拟订单列表、设备列表和稿件审查等。然而,在将其引入实际系统时,不能将库与数据保存处理混为一谈,还需要添加权限、冲突解决和验证的设计。

官方资料与代码

验证范围

在 Node.js v22.16.0 中运行了与教程测试文件相同的 Git blob SHA 内容,8 项逻辑均已通过。同时也确认了 Tabulator 本体 v6.3.1 以及采用 MIT 许可证的 GitHub 保存和读取功能。不过,未确认公开 Pages 的访问到达情况、页面渲染、单元格编辑的实际操作、移动端显示以及嵌入 WordPress 的效果。

文档信息

文章??
使用 Tabulator 驱动故障工单表:体验重要度搜索、排序与单元格编辑
?布日期
更新日期
来源
https://papanda925.com/?p=18674&lang=zh

?可: ?于本站?有相??利的正文及原??表,除非?有?明,可依据 CC BY 4.0 使用。本文可能包含使用生成式AI?建或??的内容。若代??有?可声明,或?接的GitHub???定了?可,?代?以??可?准。引用内容、第三方?料、?片及商?不在本?可范?内。 使用政策

标题和URL已复制