• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @system.configuration (应用配置)
2
3> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
4> - 从API Version 7 开始,该接口不再维护,推荐使用新接口[`@ohos.i18n`](js-apis-i18n.md)和[`@ohos.intl`](js-apis-intl.md)。
5>
6>
7> - 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9
10## 导入模块
11
12
13```
14import configuration from '@system.configuration';
15```
16
17
18## configuration.getLocale
19
20static getLocale(): LocaleResponse
21
22获取应用当前的语言和地区。默认与系统的语言和地区同步。
23
24**系统能力:** SystemCapability.ArkUI.ArkUI.Lite
25
26**返回值:**
27| 类型            | 说明            |
28| -------------- | ------------- |
29| LocaleResponse | 应用当前Locale相关信息。 |
30
31**示例:**
32  ```
33  export default {
34    getLocale() {
35      const localeInfo = configuration.getLocale();
36      console.info(localeInfo.language);
37    }
38  }
39  ```
40
41
42## LocaleResponse
43
44表示应用当前Locale的属性。
45
46**系统能力**:以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Lite
47
48| 名称   | 类型   | 可读   | 可写   | 说明                                       |
49| ---- | ------ | ---- | ---- | ---------------------------------------- |
50| language | string | 是    | 否    | 语言。例如:zh。 |
51| countryOrRegion | string | 是    | 否    | 国家或地区。例如:CN。 |
52| dir | string | 是    | 否    | 文字布局方向。取值范围:<br/>-&nbsp;ltr:从左到右;<br/>-&nbsp;rtl:从右到左。 |