datalist 仅提供静态候选数据源，不控制显示逻辑；list 属性与 datalist 的 id 必须字符级精确匹配；仅部分 input type 支持（如 text、search），option 的 value 是唯一生效字段，动态更新需手动替换 DOM。
datalist 不是自动补全控件，它只提供静态候选数据源；浏览器是否显示、何时匹配、怎么高亮，完全由自身策略决定，你无法用 CSS 或事件直接干预。
list 属性和 datalist 的 id 必须完全一致（大小写敏感）
这是最常失效的原因。不是“差不多就行”，而是字符级精确匹配：list="cities" 必须对应 <datalist id="cities">。写成 list="Cities"、list="cities "（尾部空格）、list="city-list" 都会彻底失效。
常见错误现象：
- 控制台无报错，但下拉建议始终不出现
- 页面检查发现
datalist已渲染，但input完全无视它
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 统一用小写字母 + 连字符命名，例如
id="country-options"和list="country-options" - 避免在 JS 中拼接
list值，改用硬编码或从datalist.id动态读取 - 用
document.querySelector('input[list]')检查是否真有元素带该属性
只有特定 type 的 input 才会触发 datalist 建议
不是所有 input 类型都支持：type="text"、type="search"、type="url"、type="tel"、type="email" 是稳定支持的；type="number" 在 Safari 中基本无效，type="date" 仅部分 Chrome/Firefox 版本响应，type="password" 和 type="hidden" 明确禁用。
常见错误现象：
- 把
type="number"改成type="text"后建议突然出现 - 移动端 Safari 完全不弹出下拉，但桌面 Chrome 正常
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 优先用
type="text"，再通过inputmode="numeric"或pattern做轻量校验 - 不要依赖
type="number"实现数字建议 —— 浏览器会先拦截非数字输入，根本没机会触发 datalist - 若必须用
type="search"，注意部分旧版 Safari 对它的datalist支持弱于type="text"
option 的 value 属性是唯一生效字段
label 属性仅影响部分浏览器的显示文本（如 Firefox 下拉中显示 label 而非 value），但**不参与匹配逻辑**，也不影响最终填入 input 的值。用户选中后，填入的是 value 的内容，不是标签内文字，也不是 label 的值。
常见错误现象：
- 写了
<option label="Python">Py</option>，结果输入“Py”不匹配 - 用户点了“北京”，但表单提交的是空字符串或“undefined”
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 每个
option必须显式写value="xxx"，哪怕和文本内容一样 - 别省略引号：
value=Chrome是非法 HTML，可能被解析为value="Chrome"或截断 - 中文、空格、特殊符号要 URL 编码？不用。直接写
value="上海浦东新区"即可，浏览器原生支持
动态更新 datalist 只能靠 DOM 替换，且有节奏要求
浏览器不会监听 datalist 内容变化并自动刷新建议框。你必须手动清空并重写 option 元素，而且要在用户输入的节奏里完成：太慢，建议滞后；太快，DOM 频繁重绘卡顿；不清理旧项，会导致重复叠加。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
replaceChildren()替代innerHTML = ""+appendChild()，更安全高效 - 加简单节流：延迟 100–200ms 再更新，避免每敲一个字都重刷
- 空输入时，清空
datalist或恢复默认选项，否则残留旧建议可能误导用户 - 移动端尤其注意：iOS Safari 对动态更新支持不稳定，高频搜索场景建议降级为自定义下拉
真正麻烦的不是写法，而是浏览器对“何时重新扫描 datalist”没有标准定义 —— 有的等焦点移入，有的等输入事件结束，有的甚至要手动 dispatch 一次 input 事件才能触发刷新。
