应采用「JSON语言包+数据驱动模板」分离语言数据与视图，通过data-i18n属性绑定翻译键，按需加载、批量更新DOM，避免硬编码和逐个修改；优先URL参数→localStorage→navigator.language确定语言，标准化为zh/en/ja等主语言码；跳过表单value更新，仅处理placeholder/title，用Text节点过滤和ignore属性保障状态不丢失。
怎么让 HTML 页面真正响应语言切换，而不是只改文字
纯靠 JS 替换 innerHTML 或硬编码多套 DOM 是不可维护的。关键在于把语言数据和视图分离，用轻量机制驱动渲染。推荐用「JSON 语言包 + 数据驱动模板」组合，不引入框架也能做到按需加载、无闪屏切换。
常见错误现象：document.getElementById('title').innerText = 'Hello' 这类硬写逻辑散落在各处，加个新语言要改十几处；或者用 lang 属性手动控制 CSS 显示隐藏，结果 SEO 不收录非默认语言内容，且无法被屏幕阅读器正确识别。
- 语言包必须是纯 JSON，字段名统一（如
home.title、form.submit），避免嵌套过深 - 页面初始化时读取浏览器
navigator.language，但允许用户通过 URL 参数（如?lang=ja）或 localStorage 覆盖 - 切换语言时，只触发一次 DOM 批量更新，不要逐个元素查 ID 修改
如何用 data-i18n 属性实现零侵入式文本绑定
在 HTML 标签上加 data-i18n 属性标记翻译键，比如 <h1 data-i18n="home.welcome"></h1>，JS 加载对应语言包后批量填充。这种方式不破坏语义结构，不影响 SSR 可读性，也兼容 CSP 策略（无需 eval 或内联脚本）。
使用场景：已有静态 HTML 页面需要快速国际化，或团队前端能力参差，不想强推模板引擎。
立即学习“前端免费学习笔记（深入）”；
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- 支持属性绑定：例如按钮的
data-i18n-title="tooltip.save"自动设为title属性 - 支持插值：语言包里写
"search.placeholder": "Search {type}..."，JS 渲染时传入{ type: 'products' } - 注意兼容性：IE11 不支持
dataset的驼峰访问，要用getAttribute('data-i18n')兜底
为什么不能直接用 navigator.language 当作最终语言标识
navigator.language 返回的是浏览器 UI 语言（如 zh-CN），但用户实际偏好可能是 zh-HK 或仅 zh。更严重的是，某些安卓 WebView 返回空字符串或错误值，导致 fallback 失效。
性能影响：如果每次切换都重新 fetch 整个语言包，网络差时会卡顿；若全量预加载所有语言，则首屏体积暴涨。
- 正确做法：先检查 URL 参数
lang→ 再查 localStorage.getItem('preferred-lang') → 最后 fallback 到navigator.language || 'en' - 语言代码标准化：用
Intl.Locale（现代环境）或简单正则/^([a-z]{2})/i提取主语言码，避免zh-CN和zh-TW加载不同文件却共用同一份简体中文翻译 - 建议语言包按主语言分发：
zh.json、en.json、ja.json，而非zh-CN.json，降低维护成本
切换语言时 DOM 重绘抖动、表单状态丢失怎么办
直接替换整个 body.innerHTML 或递归遍历节点修改文本，会导致 input 失焦、滚动位置重置、富文本编辑器内容清空。这不是“多语言问题”，是 DOM 更新策略错误。
容易踩的坑：监听 input 事件时没做防抖，语言切换瞬间触发大量无效更新；或对 select 下拉框只改文字不保留 value，导致提交数据错乱。
- 跳过表单控件的内容更新：检测元素是否为
input、textarea、select，只更新其placeholder或title，不碰value - 用
Text节点过滤：只遍历Node.TEXT_NODE类型节点替换文本，避免误操作子元素 - 给关键区域加
data-i18n-ignore属性（如实时聊天记录容器），明确声明不参与翻译
最麻烦的其实是复数规则和 RTL 布局——阿拉伯语切换后按钮要右对齐、日期格式倒过来、甚至整个 dir 属性得动态切。这些没法靠一套 JSON 解决，得配合 CSS 的 [lang="ar"] 规则和 Intl.DateTimeFormat 实例化处理。别指望一个 data-i18n 属性全搞定。
