第四章 使用 layoutDirection 属性控制单个布局的方向

4.1 原理讲解

Android 的布局方向（Layout Direction）由三层因素共同决定：系统全局设置（语言/区域）、应用级别声明（android:supportsRtl）以及布局级别的显式指定（layoutDirection）。其中 layoutDirection 是 ViewGroup 及其子类的属性，允许开发者强制某个容器内的子视图按 LTR 或 RTL 排列，而忽略系统或应用的整体方向。

该属性的优先级为：layoutDirection > 资源限定符 > 应用声明 > 系统语言。一旦在 XML 或代码中明确设置，该容器及其直接子 View 的方向即被锁定，但不会递归影响嵌套的子 ViewGroup（除非它们也显式设置）。

4.2 实现流程

1. 确认应用支持 RTL：在 AndroidManifest.xml 中添加 android:supportsRtl="true"（即使只针对单个布局设置，此声明仍是系统识别 RTL 的前提）。
2. 选择设置方式：
   • XML 静态设置：在布局根节点或目标 ViewGroup 中添加 android:layoutDirection="rtl" 或 "ltr"。
   • 代码动态切换：调用 view.setLayoutDirection(View.LAYOUT_DIRECTION_RTL)。
3. 验证效果：通过 TalkBack 手势滑动或 adb shell dumpsys activity displays 查看方向信息。

4.3 代码/配置/API 示例

4.3.1 XML 中设置 layoutDirection

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layoutDirection="rtl"
    android:orientation="horizontal">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="右端对齐的文本" />

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="按钮" />
</LinearLayout>

该 LinearLayout 内所有子 View 按从右到左排列，忽略系统语言。如需强制 LTR，则使用 android:layoutDirection="ltr"。

4.3.2 代码中动态切换

val container = findViewById<LinearLayout>(R.id.container)
// 切换到 RTL
container.setLayoutDirection(View.LAYOUT_DIRECTION_RTL)

// 切换到 LTR
container.setLayoutDirection(View.LAYOUT_DIRECTION_LTR)

// 恢复继承（从父容器或系统继承）
container.setLayoutDirection(View.LAYOUT_DIRECTION_INHERIT)

动态切换通常用于用户偏好设置或运行时检测到语言变更时。切换后需调用 requestLayout() 和 invalidate() 刷新布局。

4.3.3 结合资源限定符（补充说明）

若需要根据语言自动切换某个布局的方向，建议优先使用资源限定符（如 layout-ldrtl）。但 layoutDirection 属性可在资源限定符的基础上做局部覆盖：

<!-- res/layout-ldrtl/activity_main.xml -->
<LinearLayout
    android:layoutDirection="ltr">
    <!-- 即使在 RTL 系统下，该容器仍然为 LTR 排列 -->
</LinearLayout>

4.4 调试方法

4.5 常见错误

• 未声明 supportsRtl：android:layoutDirection="rtl" 在 API 17+ 上虽可编译，但若 Manifest 缺少该声明，系统可能完全不处理 RTL 相关属性，导致布局仍按 LTR 渲染。
• 子 View 方向与父容器冲突：一个 ViewGroup 设置了 layoutDirection="ltr"，但其子 ViewGroup 又设置了 layoutDirection="rtl"，导致内部排列方向依次被覆盖，容易产生混乱。应在设计阶段统一层次结构。
• 忘记刷新布局：代码动态切换后未调用 requestLayout()，更新不会生效。
• 混淆 layoutDirection 与 textDirection：layoutDirection 控制容器排列方向，textDirection 控制文字书写方向。两者结合使用才能完整适配 RTL。

4.6 性能稳定性优化

• 避免频繁动态切换：setLayoutDirection() 会触发整个 View 树的重新测量和布局，在频繁调用（如每帧切换）时可能导致丢帧。建议仅在配置变更或用户主动操作时切换。
• 缓存方向状态：如果需要在多个地方读取当前方向，使用成员变量缓存 container.getLayoutDirection() 的值，避免重复查询。
• 与 RtlSpacingHelper 的解耦：若自定义 View 内使用了 RtlSpacingHelper 硬编码方向，应改为依赖 getLayoutDirection() 动态计算。
• 测试覆盖极端情况：包括同时使用 layoutDirection、textAlignment、textDirection 的场景，确保 TalkBack 的焦点移动与视觉顺序一致。