前端实时过滤适用于≤1000行小数据,需单次遍历统一判断条件、空值默认放行、数值转字符串比对、优先使用dataset属性;后端驱动为业务默认,表单name须与后端参数一致,用FormData自动提取参数;防抖200ms仅用于UI响应,搜索提交须立即触发;空结果与导出逻辑须基于筛选后数据,动态计算colspan,区分“暂无数据”和“搜索无结果”。

前端实时过滤适合小数据(≤1000行)
数据全量加载到页面时,用 JS 遍历 tbody tr 做显隐控制最直接。关键不是“能不能写出来”,而是避免漏行、错显或卡顿。
- 所有筛选条件必须在单次遍历中统一判断,用
&&连接每个条件的布尔结果,不能链式调用.filter()或嵌套if - 空输入值要默认放行:比如
deptVal === "" ? true : cellDept === deptVal,否则一个框清空就整页变空 - 数值字段必须先转字符串再比对:
String(row.price).includes(keyword),否则1000.includes("10")会报错 - 不要直接读
textContent做匹配——它混入换行、空格、隐藏列文本;优先用data-price、data-status等dataset属性存结构化值
后端驱动是真实业务的默认选择
只要数据来自 API、需分页、有权限控制或关联查询,就必须交由后端拼 SQL。前端只负责收参、发请求、渲染结果。
- 用原生
<form></form>包裹筛选项,name必须和后端 query 参数名完全一致,例如price_min、status、category - 读取参数别手写对象:
const params = Object.fromEntries(new FormData(form).entries()),自动处理多选 checkbox、跳过空值、忽略 disabled -
price_min和price_max这类区间字段,后端需单独校验是否非空再参与 WHERE 条件,前端不拼 SQL - 防抖只用于 UI 响应(如搜索建议),提交查询必须立即触发——用户点“搜索”就是明确意图,不该延迟
input 事件 + 防抖是实时响应的底线配置
不用 input 事件,就覆盖不了粘贴、IME 上屏、剪切等操作;不加防抖,表格行一多就会肉眼可见卡顿。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 监听所有筛选控件的
input或change(select/multiple 用change),但回调函数必须共用一个,统一读取全部字段值 - 防抖时间设 200ms 足够:太短起不到作用,太长(如 500ms)会让用户觉得响应迟钝
- IE11 兼容可 fallback 到
propertychange,但仅当目标环境真有 IE11 用户时才加,别无脑 polyfill - 防抖函数里别直接操作 DOM,先计算出匹配的
tr元素数组,再批量设style.display,避免重排重绘抖动
无结果状态和导出逻辑最容易被忽略
“没搜到”不是清空 tbody,导出按钮点开却导出全部原始数据——这两处出问题,用户第一反应是“系统坏了”,而不是“我搜得不对”。
立即学习“前端免费学习笔记(深入)”;
- 空结果时插入一行
<tr><td colspan="4">未找到匹配项</td></tr>,其中colspan务必从thead th动态读取列数,硬编码极易错 - 区分两种空:
tableData.length === 0显示“暂无数据”,filteredData.length === 0 && keyword才显示“搜索无结果” - 导出、分页总数、当前页码显示——所有这些都必须基于当前筛选后的数据集,不是原始
tableData;否则用户筛选完导出,拿到的却是全量数据


















