跳到主要内容

I18nManager

I18nManager 模块提供用于管理阿拉伯语、希伯来语等语言的从右到左（RTL）布局支持的实用程序。它提供控制 RTL 行为和检查当前布局方向的方法。

示例​

根据 RTL 更改位置和动画​

如果您绝对定位元素以与其他 flexbox 元素对齐，它们在 RTL 语言中可能不会对齐。使用 isRTL 可以调整对齐方式或动画。

开发期间​

参考

属性​

isRTL​

typescript
static isRTL: boolean;

一个布尔值，指示应用程序当前是否处于 RTL 布局模式。

isRTL 的值由以下逻辑确定

  • 如果 forceRTL 为 true，则 isRTL 返回 true
  • 如果 allowRTL 为 false，则 isRTL 返回 false
  • 否则，isRTL 将为 true，前提是满足以下条件
    • iOS
      • 设备上用户偏好的语言是 RTL 语言
      • 应用程序定义的本地化包含用户选择的语言（如 Xcode 项目文件（knownRegions = (...)）中定义的）
    • Android
      • 设备上用户偏好的语言是 RTL 语言
      • 应用程序的 AndroidManifest.xml 在 <application> 元素上定义了 android:supportsRTL="true"

doLeftAndRightSwapInRTL​

typescript
static doLeftAndRightSwapInRTL: boolean;

一个布尔值，指示在 RTL 模式下是否应自动交换左右样式属性。启用后，在 RTL 布局中，左变为右，右变为左。

方法​

allowRTL()​

typescript
static allowRTL: (allowRTL: boolean) => void;

启用或禁用应用程序的 RTL 布局支持。

参数

  • allowRTL (boolean)：是否允许 RTL 布局

重要提示

  • 更改将在下次应用程序启动时生效，而不是立即生效
  • 此设置会在应用程序重启后保留

forceRTL()​

typescript
static forceRTL: (forced: boolean) => void;

强制应用程序使用 RTL 布局，而不考虑设备语言设置。这对于在开发过程中测试 RTL 布局非常有用。

请避免在生产应用程序中强制使用 RTL，因为它需要完全重启应用程序才能生效，这将导致用户体验不佳。

参数

  • forced (boolean)：是否强制 RTL 布局

重要提示

  • 更改将在下次应用程序启动时完全生效，而不是立即生效
  • 设置会在应用程序重启后保留
  • 仅用于开发和测试。在生产环境中，您应该完全禁用 RTL 或妥善处理它（请参阅 isRTL）

swapLeftAndRightInRTL()​

typescript
static swapLeftAndRightInRTL: (swapLeftAndRight: boolean) => void;

在 RTL 模式下交换左右样式属性。启用后，在 RTL 布局中，左变为右，右变为左。不影响 isRTL 的值。