复选框必须使用同名name属性,不可加[];筛选表单须用包裹并配合;读取多选值应调用formData.getAll()而非entries();label必须包裹checkbox以保障移动端点击体验;value值须与后端接口严格一致。

复选框必须用同名 name,别加 []
后端接收多选值(比如品牌、标签)依赖浏览器原生行为:多个 <input type="checkbox" name="brand" value="apple"> 被勾选时,FormData 会自动合并为 brand=apple&brand=samsung,后端解析成数组。加 name="brand[]" 是 PHP 特有约定,在纯 HTML/JS 场景下毫无作用——FormData 不识别方括号,后端收不到任何 brand 字段。
常见错误:
• 动态渲染时漏写 name 或拼错(如 brand-name)
• 给每个 checkbox 设不同 name,再靠 JS 拼对象(后续加 URL 同步或分页就崩)
• 用 data-name 模拟参数名,结果提交时完全不参与表单序列化
筛选表单必须用 <form></form> 包裹,别用 <div class="filter">
<p>不用 <code><form></form> 的直接后果是:每次改筛选逻辑都要重写 DOM 遍历逻辑。比如加个「评分≥4星」的 <select></select>,你得手动判断它的 type、取 value、过滤空值;而用 <form></form>,new FormData(form) 自动跳过未选中的 checkbox、忽略 disabled 项、合并同名项。
实操要点:
• 整个筛选区用 <form id="filter-form"></form> 包裹
• 每组条件(品牌、分类、状态)用 <fieldset></fieldset> 隔开,语义清晰且支持无障碍聚焦
• 所有输入控件(<input>、<select></select>、<textarea></textarea>)必须是 form 的直属子元素或嵌套在 fieldset 内
• 别把 checkbox 放在 <div> 里再塞进 form——它必须是表单控件,否则 <code>form.elements 拿不到
立即学习“前端免费学习笔记(深入)”;
JS 读取多选值要用 formData.getAll(),不是 entries()
Object.fromEntries(formData.entries()) 只取每个 name 的第一个值,对 checkbox 完全失效——比如勾了 apple 和 samsung,entries() 返回 ["brand", "apple"] 就停了,samsung 被丢掉。
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
正确做法:
• 用 formData.getAll('brand') 明确取数组,返回 ["apple", "samsung"]
• 空值要主动过滤:const brands = formData.getAll('brand').filter(v => v)(防止用户手输空字符串)
• 多字段组合时,统一用 Object.fromEntries 处理单值字段(如 price_min),再手动合并 checkbox 数组:{ ...singleParams, brand: brands }
• 提交前校验:如果所有 checkbox 都没勾,getAll() 返回空数组,别误当成「全部」
移动端点击区域太小?label 必须包住 checkbox
纯 <input type="checkbox"> 在手机上点击区域只有 12×12px,用户根本点不中。错误做法是给它加 width: 20px; height: 20px,但 CSS 放大不等于可点击区域变大。
解决方法只有一条:
• 每个 checkbox 必须被 <label></label> 包裹:<label><input type="checkbox" name="brand" value="apple"> Apple</label>
• 或用 for 属性绑定:<input id="brand-apple"><label for="brand-apple">Apple</label>
• 不要只包文字,label 标签本身要覆盖整个可点击区域(默认块级或设 display: block)
• 避免用 span 替代 label——它不触发 checkbox 的 focus 和屏幕阅读器朗读
最常被忽略的一点:checkbox 的 value 必须和服务端约定一致,不能是中文或带空格的字符串。比如后端接口要求 brand=huawei,前端就不能写 value="华为",否则提交后端收不到匹配项。


















