RTL 是 Right-to-left(从右向左) 的缩写。其意为人们书写阅读习惯是从右向左,朝左继续的,常见的 RTL 语言有阿拉伯语,希伯来语等。
看一下 LTR(左图) 布局与 RTL(右图) 布局之间的对比:
那么对于这种从右到左的习惯,在 Android 布局中有没有支持呢?
答案是有的:从 Android 4.2 即 SDK 17 开始,提供了全面的本地布局支持,允许镜像布局,可以同时支持 RTL 和 LTR。
接下来我将介绍如何一步一步适配阿拉伯语。
name | desc | chinese |
---|---|---|
android:layoutDirection | attribute for setting the direction of a component's layout | 设置组件的布局排列方向 |
android:textDirection | attribute for setting the direction of a component's text | 设置组件的文字排列方向 |
android:textAlignment | attribute for setting the alignment of a component's text | 设置文字的对齐方式 |
getLayoutDirectionFromLocale() | method for getting the Locale-specified direction | 获取指定地区的惯用布局方式 |
在 AndroidManifest.xml 文件中 application 节点添加支持从右到左布局方式代码
...
相关链接:change-language-programmatically-in-android
对应国家语言代码: what-is-the-list-of-supported-languages-locales-on-android
Resources res = getResources();
DisplayMetrics dm = res.getDisplayMetrics();
Locale locale = new Locale(languageToLoad);
Locale.setDefault(locale);
Configuration config = new Configuration();
config.locale = locale;
res.updateConfiguration(conf, dm);
AS 支持一键适配 RTL,主要是在原来 Layout 中设置 Left 和 Right 属性的补充添加 Start 和 End 属性(你们在写布局的时候是不是很少用到 paddingStart、marginStart?接下来你们写布局的时候可不能再偷懒了,该加的还是得加上)
Start 属性在 LTR 中对应 Left,在 RTL 中对应 Right,在API 17开始支持,为了兼容低版本,需要同时有 Left 和 Start。从市场来看,Android 4.2 系统以下的手机用户已经不多了,我的建议是可以不兼容,具体还得你们看自家产品在 4.2 系统以下用户数。
Refactor > Add RTL Support Where Possible...
名称 | 描述 |
---|---|
gradle-android-rtl | 自动修复布局文件中未添加RTL支持的标签 |
与 AS 插件的比较:
发现 EditText 控件基本都需要设置下面两个属性
相关链接:set-a-consistent-style-to-all-edittext-for-e-g
android:textAlignment="viewStart"
android:gravity="start"
那我们就可以在 style.xml 样式中全部 EditText 都设置
全局给所有 TextView 添加一个 RTL 属性
相关链接:setting-global-styles-for-views-in-android
TextUtilsCompat.getLayoutDirectionFromLocale(Locale.getDefault()) == LayoutDirection.RTL
在某些场合下, 这个方法很有用
Collections.reverse(List> list);
FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(
ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT);
params.setMargins(10, 0, 10, 0);
params.setMarginEnd(10);
相关链接: tabs-swipe-direction-in-right-to-left-android-app
Android 官方控件大多支持 RTL,ViewPager 除外,GitHub 上面有人对 ViewPager 进行修改支持 RTL, 地址