SuperAPI AI 工具集

arabic-rtl-mobile

前端与建站

查看项目

更新于 10-15 19:55

技能介绍

用途:在 iOS 原生(SwiftUI、UIKit)、Android 原生(Jetpack Compose、Views/XML)和 React Native 中构建或修复阿拉伯语优先的移动界面,让屏幕呈现原生 RTL 效果。

核心规则:先判断应用或屏幕根级是否已实际 RTL。若已 RTL,优先使用框架自带的逻辑方向语义:iOS 用 leading/trailing,Android 用 start/end,React Native 用 start、end、marginStart、paddingStart 及 I18nManager.isRTL。不要盲目再加一层局部 RTL 覆盖,也不要随意把逻辑对齐替换成硬编码 right/left。

视觉哨兵检查:修行、图标或控件前,先放一个全宽阿拉伯语文本块。若它落在视觉右侧,说明 RTL 正常;若落在左侧,先修根方向,再动行级布局。

文本块:标题、副标题、描述、辅助文案和卡片内容应占满可用宽度,用框架逻辑方向工具锚定;仅在设计明确要求时才居中。

行布局:阿拉伯语行分两区,主文本在视觉右侧,次要控件或附件在视觉左侧,如步进器、时长、状态标签、展开箭头、数字徽章。文本块占弹性宽度,两者之间留可见空隙,不要向中间塌缩。SwiftUI 和 Compose 常用 Spacer();UIKit、Android Views 和 React Native 通常需要弹性文本容器加间距。不要机械镜像代码,要镜像视觉结果。先修一行哨兵并确认文本在右、附件在左、中间有空隙,再套用到整屏。

局部控件方向:加减控件、数字步进器、分段控件、播放控件等复合控件,即使处于阿拉伯语屏幕也应保持内部顺序。需分别检查控件整体位置是否正确、内部符号顺序是否正确;必要时对控件本身做局部 LTR 处理,同时保持周围行 RTL。

导航、图标与动效:返回箭头应指向右,展开箭头应位于主文本块对侧,方向性图标要匹配实际导航或操作方向,手势和方向性动画需目视检查。React Native 中源图片不会因应用 RTL 自动翻转,有方向含义的图标需用 I18nManager.isRTL 选择替代资源或做方向变换。

卡片:标题、描述和辅助文案应全宽且方向感知,主内容列在视觉右侧,除非设计另有说明。

常见失败模式:阿拉伯语文本仅用固有宽度而显得漂浮;硬编码 right/left;在已继承 RTL 的屏幕内再加局部覆盖;行内无弹性文本区或间距导致文本与附件挤在一起;方向性图标仍为 LTR;React Native 绝对定位忽略 RTL;Android Views 仍用 left/right 边距;控件位置正确但内部加减顺序反了;只镜像代码对称而非实际视觉结果。

视觉 QA:改完共享组件后仍需逐屏目视检查页面标题、副标题、卡片标题与描述、行标题与副标题、指标标签与值、展开箭头、返回箭头、底部 CTA 间距,以及根级是否已继承 RTL、局部覆盖是否与之冲突、全宽阿拉伯语哨兵是否落在视觉右侧、哨兵行文本与附件间是否有真实空隙、方向性图标是否正确、控件内部是否需局部 LTR、方向性动画或手势是否仍正确。

工作方式:先识别技术栈,再判断根级 RTL 是否已强制,先修文本块宽度与逻辑对齐,再修行组合,再修箭头、图标与方向动效,最后对每个受影响屏幕做视觉 RTL QA。不要假设“已启用 RTL”就等于屏幕已正确。