跳至正文
uiify

国际化

为服务端渲染的页面设置区域设置、方向,以及适合相应文字系统的文案。

在服务端设置文档语言和方向。根据路由渲染<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",让它在其他区域设置中仍保留英文发音、字体选择和文本顺序。

本页由机器翻译,尚未经人工审核。