SuperAPI AI 工具集

arabic-rtl-best-practices

通用与其它

查看项目

更新于 10-15 19:55

技能介绍

用途:为阿拉伯语等从右到左(RTL)语言实现正确的网页与移动端布局,并处理阿拉伯语与英文、数字混排时的双向(bidi)文本问题。

主要能力:

  1. 文档方向:始终在 HTML 属性上设置 <html lang="ar" dir="rtl">,而非仅用 CSS。
  2. CSS 逻辑属性:用 margin-inline-start/end、padding-inline-start/end、border-inline-start、text-align: start/end、float: inline-start、inset-inline-start 等替代物理方向属性,使布局自动镜像。
  3. 双向文本:用 unicode-bidi: isolate 或 bidi-override 隔离内嵌 LTR 内容;电话号码、信用卡号、代码片段用 <bdo dir="ltr"> 或 direction: ltr 包裹,避免数字倒序、标点错位。
  4. 阿拉伯语排版:推荐字体栈 'Tajawal', 'Assistant', 'Rubik', 'Noto Sans Arabic', sans-serif;字号约 16px、行高 1.7、word-spacing 0.05em,且不要加 letter-spacing。
  5. 框架配置:Tailwind 优先用逻辑工具类(ms-4、me-4、ps-4、pe-4、start-4、end-4、rounded-s-lg 等),仅在逻辑属性无法处理时用 rtl:/ltr: 变体;Next.js App Router 用 next/font 自托管阿拉伯字体并按 locale 设置 dir;React MUI 通过 stylis-plugin-rtl 与 createCache 配置 RTL 主题。

使用方式:按步骤先设文档方向,再替换物理属性为逻辑属性,处理混排文本,配置字体与框架,最后逐项检查图标、进度条、滑块、表单标签、面包屑、表格与图表等方向性元素。

限制与注意:Flexbox 在 RTL 下 row 会自动反转,再加 row-reverse 会双重翻转回 LTR;text-align: left 与物理 margin/padding 不会自动镜像。资料未提供具体版本兼容范围、性能数据或收费信息。