用自动提交筛选参数最稳妥,浏览器自动编码、生成查询字符串并更新URL,支持刷新/书签;需name与后端一致、多选用相同name、用URLSearchParams读参并decodeURIComponent解码比对、标签删除时delete+replaceState更新URL,URL是唯一真相源。

用 form[method="get"] 自动存参数,别手拼 URL
直接让浏览器干这事最稳。把筛选控件包进 ,提交时自动把所有 name/value 转成查询字符串,URL 地址栏实时更新,刷新、后退、书签全正常。
常见错误是 JS 手动拼 window.location.href = '?brand=nike&price=100-500',一来容易漏编码(中文变乱码),二来改个字段就得重写逻辑,三来破坏浏览器原生导航能力。
-
name必须和后端接收的 query 参数名完全一致,比如后端要category,就写,别写成filter_category - 多选 checkbox 用相同
name(如name="brand"),浏览器会自动提交多个值:?brand=nike&brand=adidas - 不要加
[]后缀(如name="brand[]"),FormData和 URLSearchParams 都不认这个,后端收不到 - 表单
action设为当前页路径(或留空),避免跳转到错误页面
用 URLSearchParams 读参并同步 UI 状态
页面加载或路由变化时,必须从 URL 拿参数、反向点亮对应筛选项,否则用户刷新就丢状态。别用 location.search.split('&') 手撕字符串——编码、重复键、空值都容易出错。
正确做法是:
- 用
new URLSearchParams(window.location.search)实例化,再调.getAll('brand')拿多选值,.get('category')拿单选值 - 每个筛选项要有稳定标识,比如
- 遍历所有 checkbox,用
checkbox.value对比params.getAll('brand')中的值,匹配则设checkbox.checked = true - 中文或特殊字符必须用
decodeURIComponent()解码后再比对,否则%E4%B8%AD%E6%96%87永远不等于"中文"
多选标签渲染与删除要靠唯一 data-param-key 和 data-param-value
用户点了“Nike”、“Adidas”,UI 上得显示两个可删标签;点掉其中一个,URL 得实时去掉对应参数,不能只删 DOM 节点。
核心是:每个标签的删除按钮必须带明确的定位信息。
- 渲染标签时,用
Array.from(new Set(values))去重,防止反复点击同一项导致重复 - 删除按钮写成
- 点击时用
params.delete(key, value)移除指定键值对,再调history.replaceState()更新 URL,避免新增历史记录 - 注意:用
params.set(key, value)会覆盖全部同名值,多选场景必须用delete+ 重新append每个剩余值
空值、默认值和边界情况必须显式处理
URL 里没出现某个参数,不等于它“没选”,而可能代表“不限制”。但有些筛选项(比如价格区间)必须至少填一个才有效,这类逻辑不能依赖 URL 是否存在,得靠业务判断。
- 初始化时,如果 URL 没有
category,UI 上应高亮“全部”选项,而不是留空或报错 - 当用户清空所有品牌,
params.getAll('brand')返回空数组,此时应params.delete('brand'),让 URL 彻底移除该参数 - 数值型参数(如
price_min)需转成数字再参与过滤,但 URL 里永远是字符串,parseInt(params.get('price_min')) || undefined更安全 - 筛选项本身被禁用(
disabled)时,FormData和URLSearchParams都会忽略它,所以控制显隐要用hidden或 CSS,别误用disabled
真正难的不是怎么写代码,而是想清楚「哪个环节负责哪部分状态」:URL 是唯一真相源,DOM 是它的投影,JS 只做同步桥梁。一旦让 JS 对象或 DOM 属性变成事实源头,URL 就容易和界面脱节。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











