实现镜像语言功能需要涉及以下步骤:
以维吾尔语为例实现镜像语言功能步骤如下:
{
"string": [
{
"name": "settings",
"value": "تەڭشەك"
}
]
} {
"string": [
{
"name": "module_desc",
"value": "module description"
},
{
"name": "EntryAbility_desc",
"value": "description"
},
{
"name": "EntryAbility_label",
"value": "label"
},
{
"name": "settings",
"value": "设置"
}
]
} try { i18n.System.setAppPreferredLanguage('ug'); } catch (error) { let err: BusinessError = error as BusinessError; console.error(`call System.setAppPreferredLanguage failed, error code: ${err.code}, message: ${err.message}.`); }
设置偏好语言为'default'后,应用语言将跟随系统语言,应用冷启动生效。
onCreate(): void { i18n.System.setAppPreferredLanguage('default'); try { this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET); } catch (err) { hilog.error(DOMAIN, 'testTag', 'Failed to set colorMode. Cause: %{public}s', JSON.stringify(err)); } hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate'); }
属性 | 说明 |
|---|---|
LTR | 顺序为从左向右。 |
RTL | 顺序为从右向左。 |
Auto | 设置为Direction.Auto,且当前的系统语言(如维吾尔语)的阅读习惯是从右向左。 |
.direction(Direction.Auto) // 设置为Direction.Auto,且当前的系统语言(如维吾尔语)的阅读习惯是从右向左
import { BusinessError } from '@kit.BasicServicesKit'; import { i18n } from '@kit.LocalizationKit'; @Entry @Component struct FollowSystemDirection { aboutToAppear() { try { i18n.System.setAppPreferredLanguage('ug'); } catch (error) { let err: BusinessError = error as BusinessError; console.error(`call System.setAppPreferredLanguage failed, error code: ${err.code}, message: ${err.message}.`); } } build() { Column() { Row() { Image($r('sys.media.ohos_ic_back')) // 图片资源需开发者自行更换 .height(25).objectFit(ImageFit.START).aspectRatio(1) .matchTextDirection(true) // 图片跟随系统语言方向 Text($r('app.string.settings')) .fontSize(16) } .width('100%') .height(47) .backgroundImageSize(ImageSize.FILL) .justifyContent(FlexAlign.SpaceBetween) .alignItems(VerticalAlign.Center) .direction(Direction.Auto) // 设置为Direction.Auto,且当前的系统语言(如维吾尔语)的阅读习惯是从右向左 Button($r('app.string.settings')) // 文本需开发者自行更换 .width('auto') .margin({ top: 30 }) Button($r('app.string.settings')) // 文本资源需开发者自行更换 .width('auto') .margin({ top: 10 }) } .padding({ left: 10, right: 20 }) } }
效果预览:

import { BusinessError } from '@kit.BasicServicesKit'; import { i18n } from '@kit.LocalizationKit'; @Entry @Component struct NotFollowSystemDirection { aboutToAppear() { try { i18n.System.setAppPreferredLanguage('ug'); } catch (error) { let err: BusinessError = error as BusinessError; console.error(`call System.setAppPreferredLanguage failed, error code: ${err.code}, message: ${err.message}.`); } } build() { Column() { Row() { Image($r('sys.media.ohos_ic_back')) // 图片资源需开发者自行更换 .height(25).objectFit(ImageFit.START).aspectRatio(1) .matchTextDirection(false) // 图片不跟随系统语言方向 Text($r('app.string.settings')) .fontSize(16) } .width('100%') .height(47) .backgroundImageSize(ImageSize.FILL) .justifyContent(FlexAlign.SpaceBetween) .alignItems(VerticalAlign.Center) .direction(Direction.Auto) // 设置为Direction.Auto,且当前的系统语言(如维吾尔语)的阅读习惯是从右向左 Button($r('app.string.settings')) // 文本需开发者自行更换 .width('auto') .margin({ top: 30 }) Button($r('app.string.settings')) // 文本需开发者自行更换 .width('auto') .margin({ top: 10 }) } .padding({ left: 10, right: 20 }) } }
效果预览:

Q:Direction.Rtl枚举值是字符串类型吗?
A:根据HarmonyOS最新文档的说明,现在Direction.Rtl枚举值不使用数据枚举值表示,用typeof Direction.Rtl可以确认Direction.Rtl类型为string类型。