在服务端设置文档语言和方向。根据路由渲染<html lang={locale} dir={direction}>,让辅助技术、浏览器双向文本算法和:lang()样式在首次绘制时就获取正确的值。不要在水合后才用客户端代码检测区域设置。
组件标签
通过组件的labelsprop传入翻译后的字符串。需要计数的标签使用字符串模板,例如"{index} of {count}";格式化数字时传入locale。formatLabel会替换命名占位符,并用Intl.NumberFormat格式化数值。
方向与定位
方向取自DOM中元素的dir。键盘行为通过resolveDirection(element)遵循该方向,也可通过显式的方向prop覆盖。弹出层的side采用物理方向(top、bottom、left、right);align采用逻辑方向(start、center、end),因此会随书写方向变化。
自定义键盘处理
输入框使用IME时,应等待组合输入完成后再处理导航键。响应Enter、方向键或Escape前,先检查isComposingKeyEvent(event);该检查也涵盖组合输入结束后仍报告键码229的浏览器。
排版与回退
样式表通过:lang()选择适合相应文字系统的字体和换行规则。应用使用自有字体时,可覆盖--font-sans-ja、--font-sans-zh-hans或--font-sans-ar。为未翻译的英文添加lang="en" dir="ltr",让它在其他区域设置中仍保留英文发音、字体选择和文本顺序。