关于本文
本文是通过利用生成式 AI 的自动化生成流程创建的。我们查阅了 Tabulator 官方的表格、搜索和编辑 API,并利用 8 条虚拟故障工单创建了用于确认筛选和屏幕状态变化的教程。验证状态:🧪 筛选逻辑已通过测试·浏览器显示尚未确认
我们已在 Node.js 中确认 8 项检查通过。GitHub Pages 公共 URL 的可访问性、实际浏览器中的单元格编辑、智能手机显示以及嵌入 WordPress 尚未进行验证。
使用 Tabulator 驱动故障工单表:体验重要度搜索、排序与单元格编辑
是否可以在网页上制作像 Excel 一样可以排序的表格,而无需新建服务器或数据库?使用 JavaScript 库 Tabulator,就可以统一处理列表的绘制、筛选、分页以及单元格编辑等功能。表格外侧的搜索框和按钮可以通过您自己的 JavaScript 进行连接。
本次的目标不仅仅是显示一个外观漂亮的表格。“重要度高的事件有多少件?”、“如果只看网络方面会怎样?”、“编辑真的被保存了吗?”我们要通过虚拟数据来确认这些问题。我们将现场所需的筛选思路(如故障管理或文章制作管理)融入到一个小型实验中。
首先运行:实时演示
可操作的 Tabulator 演示(静态页面。本次实际浏览器的访问与运行尚未验证)
GitHub 的 Daily Code 教程与 README(包含 HTML、CSS、JavaScript、版本固定的库以及测试)
无需外部账户或 API 密钥。只要页面打开,就可以尝试以下步骤。
将重要度的选择从“全部”更改为“高”。从原来的8条变为3条是预期的结果。
在搜索框中输入“网络”。在结合重要程度“高”的条件下2条并确认结果。
清除搜索框,选择表格中“状态(可编辑)”的单元格。该设计允许从准备好的选项中更改为“处理中”、“已完成”等状态。
点击“添加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)搜索、虚拟订单列表、设备列表和稿件审查等。然而,在将其引入实际系统时,不能将库与数据保存处理混为一谈,还需要添加权限、冲突解决和验证的设计。
官方资料与代码
操作演示(GitHub Pages)(本次发布的实际到达情况及实际浏览器运行情况未做确认)
验证范围
在 Node.js v22.16.0 中运行了与教程测试文件相同的 Git blob SHA 内容,8 项逻辑均已通过。同时也确认了 Tabulator 本体 v6.3.1 以及采用 MIT 许可证的 GitHub 保存和读取功能。不过,未确认公开 Pages 的访问到达情况、页面渲染、单元格编辑的实际操作、移动端显示以及嵌入 WordPress 的效果。
