Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 c80db68e 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!12062 格式修改 

Merge pull request !12062 from LiAn/master
上级 273688db 57306b93
隐藏空白更改
内联 并排
Showing with 279 addition and 283 deletion
zh-cn/application-dev/reference/apis/js-apis-i18n.md
浏览文件 @ c80db68e
...@@ -44,9 +44,9 @@ static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean ...@@ -44,9 +44,9 @@ static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -83,9 +83,9 @@ static getDisplayLanguage(language: string, locale: string, sentenceCase?: boole ...@@ -83,9 +83,9 @@ static getDisplayLanguage(language: string, locale: string, sentenceCase?: boole
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -114,9 +114,9 @@ static getSystemLanguages(): Array<string> ...@@ -114,9 +114,9 @@ static getSystemLanguages(): Array<string>
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -137,9 +137,9 @@ static getSystemCountries(language: string): Array<string> ...@@ -137,9 +137,9 @@ static getSystemCountries(language: string): Array<string>
**参数：** **参数：**
| 参数名 | 类型 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ----- | | -------- | ------ | ---- | ----- |
| language | string | 语言ID。 | | language | string | 是 | 语言ID。 |
**返回值：** **返回值：**
...@@ -151,9 +151,9 @@ static getSystemCountries(language: string): Array<string> ...@@ -151,9 +151,9 @@ static getSystemCountries(language: string): Array<string>
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -189,9 +189,9 @@ static isSuggested(language: string, region?: string): boolean ...@@ -189,9 +189,9 @@ static isSuggested(language: string, region?: string): boolean
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -220,9 +220,9 @@ static getSystemLanguage(): string ...@@ -220,9 +220,9 @@ static getSystemLanguage(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -247,17 +247,17 @@ static setSystemLanguage(language: string): void ...@@ -247,17 +247,17 @@ static setSystemLanguage(language: string): void
**参数：** **参数：**
| 参数名 | 类型 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ----- | | -------- | ------ | ---- | ----- |
| language | string | 语言ID。 | | language | string | 是 | 语言ID。 |
**错误码：** **错误码：**
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -286,9 +286,9 @@ static getSystemRegion(): string ...@@ -286,9 +286,9 @@ static getSystemRegion(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -313,17 +313,17 @@ static setSystemRegion(region: string): void ...@@ -313,17 +313,17 @@ static setSystemRegion(region: string): void
**参数：** **参数：**
| 参数名 | 类型 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ----- | | ------ | ------ | ---- | ----- |
| region | string | 地区ID。 | | region | string | 是 | 地区ID。 |
**错误码：** **错误码：**
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -352,9 +352,9 @@ static getSystemLocale(): string ...@@ -352,9 +352,9 @@ static getSystemLocale(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -379,17 +379,17 @@ static setSystemLocale(locale: string): void ...@@ -379,17 +379,17 @@ static setSystemLocale(locale: string): void
**参数：** **参数：**
| 参数名 | 类型 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | --------------- | | ------ | ------ | ---- | --------------- |
| locale | string | 指定区域ID，例如zh-CN。 | | locale | string | 是 | 指定区域ID，例如zh-CN。 |
**错误码：** **错误码：**
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -418,9 +418,9 @@ static is24HourClock(): boolean ...@@ -418,9 +418,9 @@ static is24HourClock(): boolean
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -453,9 +453,9 @@ static set24HourClock(option: boolean): void ...@@ -453,9 +453,9 @@ static set24HourClock(option: boolean): void
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -490,9 +490,9 @@ static addPreferredLanguage(language: string, index?: number): void ...@@ -490,9 +490,9 @@ static addPreferredLanguage(language: string, index?: number): void
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -528,9 +528,9 @@ static removePreferredLanguage(index: number): void ...@@ -528,9 +528,9 @@ static removePreferredLanguage(index: number): void
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -561,9 +561,9 @@ static getPreferredLanguageList(): Array<string> ...@@ -561,9 +561,9 @@ static getPreferredLanguageList(): Array<string>
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -592,9 +592,9 @@ static getFirstPreferredLanguage(): string ...@@ -592,9 +592,9 @@ static getFirstPreferredLanguage(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -623,9 +623,9 @@ static getAppPreferredLanguage(): string ...@@ -623,9 +623,9 @@ static getAppPreferredLanguage(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```js ```js
...@@ -658,9 +658,9 @@ static setUsingLocalDigit(flag: boolean): void ...@@ -658,9 +658,9 @@ static setUsingLocalDigit(flag: boolean): void
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```ts ```ts
...@@ -689,9 +689,9 @@ static getUsingLocalDigit(): boolean ...@@ -689,9 +689,9 @@ static getUsingLocalDigit(): boolean
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。 以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| -------- | ---------------------------------------- | | ------ | ---------------------- |
| 890001 | Unspported para value. | | 890001 | Unspported para value. |
**示例：** **示例：**
```ts ```ts
...@@ -713,9 +713,9 @@ isRTL(locale: string): boolean ...@@ -713,9 +713,9 @@ isRTL(locale: string): boolean
**参数：** **参数：**
| 参数名 | 类型 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ------- | | ------ | ------ | ---- | ------- |
| locale | string | 指定区域ID。 | | locale | string | 是 | 指定区域ID。 |
**返回值：** **返回值：**
...@@ -905,7 +905,7 @@ setFirstDayOfWeek(value: number): void ...@@ -905,7 +905,7 @@ setFirstDayOfWeek(value: number): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | ------ | ---- | --------------------- | | ----- | ------ | ---- | --------------------- |
| value | number | 否 | 设置一周的起始日，1代表周日，7代表周六。 | | value | number | 是 | 设置一周的起始日，1代表周日，7代表周六。 |
**示例：** **示例：**
```js ```js
...@@ -947,7 +947,7 @@ setMinimalDaysInFirstWeek(value: number): void ...@@ -947,7 +947,7 @@ setMinimalDaysInFirstWeek(value: number): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | ------ | ---- | ------------ | | ----- | ------ | ---- | ------------ |
| value | number | 否 | 一年中第一周的最小天数。 | | value | number | 是 | 一年中第一周的最小天数。 |
**示例：** **示例：**
```js ```js
...@@ -1153,7 +1153,7 @@ getLocationName(number: string, locale: string): string ...@@ -1153,7 +1153,7 @@ getLocationName(number: string, locale: string): string
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ---- | ------ | ---- | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---- | ---------------------------------------- |
| type | string | 是 | 是 | 表示对电话号码格式化的类型，取值范围："E164", "INTERNATIONAL", "NATIONAL", "RFC3966"。 | | type | string | 是 | 是 | 表示对电话号码格式化的类型，取值范围："E164", "INTERNATIONAL", "NATIONAL", "RFC3966"。 |
...@@ -1164,7 +1164,7 @@ getLocationName(number: string, locale: string): string ...@@ -1164,7 +1164,7 @@ getLocationName(number: string, locale: string): string
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------- | ------ | ---- | ---- | ---------------------------------------- | | ------------- | ------ | ---- | ---- | ---------------------------------------- |
| unit | string | 是 | 是 | 单位的名称，如："meter", "inch", "cup"等。 | | unit | string | 是 | 是 | 单位的名称，如："meter", "inch", "cup"等。 |
| measureSystem | string | 是 | 是 | 单位的度量体系，取值包括："SI", "US", "UK"。 | | measureSystem | string | 是 | 是 | 单位的度量体系，取值包括："SI", "US", "UK"。 |
......
zh-cn/application-dev/reference/apis/js-apis-intl.md
浏览文件 @ c80db68e
...@@ -4,9 +4,9 @@ ...@@ -4,9 +4,9 @@
[I18N模块](js-apis-i18n.md)提供其他非ECMA 402定义的国际化接口，与本模块共同使用可提供完整地国际化支持能力。 [I18N模块](js-apis-i18n.md)提供其他非ECMA 402定义的国际化接口，与本模块共同使用可提供完整地国际化支持能力。
> **说明：** > **说明：**
> - 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> >
> - Intl模块包含国际化能力基础接口（在ECMA 402中定义），包括时间日期格式化、数字格式化、排序等，国际化增强能力请参考[I18N模块](js-apis-i18n.md)。 > - Intl模块包含国际化能力基础接口（在ECMA 402中定义），包括时间日期格式化、数字格式化、排序等，国际化增强能力请参考[I18N模块](js-apis-i18n.md)。
## 导入模块 ## 导入模块
...@@ -21,9 +21,9 @@ import Intl from '@ohos.intl'; ...@@ -21,9 +21,9 @@ import Intl from '@ohos.intl';
### 属性 ### 属性
**系统能力**：以下各项对应的系统能力均为SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------- | ---- | ---- | ---------------------------------------- | | --------------- | ------- | ---- | ---- | ---------------------------------------- |
| language | string | 是 | 否 | 与区域设置关联的语， 如：zh。 | | language | string | 是 | 否 | 与区域设置关联的语， 如：zh。 |
| script | string | 是 | 否 | 语言的书写方式，如：Hans。 | | script | string | 是 | 否 | 语言的书写方式，如：Hans。 |
...@@ -61,9 +61,9 @@ constructor(locale: string, options?: LocaleOptions) ...@@ -61,9 +61,9 @@ constructor(locale: string, options?: LocaleOptions)
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------- | ---- | ---------------------------- | | -------------------- | -------------------------------- | ---- | ---------------------------- |
| locale | string | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | | locale | string | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [LocaleOptions](#localeoptions9) | 否 | 用于创建区域对象的选项。 | | options<sup>9+</sup> | [LocaleOptions](#localeoptions9) | 否 | 用于创建区域对象的选项。 |
**示例：** **示例：**
...@@ -141,7 +141,7 @@ minimize(): Locale ...@@ -141,7 +141,7 @@ minimize(): Locale
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------- | ---- | ---- | ---------------------------------------- | | --------------- | ------- | ---- | ---- | ---------------------------------------- |
| calendar | string | 是 | 是 | 日历参数，如："buddhist", "chinese", "coptic", "dangi", "ethioaa", "ethiopic", "gregory", "hebrew", "indian", "islamic", "islamic-umalqura", "islamic-tbla", "islamic-civil", "islamic-rgsa", "iso8601", "japanese", "persian", "roc", "islamicc"。 | | calendar | string | 是 | 是 | 日历参数，如："buddhist", "chinese", "coptic", "dangi", "ethioaa", "ethiopic", "gregory", "hebrew", "indian", "islamic", "islamic-umalqura", "islamic-tbla", "islamic-civil", "islamic-rgsa", "iso8601", "japanese", "persian", "roc", "islamicc"。 |
| collation | string | 是 | 是 | 排序参数，取值包括："big5han", "compat", "dict", "direct", "ducet", "emoji", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed ", "search", "searchjl", "standard", "stroke", "trad", "unihan", "zhuyin"。 | | collation | string | 是 | 是 | 排序参数，取值包括："big5han", "compat", "dict", "direct", "ducet", "emoji", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed ", "search", "searchjl", "standard", "stroke", "trad", "unihan", "zhuyin"。 |
...@@ -178,9 +178,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: DateTimeOptions) ...@@ -178,9 +178,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: DateTimeOptions)
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------------------------------- | ---- | ---------------------------- | | -------------------- | ------------------------------------ | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | | locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [DateTimeOptions](#datetimeoptions9) | 否 | 用于创建时间日期格式化的选项。 | | options<sup>9+</sup> | [DateTimeOptions](#datetimeoptions9) | 否 | 用于创建时间日期格式化的选项。 |
**示例：** **示例：**
...@@ -263,8 +263,8 @@ resolvedOptions(): DateTimeOptions ...@@ -263,8 +263,8 @@ resolvedOptions(): DateTimeOptions
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ----------------------------------- | ----------------------------- | | ------------------------------------ | ----------------------------- |
| [DateTimeOptions](#datetimeoptions9) | DateTimeFormat&nbsp;对象的格式化选项。 | | [DateTimeOptions](#datetimeoptions9) | DateTimeFormat&nbsp;对象的格式化选项。 |
**示例：** **示例：**
...@@ -280,7 +280,7 @@ resolvedOptions(): DateTimeOptions ...@@ -280,7 +280,7 @@ resolvedOptions(): DateTimeOptions
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------- | ---- | ---- | ---------------------------------------- | | --------------- | ------- | ---- | ---- | ---------------------------------------- |
| locale | string | 是 | 否 | 区域参数，&nbsp;如：zh-Hans-CN。 | | locale | string | 是 | 否 | 区域参数，&nbsp;如：zh-Hans-CN。 |
| dateStyle | string | 是 | 是 | 日期显示格式，取值包括："long",&nbsp;"short",&nbsp;"medium",&nbsp;"full"。 | | dateStyle | string | 是 | 是 | 日期显示格式，取值包括："long",&nbsp;"short",&nbsp;"medium",&nbsp;"full"。 |
...@@ -330,9 +330,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: NumberOptions) ...@@ -330,9 +330,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: NumberOptions)
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------- | ---- | ---------------------------- | | -------------------- | -------------------------------- | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | | locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [NumberOptions](#numberoptions9) | 否 | 用于创建数字格式化的选项。 | | options<sup>9+</sup> | [NumberOptions](#numberoptions9) | 否 | 用于创建数字格式化的选项。 |
**示例：** **示例：**
...@@ -379,8 +379,8 @@ resolvedOptions(): NumberOptions ...@@ -379,8 +379,8 @@ resolvedOptions(): NumberOptions
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------- | --------------------------- | | -------------------------------- | --------------------------- |
| [NumberOptions](#numberoptions9) | NumberFormat&nbsp;对象的格式化选项。 | | [NumberOptions](#numberoptions9) | NumberFormat&nbsp;对象的格式化选项。 |
...@@ -395,9 +395,9 @@ resolvedOptions(): NumberOptions ...@@ -395,9 +395,9 @@ resolvedOptions(): NumberOptions
表示设备支持的能力。 表示设备支持的能力。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------ | ------- | ---- | ---- | ---------------------------------------- | | ------------------------ | ------- | ---- | ---- | ---------------------------------------- |
| locale | string | 是 | 否 | 区域参数，&nbsp;如："zh-Hans-CN"。 | | locale | string | 是 | 否 | 区域参数，&nbsp;如："zh-Hans-CN"。 |
| currency | string | 是 | 是 | 货币单位，&nbsp;如："EUR"，"CNY"，"USD"等。 | | currency | string | 是 | 是 | 货币单位，&nbsp;如："EUR"，"CNY"，"USD"等。 |
...@@ -447,9 +447,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: CollatorOptions) ...@@ -447,9 +447,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: CollatorOptions)
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------------------------------- | ---- | ---------------------------- | | -------------------- | ------------------------------------ | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | | locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [CollatorOptions](#collatoroptions9) | 否 | 用于创建排序对象的选项。 | | options<sup>9+</sup> | [CollatorOptions](#collatoroptions9) | 否 | 用于创建排序对象的选项。 |
**示例：** **示例：**
...@@ -496,8 +496,8 @@ resolvedOptions(): CollatorOptions ...@@ -496,8 +496,8 @@ resolvedOptions(): CollatorOptions
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ----------------------------------- | ----------------- | | ------------------------------------ | ----------------- |
| [CollatorOptions](#collatoroptions9) | 返回的Collator对象的属性。 | | [CollatorOptions](#collatoroptions9) | 返回的Collator对象的属性。 |
**示例：** **示例：**
...@@ -513,7 +513,7 @@ resolvedOptions(): CollatorOptions ...@@ -513,7 +513,7 @@ resolvedOptions(): CollatorOptions
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------- | ------- | ---- | ---- | ---------------------------------------- | | ----------------- | ------- | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法，取值范围："best&nbsp;fit",&nbsp;"lookup"。 | | localeMatcher | string | 是 | 是 | locale匹配算法，取值范围："best&nbsp;fit",&nbsp;"lookup"。 |
| usage | string | 是 | 是 | 比较的用途，取值范围："sort",&nbsp;"search"。 | | usage | string | 是 | 是 | 比较的用途，取值范围："sort",&nbsp;"search"。 |
...@@ -551,9 +551,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: PluralRulesOptions) ...@@ -551,9 +551,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: PluralRulesOptions)
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ---------------------------------------- | ---- | ---------------------------- | | -------------------- | ---------------------------------------- | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | | locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [PluralRulesOptions](#pluralrulesoptions9) | 否 | 用于创建单复数对象的选项。 | | options<sup>9+</sup> | [PluralRulesOptions](#pluralrulesoptions9) | 否 | 用于创建单复数对象的选项。 |
**示例：** **示例：**
...@@ -595,7 +595,7 @@ select(n: number): string ...@@ -595,7 +595,7 @@ select(n: number): string
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------ | ------ | ---- | ---- | ---------------------------------------- | | ------------------------ | ------ | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法，取值包括："best&nbsp;fit",&nbsp;"lookup"。 | | localeMatcher | string | 是 | 是 | locale匹配算法，取值包括："best&nbsp;fit",&nbsp;"lookup"。 |
| type | string | 是 | 是 | 排序的类型，取值包括："cardinal",&nbsp;"ordinal"。 | | type | string | 是 | 是 | 排序的类型，取值包括："cardinal",&nbsp;"ordinal"。 |
...@@ -633,9 +633,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: RelativeTimeFormatIn ...@@ -633,9 +633,9 @@ constructor(locale: string | Array&lt;string&gt;, options?: RelativeTimeFormatIn
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ---------------------------------------- | ---- | ---------------------------- | | -------------------- | ---------------------------------------- | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | | locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [RelativeTimeFormatInputOptions](#relativetimeformatinputoptions9) | 否 | 用于创建相对时间格式化对象的选项。 | | options<sup>9+</sup> | [RelativeTimeFormatInputOptions](#relativetimeformatinputoptions9) | 否 | 用于创建相对时间格式化对象的选项。 |
**示例：** **示例：**
...@@ -727,7 +727,7 @@ resolvedOptions(): RelativeTimeFormatResolvedOptions ...@@ -727,7 +727,7 @@ resolvedOptions(): RelativeTimeFormatResolvedOptions
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------- | ------ | ---- | ---- | ---------------------------------------- | | ------------- | ------ | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法，取值包括："best&nbsp;fit",&nbsp;"lookup"。 | | localeMatcher | string | 是 | 是 | locale匹配算法，取值包括："best&nbsp;fit",&nbsp;"lookup"。 |
| numeric | string | 是 | 是 | 输出消息的格式，取值包括："always",&nbsp;"auto"。 | | numeric | string | 是 | 是 | 输出消息的格式，取值包括："always",&nbsp;"auto"。 |
...@@ -740,7 +740,7 @@ resolvedOptions(): RelativeTimeFormatResolvedOptions ...@@ -740,7 +740,7 @@ resolvedOptions(): RelativeTimeFormatResolvedOptions
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------ | ---- | ---- | ---------------------------------------- | | --------------- | ------ | ---- | ---- | ---------------------------------------- |
| locale | string | 是 | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | | locale | string | 是 | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 |
| numeric | string | 是 | 是 | 输出消息的格式，取值包括："always",&nbsp;"auto"。 | | numeric | string | 是 | 是 | 输出消息的格式，取值包括："always",&nbsp;"auto"。 |
......
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md
浏览文件 @ c80db68e
# Web # Web
提供具有网页显示能力的Web组件。
> **说明：** > **说明：**
> >
> - 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 > - 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
> - 示例效果请以真机运行为准，当前IDE预览器不支持。 > - 示例效果请以真机运行为准，当前IDE预览器不支持。
提供具有网页显示能力的Web组件。
## 需要权限 ## 需要权限
访问在线网页时需添加网络权限：ohos.permission.INTERNET，具体申请方式请参考[权限申请声明](../../security/accesstoken-guidelines.md)。 访问在线网页时需添加网络权限：ohos.permission.INTERNET，具体申请方式请参考[权限申请声明](../../security/accesstoken-guidelines.md)。
...@@ -27,7 +27,7 @@ Web(options: { src: ResourceStr, controller: WebController | WebviewController}) ...@@ -27,7 +27,7 @@ Web(options: { src: ResourceStr, controller: WebController | WebviewController})
| 参数名 | 参数类型 | 必填 | 参数描述 | | 参数名 | 参数类型 | 必填 | 参数描述 |
| ---------- | ---------------------------------------- | ---- | ------- | | ---------- | ---------------------------------------- | ---- | ------- |
| src | [ResourceStr](ts-types.md) | 是 | 网页资源地址。 | | src | [ResourceStr](ts-types.md) | 是 | 网页资源地址。 |
| controller | [WebController](#webcontroller) 或 [WebviewController](../apis/js-apis-webview.md#webviewcontroller) | 是 | 控制器。 | | controller | [WebController](#webcontroller) \| [WebviewController<sup>9+</sup>](../apis/js-apis-webview.md#webviewcontroller) | 是 | 控制器。 |
**示例：** **示例：**
...@@ -88,7 +88,7 @@ Web(options: { src: ResourceStr, controller: WebController | WebviewController}) ...@@ -88,7 +88,7 @@ Web(options: { src: ResourceStr, controller: WebController | WebviewController})
## 属性 ## 属性
web组件的网络属性。 通用属性仅支持[width](ts-universal-attributes-size.md#属性)、[height](ts-universal-attributes-size.md#属性)、[padding](ts-universal-attributes-size.md#属性)、[margin](ts-universal-attributes-size.md#属性)、[border](ts-universal-attributes-border.md#属性)。
### domStorageAccess ### domStorageAccess
...@@ -672,10 +672,6 @@ webDebuggingAccess(webDebuggingAccess: boolean) ...@@ -672,10 +672,6 @@ webDebuggingAccess(webDebuggingAccess: boolean)
} }
``` ```
> **说明：**
>
> 通用属性仅支持[width](ts-universal-attributes-size.md#属性)、[height](ts-universal-attributes-size.md#属性)、[padding](ts-universal-attributes-size.md#属性)、[margin](ts-universal-attributes-size.md#属性)、[border](ts-universal-attributes-border.md#属性)。
## 事件 ## 事件
不支持通用事件。 不支持通用事件。
......
zh-cn/application-dev/reference/arkui-ts/ts-state-management.md
浏览文件 @ c80db68e
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
状态管理模块提供了应用程序的数据存储能力、持久化数据管理能力、Ability数据存储能力和应用程序需要的环境状态，其中Ability数据存储从API version9开始支持。 状态管理模块提供了应用程序的数据存储能力、持久化数据管理能力、Ability数据存储能力和应用程序需要的环境状态，其中Ability数据存储从API version9开始支持。
> **说明：** > **说明：**
> >
> 本模块首批接口从API version 7开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。
## AppStorage ## AppStorage
...@@ -16,14 +16,14 @@ Link(propName: string): any ...@@ -16,14 +16,14 @@ Link(propName: string): any
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | --------------------- | | -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要双向绑定的属性名称。 | | propName | string | 是 | 要双向绑定的属性名称。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ----- | ------------------------------------------------------------ | | ----- | ---------------------------------------- |
| @Link | 在具有给定键的数据，则返回到此属性的双向数据绑定，该双向绑定意味着变量或者组件对数据的更改将同步到AppStorage，通过AppStorage对数据的修改将同步到变量或者组件。 | | @Link | 在具有给定键的数据，则返回到此属性的双向数据绑定，该双向绑定意味着变量或者组件对数据的更改将同步到AppStorage，通过AppStorage对数据的修改将同步到变量或者组件。 |
```ts ```ts
...@@ -38,15 +38,15 @@ SetAndLink\<T>(propName: string, defaultValue: T): SubscribedAbstractProperty\<T ...@@ -38,15 +38,15 @@ SetAndLink\<T>(propName: string, defaultValue: T): SubscribedAbstractProperty\<T
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | -------------------- | | ------------ | ------ | ---- | ----------- |
| propName | string | 是 | 要进行创建的key值。 | | propName | string | 是 | 要进行创建的key值。 |
| defaultValue | T | 是 | 要进行设置的默认值。 | | defaultValue | T | 是 | 要进行设置的默认值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ----- | ------------------------------------------------------------ | | ----- | ---------------------------------------- |
| @Link | 与Link接口类似，如果当前的key保存于AppStorage，返回该key值对应的value值。如果该key值未被创建，则创建一个对应的defaultValue的Link返回。 | | @Link | 与Link接口类似，如果当前的key保存于AppStorage，返回该key值对应的value值。如果该key值未被创建，则创建一个对应的defaultValue的Link返回。 |
```ts ```ts
...@@ -61,14 +61,14 @@ Prop(propName: string): any ...@@ -61,14 +61,14 @@ Prop(propName: string): any
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ------------------- | | -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要进行创建的key值。 | | propName | string | 是 | 要进行创建的key值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ----- | ------------------------------------------------------------ | | ----- | ---------------------------------------- |
| @Prop | 如果存在具有给定键的属性，则返回此属性的单向数据绑定。该单向绑定意味着只能通过AppStorage将属性的更改同步到变量或者组件。该方法返回的变量为不可变变量，适用于可变和不可变的状态属性，如果具有此键的属性不存在则返回undefined。 | | @Prop | 如果存在具有给定键的属性，则返回此属性的单向数据绑定。该单向绑定意味着只能通过AppStorage将属性的更改同步到变量或者组件。该方法返回的变量为不可变变量，适用于可变和不可变的状态属性，如果具有此键的属性不存在则返回undefined。 |
```ts ```ts
...@@ -83,15 +83,15 @@ SetAndProp\<S>(propName: string, defaultValue: S): SubscribedAbstractProperty\<S ...@@ -83,15 +83,15 @@ SetAndProp\<S>(propName: string, defaultValue: S): SubscribedAbstractProperty\<S
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | --------------------------- | | ------------ | ------ | ---- | --------------- |
| propName | string | 是 | 要保存的的键值对中的key值。 | | propName | string | 是 | 要保存的的键值对中的key值。 |
| defaultValue | S | 是 | 创建的默认值。 | | defaultValue | S | 是 | 创建的默认值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ----- | ------------------------------------------------------------ | | ----- | ---------------------------------------- |
| @Prop | 如果当前的key保存与AppStorage，返回该key值对应的value值。如果该key值未被创建，则创建一个对应的defaultValue的Prop返回。 | | @Prop | 如果当前的key保存与AppStorage，返回该key值对应的value值。如果该key值未被创建，则创建一个对应的defaultValue的Prop返回。 |
```ts ```ts
...@@ -106,14 +106,14 @@ Has(propName: string): boolean ...@@ -106,14 +106,14 @@ Has(propName: string): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | -------------- | | -------- | ------ | ---- | ------- |
| propName | string | 是 | 属性的属性值。 | | propName | string | 是 | 属性的属性值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | -------------------------- | | ------- | ------------- |
| boolean | 返回属性的属性值是否存在。 | | boolean | 返回属性的属性值是否存在。 |
```ts ```ts
...@@ -128,14 +128,14 @@ Get\<T>(propName: string): T | undefined ...@@ -128,14 +128,14 @@ Get\<T>(propName: string): T | undefined
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | ---- | ------------------- | | -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要获取对应的key值。 | | propName | string | 是 | 要获取对应的key值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------------------ | -------------------------- | | ----------------- | ------------- |
| boolean或undefined | 返回属性的属性值是否存在。 | | boolean或undefined | 返回属性的属性值是否存在。 |
```ts ```ts
...@@ -150,15 +150,15 @@ Set\<T>(propName: string, newValue: T): boolean ...@@ -150,15 +150,15 @@ Set\<T>(propName: string, newValue: T): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ----------------- | | -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要设置的key值。 | | propName | string | 是 | 要设置的key值。 |
| newValue | T | 是 | 要设置的value值。 | | newValue | T | 是 | 要设置的value值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ----------------------------------------------------- | | ------- | ----------------------------------- |
| boolean | 如果存在key值，设置value值并返回true，否则返回false。 | | boolean | 如果存在key值，设置value值并返回true，否则返回false。 |
```ts ```ts
...@@ -173,15 +173,15 @@ SetOrCreate\<T>(propName: string, newValue: T): void ...@@ -173,15 +173,15 @@ SetOrCreate\<T>(propName: string, newValue: T): void
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ------------------------- | | -------- | ------ | ---- | --------------- |
| propName | string | 是 | 要更新或者创建的key值。 | | propName | string | 是 | 要更新或者创建的key值。 |
| newValue | T | 是 | 要更新或者创建的value值。 | | newValue | T | 是 | 要更新或者创建的value值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ------------------------------------------------------------ | | ------- | ---------------------------------------- |
| boolean | 如果已存在与给定键名字相同的属性，更新其值且返回true。如果不存在具有给定名称的属性，在AppStorage中创建具有给定默认值的新属性，默认值必须是T类型。不允许undefined 或 null 返回true。 | | boolean | 如果已存在与给定键名字相同的属性，更新其值且返回true。如果不存在具有给定名称的属性，在AppStorage中创建具有给定默认值的新属性，默认值必须是T类型。不允许undefined 或 null 返回true。 |
```ts ```ts
...@@ -196,14 +196,14 @@ Delete(propName: string): boolean ...@@ -196,14 +196,14 @@ Delete(propName: string): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | --------------------- | | -------- | ------ | ---- | ------------ |
| propName | string | 是 | 要删除的属性的key值。 | | propName | string | 是 | 要删除的属性的key值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ------------------------------------------------------------ | | ------- | ---------------------------------------- |
| boolean | 删除key指定的键值对，如果存在且删除成功返回true，不存在或删除失败返回false。 | | boolean | 删除key指定的键值对，如果存在且删除成功返回true，不存在或删除失败返回false。 |
```ts ```ts
...@@ -218,8 +218,8 @@ keys(): IterableIterator\<string> ...@@ -218,8 +218,8 @@ keys(): IterableIterator\<string>
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| -------------- | ---------------------------- | | -------------- | -------------- |
| array\<string> | 返回包含所有键的字符串数组。 | | array\<string> | 返回包含所有键的字符串数组。 |
```ts ```ts
...@@ -232,19 +232,19 @@ staticClear(): boolean ...@@ -232,19 +232,19 @@ staticClear(): boolean
删除所有的属性。 删除所有的属性。
**该属性在api9上已废弃，使用Clear属性替代** 从API version 9开始废弃，推荐使用[Clear](#clear)。
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ------------------------------------------------------------ | | ------- | --------------------------------- |
| boolean | 删除所有的属性，如果当前有状态变量依旧引用此属性，返回false。 | | boolean | 删除所有的属性，如果当前有状态变量依旧引用此属性，返回false。 |
```ts ```ts
let simple = AppStorage.staticClear() let simple = AppStorage.staticClear()
``` ```
### Clear ### Clear<sup>9+</sup>
Clear(): boolean Clear(): boolean
...@@ -252,8 +252,8 @@ Clear(): boolean ...@@ -252,8 +252,8 @@ Clear(): boolean
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ------------------------------------------------------------ | | ------- | --------------------------------- |
| boolean | 删除所有的属性，如果当前有状态变量依旧引用此属性，返回false。 | | boolean | 删除所有的属性，如果当前有状态变量依旧引用此属性，返回false。 |
```typescript ```typescript
...@@ -268,14 +268,14 @@ IsMutable(propName: string): boolean ...@@ -268,14 +268,14 @@ IsMutable(propName: string): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | :--- | --------------------- | | -------- | ------ | :--- | ------------ |
| propName | string | 是 | 要查询的属性的key值。 | | propName | string | 是 | 要查询的属性的key值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ------------------------------------ | | ------- | ------------------ |
| boolean | 返回此属性是否存在并且是否可以改变。 | | boolean | 返回此属性是否存在并且是否可以改变。 |
```ts ```ts
...@@ -290,8 +290,8 @@ Size(): number ...@@ -290,8 +290,8 @@ Size(): number
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------ | ------------------ | | ------ | --------- |
| number | 返回键值对的数量。 | | number | 返回键值对的数量。 |
```ts ```ts
...@@ -308,9 +308,9 @@ constructor(initializingProperties?: Object) ...@@ -308,9 +308,9 @@ constructor(initializingProperties?: Object)
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ---------------------- | ------ | ---- | ------------------------------------------------------------ | | ---------------------- | ------ | ---- | ---------------------------------------- |
| initializingProperties | Object | 否 | object.keys(obj)返回的所有对象属性及其值都将添加到LocalStorage。 | | initializingProperties | Object | 否 | object.keys(obj)返回的所有对象属性及其值都将添加到LocalStorage。 |
```ts ```ts
this.storage = new LocalStorage() this.storage = new LocalStorage()
...@@ -326,8 +326,8 @@ static GetShared(): LocalStorage ...@@ -326,8 +326,8 @@ static GetShared(): LocalStorage
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ----------------------------- | ---------------------- | | ----------------------------- | ----------------- |
| [LocalStorage](#localstorage) | 返回LocalStorage对象。 | | [LocalStorage](#localstorage) | 返回LocalStorage对象。 |
```ts ```ts
...@@ -342,14 +342,14 @@ has(propName: string): boolean ...@@ -342,14 +342,14 @@ has(propName: string): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | -------------- | | -------- | ------ | ---- | ------- |
| propName | string | 是 | 属性的属性值。 | | propName | string | 是 | 属性的属性值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | -------------------------- | | ------- | ------------- |
| boolean | 返回属性的属性值是否存在。 | | boolean | 返回属性的属性值是否存在。 |
```ts ```ts
...@@ -365,14 +365,14 @@ get\<T>(propName: string): T ...@@ -365,14 +365,14 @@ get\<T>(propName: string): T
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ------------------- | | -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要获取对应的key值。 | | propName | string | 是 | 要获取对应的key值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| -------------- | ------------------------------------------------------- | | -------------- | ---------------------------------------- |
| T \| undefined | 当keyvalue存在时，返回keyvalue值。不存在返回undefined。 | | T \| undefined | 当keyvalue存在时，返回keyvalue值。不存在返回undefined。 |
```ts ```ts
...@@ -388,15 +388,15 @@ set\<T>(propName: string, newValue: T): boolean ...@@ -388,15 +388,15 @@ set\<T>(propName: string, newValue: T): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ----------------- | | -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要设置的key值。 | | propName | string | 是 | 要设置的key值。 |
| newValue | T | 是 | 要设置的value值。 | | newValue | T | 是 | 要设置的value值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ----------------------------------------------------- | | ------- | ----------------------------------- |
| boolean | 如果存在key值，设置value值并返回true，否则返回false。 | | boolean | 如果存在key值，设置value值并返回true，否则返回false。 |
```ts ```ts
...@@ -412,15 +412,15 @@ setOrCreate\<T>(propName: string, newValue: T): boolean ...@@ -412,15 +412,15 @@ setOrCreate\<T>(propName: string, newValue: T): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | :--- | ----------------------- | | -------- | ------ | :--- | -------------- |
| propName | string | 是 | 要更新或创建的key值。 | | propName | string | 是 | 要更新或创建的key值。 |
| newValue | T | 是 | 要更新或创建的value值。 | | newValue | T | 是 | 要更新或创建的value值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ------------------------------------------------------------ | | ------- | ---------------------------------------- |
| boolean | 如果已存在与给定键名字相同的属性，更新其值且返回true。如果不存在具有给定名称的属性，在LocalStorage中创建具有给定默认值的新属性，默认值必须是T类型，不允许undefined 或 null 。 | | boolean | 如果已存在与给定键名字相同的属性，更新其值且返回true。如果不存在具有给定名称的属性，在LocalStorage中创建具有给定默认值的新属性，默认值必须是T类型，不允许undefined 或 null 。 |
```ts ```ts
...@@ -436,14 +436,14 @@ link\<T>(propName: string): T ...@@ -436,14 +436,14 @@ link\<T>(propName: string): T
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ---------------------- | | -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要双向绑定的属性名称。 | | propName | string | 是 | 要双向绑定的属性名称。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ---- | ------------------------------------------------------------ | | ---- | ---------------------------------------- |
| T | 如果存在具有给定键的属性，返回到此属性的双向绑定，该双向绑定意味着变量或者组件对数据的更改将同步到LocalStorage，然后通过LocalStorage实例同步到任何变量或组件。如果不存在给定键的属性，返回undefined。 | | T | 如果存在具有给定键的属性，返回到此属性的双向绑定，该双向绑定意味着变量或者组件对数据的更改将同步到LocalStorage，然后通过LocalStorage实例同步到任何变量或组件。如果不存在给定键的属性，返回undefined。 |
```ts ```ts
...@@ -459,15 +459,15 @@ setAndLink\<T>(propName: string, defaultValue: T): T ...@@ -459,15 +459,15 @@ setAndLink\<T>(propName: string, defaultValue: T): T
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | -------------------- | | ------------ | ------ | ---- | ----------- |
| propName | string | 是 | 要进行创建的key值。 | | propName | string | 是 | 要进行创建的key值。 |
| defaultValue | T | 是 | 要进行设置的默认值。 | | defaultValue | T | 是 | 要进行设置的默认值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------------------------------------ | ------------------------------------------------------------ | | ----- | ---------------------------------------- |
| @Link | 与Link接口类似，如果当前的key保存于LocalStorage，返回该key值对应的value值。如果该key值未被创建，则创建一个对应的defaultValue的Link返回。 | | @Link | 与Link接口类似，如果当前的key保存于LocalStorage，返回该key值对应的value值。如果该key值未被创建，则创建一个对应的defaultValue的Link返回。 |
```ts ```ts
...@@ -483,14 +483,14 @@ prop\<T>(propName: string): T ...@@ -483,14 +483,14 @@ prop\<T>(propName: string): T
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ----------------------- | | -------- | ------ | ---- | ------------- |
| propName | string | 是 | 要单向数据绑定的key值。 | | propName | string | 是 | 要单向数据绑定的key值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------------------------------------ | ------------------------------------------------------------ | | ----- | ---------------------------------------- |
| @Prop | 如果存在具有给定键的属性，返回此属性的单向数据绑定。该单向绑定意味着只能通过LocalStorage将属性的更改同步到变量或组件。该方法返回的变量为不可变变量，适用于可变和不可变的状态变量。如果此键的属性不存在则返回undefined。 | | @Prop | 如果存在具有给定键的属性，返回此属性的单向数据绑定。该单向绑定意味着只能通过LocalStorage将属性的更改同步到变量或组件。该方法返回的变量为不可变变量，适用于可变和不可变的状态变量。如果此键的属性不存在则返回undefined。 |
```ts ```ts
...@@ -506,15 +506,15 @@ setAndProp\<T>(propName: string, defaultValue: T): T ...@@ -506,15 +506,15 @@ setAndProp\<T>(propName: string, defaultValue: T): T
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | ------------------------- | | ------------ | ------ | ---- | -------------- |
| propName | string | 是 | 要保存的键值对中的key值。 | | propName | string | 是 | 要保存的键值对中的key值。 |
| defaultValue | T | 是 | 创建的默认值。 | | defaultValue | T | 是 | 创建的默认值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------------------------------------ | ------------------------------------------------------------ | | ----- | ---------------------------------------- |
| @Prop | 如果当前的key保存与LocalStorage，返回该key值对应的value值。如果该key值未被创建，则创建一个对应的defaultValue的Prop返回。 | | @Prop | 如果当前的key保存与LocalStorage，返回该key值对应的value值。如果该key值未被创建，则创建一个对应的defaultValue的Prop返回。 |
```ts ```ts
...@@ -530,14 +530,14 @@ delete(propName: string): boolean ...@@ -530,14 +530,14 @@ delete(propName: string): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | :--- | --------------------- | | -------- | ------ | :--- | ------------ |
| propName | string | 是 | 要删除的属性的key值。 | | propName | string | 是 | 要删除的属性的key值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ------------------------------------------------------------ | | ------- | ---------------------------------------- |
| boolean | 删除key指定的键值对。存在且删除成功，返回true。不存在、删除失败或有状态变量依旧引用propName，返回false。 | | boolean | 删除key指定的键值对。存在且删除成功，返回true。不存在、删除失败或有状态变量依旧引用propName，返回false。 |
```ts ```ts
...@@ -553,8 +553,8 @@ keys(): IterableIterator\<string> ...@@ -553,8 +553,8 @@ keys(): IterableIterator\<string>
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| -------------- | -------------------------------------- | | -------------- | ------------------- |
| array\<string> | 返回包含所有键不可序列化的字符串数组。 | | array\<string> | 返回包含所有键不可序列化的字符串数组。 |
```ts ```ts
...@@ -570,8 +570,8 @@ size(): number ...@@ -570,8 +570,8 @@ size(): number
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------ | ------------------ | | ------ | --------- |
| number | 返回键值对的数量。 | | number | 返回键值对的数量。 |
```ts ```ts
...@@ -587,8 +587,8 @@ clear(): boolean ...@@ -587,8 +587,8 @@ clear(): boolean
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ------------------------------------------------------------ | | ------- | --------------------------------- |
| boolean | 删除所有的属性，如果当前有状态变量依旧引用此属性，返回false。 | | boolean | 删除所有的属性，如果当前有状态变量依旧引用此属性，返回false。 |
```ts ```ts
...@@ -606,10 +606,10 @@ constructor(appStorage: AppStorage, storage: Storage) ...@@ -606,10 +606,10 @@ constructor(appStorage: AppStorage, storage: Storage)
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ---------- | ---------- | --- | -------------------------------- | | ---------- | ---------- | ---- | ---------------- |
| appStorage | AppStorage | 是 | 保存所有属性及属性值的单例对象。 | | appStorage | AppStorage | 是 | 保存所有属性及属性值的单例对象。 |
| storage | Storage | 是 | Storage实例对象。 | | storage | Storage | 是 | Storage实例对象。 |
```ts ```ts
this.persistentstorage = new PersistentStorage(AppStorage,Storage) this.persistentstorage = new PersistentStorage(AppStorage,Storage)
...@@ -623,10 +623,10 @@ PersistProp(key:string,defaultValue:T): void ...@@ -623,10 +623,10 @@ PersistProp(key:string,defaultValue:T): void
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | ----------------------- | | ------------ | ------ | ---- | -------------- |
| key | string | 是 | 要关联的属性的key值。 | | key | string | 是 | 要关联的属性的key值。 |
| defaultValue | T | 是 | 要关联的属性的value值。 | | defaultValue | T | 是 | 要关联的属性的value值。 |
```ts ```ts
PersistentStorage.PersistProp('highScore', '0') PersistentStorage.PersistProp('highScore', '0')
...@@ -640,9 +640,9 @@ DeleteProp(key: string): void ...@@ -640,9 +640,9 @@ DeleteProp(key: string): void
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ------ | ------ | --- | --------------------- | | ---- | ------ | ---- | ------------ |
| key | string | 是 | 要取消的属性的key值。 | | key | string | 是 | 要取消的属性的key值。 |
```ts ```ts
PersistentStorage.DeleteProp('highScore') PersistentStorage.DeleteProp('highScore')
...@@ -656,9 +656,9 @@ PersistProps(properties: {key: string, defaultValue: any}[]): void; ...@@ -656,9 +656,9 @@ PersistProps(properties: {key: string, defaultValue: any}[]): void;
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 |
| ------ | ---------------------------------- | -- | ------------------ | | ---- | ---------------------------------- | ---- | --------- |
| key | {key: string, defaultValue: any}[] | 是 | 要关联的属性数组。 | | key | {key: string, defaultValue: any}[] | 是 | 要关联的属性数组。 |
```ts ```ts
PersistentStorage.PersistProps([{key: 'highScore', defaultValue: '0'},{key: 'wightScore',defaultValue: '1'}]) PersistentStorage.PersistProps([{key: 'highScore', defaultValue: '0'},{key: 'wightScore',defaultValue: '1'}])
...@@ -672,8 +672,8 @@ Keys(): Array\<string> ...@@ -672,8 +672,8 @@ Keys(): Array\<string>
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------------- | -------------------------- | | -------------- | ------------- |
| Array\<string> | 返回所有持久化属性的标记。 | | Array\<string> | 返回所有持久化属性的标记。 |
```ts ```ts
...@@ -704,27 +704,27 @@ EnvProp\<S>(key: string, value: S): boolean ...@@ -704,27 +704,27 @@ EnvProp\<S>(key: string, value: S): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 | 参数描述 |
| ------ | ------ | --- | --------------- | ----------------- | | ----- | ------ | ---- | ---------- | ------------------------- |
| key | string | 是 | 要关联的key值 | 要关联的key值，支持的范围详见内置环境变量说明。 | | key | string | 是 | 要关联的key值 | 要关联的key值，支持的范围详见内置环境变量说明。 |
| value | S | 是 | 要关联的value值 | 要关联的value值。 | | value | S | 是 | 要关联的value值 | 要关联的value值。 |
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------- | ---------------------------------- | | ------- | ---------------------- |
| boolean | 返回该属性在AppStorage中是否存在。 | | boolean | 返回该属性在AppStorage中是否存在。 |
**内置环境变量说明：** **内置环境变量说明：**
| key | 类型 | 说明 | | key | 类型 | 说明 |
| ------------ | ------------- | ------------------- | | -------------------- | --------------- | ---------------------------------------- |
| accessibilityEnabled | string | 无障碍屏幕朗读是否启用。 | | accessibilityEnabled | string | 无障碍屏幕朗读是否启用。 |
| colorMode | ColorMode | 深浅色模式，可选值为：<br>- ColorMode.LIGHT：浅色模式；<br>- ColorMode.DARK：深色模式。 | | colorMode | ColorMode | 深浅色模式，可选值为：<br>- ColorMode.LIGHT：浅色模式；<br>- ColorMode.DARK：深色模式。 |
| fontScale | number | 字体大小比例。 | | fontScale | number | 字体大小比例。 |
| fontWeightScale | number | 字重比例。 | | fontWeightScale | number | 字重比例。 |
| layoutDirection | LayoutDirection | 布局方向类型，可选值为：<br>- LayoutDirection.LTR：从左到右；<br>- LayoutDirection.RTL：从右到左。 | | layoutDirection | LayoutDirection | 布局方向类型，可选值为：<br>- LayoutDirection.LTR：从左到右；<br>- LayoutDirection.RTL：从右到左。 |
| languageCode | string | 当前系统语言，小写字母，例如zh。 | | languageCode | string | 当前系统语言，小写字母，例如zh。 |
```ts ```ts
Environment.EnvProp('accessibilityEnabled', 'default') Environment.EnvProp('accessibilityEnabled', 'default')
...@@ -738,9 +738,9 @@ EnvProps(props: {key: string, defaultValue: any}[]): void ...@@ -738,9 +738,9 @@ EnvProps(props: {key: string, defaultValue: any}[]): void
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 参数描述 | 参数描述 | | 参数名 | 类型 | 必填 | 参数描述 | 参数描述 |
| ------ | ---------------------------------- | --- | ------------------ | ------------------ | | ---- | ---------------------------------- | ---- | --------- | --------- |
| key | {key: string, defaultValue: any}[] | 是 | 要关联的属性数组。 | 要关联的属性数组。 | | key | {key: string, defaultValue: any}[] | 是 | 要关联的属性数组。 | 要关联的属性数组。 |
```ts ```ts
Environment.EnvProps([{key: 'accessibilityEnabled', defaultValue: 'default'},{key: 'accessibilityUnEnabled', defaultValue: 'undefault'}]) Environment.EnvProps([{key: 'accessibilityEnabled', defaultValue: 'default'},{key: 'accessibilityUnEnabled', defaultValue: 'undefault'}])
...@@ -754,8 +754,8 @@ Keys(): Array\<string> ...@@ -754,8 +754,8 @@ Keys(): Array\<string>
**返回值：** **返回值：**
| 类型 | 描述 | | 类型 | 描述 |
| ------------- | ---------------------- | | -------------- | ----------- |
| Array\<string> | 返回关联的系统项数组。 | | Array\<string> | 返回关联的系统项数组。 |
```ts ```ts
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或