未验证 提交 c80db68e 编写于 作者: O openharmony_ci 提交者: Gitee

!12062 格式修改

Merge pull request !12062 from LiAn/master
......@@ -45,7 +45,7 @@ static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -84,7 +84,7 @@ static getDisplayLanguage(language: string, locale: string, sentenceCase?: boole
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -115,7 +115,7 @@ static getSystemLanguages(): Array<string>
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -137,9 +137,9 @@ static getSystemCountries(language: string): Array<string>
**参数:**
| 参数名 | 类型 | 说明 |
| -------- | ------ | ----- |
| language | string | 语言ID。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ----- |
| language | string | 是 | 语言ID。 |
**返回值:**
......@@ -152,7 +152,7 @@ static getSystemCountries(language: string): Array<string>
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -190,7 +190,7 @@ static isSuggested(language: string, region?: string): boolean
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -221,7 +221,7 @@ static getSystemLanguage(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -247,16 +247,16 @@ static setSystemLanguage(language: string): void
**参数:**
| 参数名 | 类型 | 说明 |
| -------- | ------ | ----- |
| language | string | 语言ID。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ----- |
| language | string | 是 | 语言ID。 |
**错误码:**
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -287,7 +287,7 @@ static getSystemRegion(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -313,16 +313,16 @@ static setSystemRegion(region: string): void
**参数:**
| 参数名 | 类型 | 说明 |
| ------ | ------ | ----- |
| region | string | 地区ID。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ----- |
| region | string | 是 | 地区ID。 |
**错误码:**
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -353,7 +353,7 @@ static getSystemLocale(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -379,16 +379,16 @@ static setSystemLocale(locale: string): void
**参数:**
| 参数名 | 类型 | 说明 |
| ------ | ------ | --------------- |
| locale | string | 指定区域ID,例如zh-CN。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | --------------- |
| locale | string | 是 | 指定区域ID,例如zh-CN。 |
**错误码:**
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -419,7 +419,7 @@ static is24HourClock(): boolean
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -454,7 +454,7 @@ static set24HourClock(option: boolean): void
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -491,7 +491,7 @@ static addPreferredLanguage(language: string, index?: number): void
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -529,7 +529,7 @@ static removePreferredLanguage(index: number): void
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -562,7 +562,7 @@ static getPreferredLanguageList(): Array<string>
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -593,7 +593,7 @@ static getFirstPreferredLanguage(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -624,7 +624,7 @@ static getAppPreferredLanguage(): string
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -659,7 +659,7 @@ static setUsingLocalDigit(flag: boolean): void
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -690,7 +690,7 @@ static getUsingLocalDigit(): boolean
以下错误码的详细介绍请参见[ohos.i18n错误码](../errorcodes/errorcode-i18n.md)
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| ------ | ---------------------- |
| 890001 | Unspported para value. |
**示例:**
......@@ -713,9 +713,9 @@ isRTL(locale: string): boolean
**参数:**
| 参数名 | 类型 | 说明 |
| ------ | ------ | ------- |
| locale | string | 指定区域ID。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| locale | string | 是 | 指定区域ID。 |
**返回值:**
......@@ -905,7 +905,7 @@ setFirstDayOfWeek(value: number): void
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ------ | ---- | --------------------- |
| value | number | | 设置一周的起始日,1代表周日,7代表周六。 |
| value | number | | 设置一周的起始日,1代表周日,7代表周六。 |
**示例:**
```js
......@@ -947,7 +947,7 @@ setMinimalDaysInFirstWeek(value: number): void
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ------ | ---- | ------------ |
| value | number | | 一年中第一周的最小天数。 |
| value | number | | 一年中第一周的最小天数。 |
**示例:**
```js
......@@ -1153,7 +1153,7 @@ getLocationName(number: string, locale: string): string
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ---- | ------ | ---- | ---- | ---------------------------------------- |
| type | string | 是 | 是 | 表示对电话号码格式化的类型,取值范围:"E164", "INTERNATIONAL", "NATIONAL", "RFC3966"。 |
......@@ -1164,7 +1164,7 @@ getLocationName(number: string, locale: string): string
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------- | ------ | ---- | ---- | ---------------------------------------- |
| unit | string | 是 | 是 | 单位的名称,如:"meter", "inch", "cup"等。 |
| measureSystem | string | 是 | 是 | 单位的度量体系,取值包括:"SI", "US", "UK"。 |
......
......@@ -21,9 +21,9 @@ import Intl from '@ohos.intl';
### 属性
**系统能力**以下各项对应的系统能力均为SystemCapability.Global.I18n
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------- | ---- | ---- | ---------------------------------------- |
| language | string | 是 | 否 | 与区域设置关联的语, 如:zh。 |
| script | string | 是 | 否 | 语言的书写方式,如:Hans。 |
......@@ -62,7 +62,7 @@ constructor(locale: string, options?: LocaleOptions)
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------- | ---- | ---------------------------- |
| -------------------- | -------------------------------- | ---- | ---------------------------- |
| locale | string | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [LocaleOptions](#localeoptions9) | 否 | 用于创建区域对象的选项。 |
......@@ -141,7 +141,7 @@ minimize(): Locale
**系统能力**: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"。 |
| collation | string | 是 | 是 | 排序参数,取值包括:"big5han", "compat", "dict", "direct", "ducet", "emoji", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed ", "search", "searchjl", "standard", "stroke", "trad", "unihan", "zhuyin"。 |
......@@ -179,7 +179,7 @@ constructor(locale: string | Array&lt;string&gt;, options?: DateTimeOptions)
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------------------------------- | ---- | ---------------------------- |
| -------------------- | ------------------------------------ | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [DateTimeOptions](#datetimeoptions9) | 否 | 用于创建时间日期格式化的选项。 |
......@@ -264,7 +264,7 @@ resolvedOptions(): DateTimeOptions
**返回值:**
| 类型 | 说明 |
| ----------------------------------- | ----------------------------- |
| ------------------------------------ | ----------------------------- |
| [DateTimeOptions](#datetimeoptions9) | DateTimeFormat&nbsp;对象的格式化选项。 |
**示例:**
......@@ -280,7 +280,7 @@ resolvedOptions(): DateTimeOptions
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------- | ---- | ---- | ---------------------------------------- |
| locale | string | 是 | 否 | 区域参数,&nbsp;如:zh-Hans-CN。 |
| dateStyle | string | 是 | 是 | 日期显示格式,取值包括:"long",&nbsp;"short",&nbsp;"medium",&nbsp;"full"。 |
......@@ -331,7 +331,7 @@ constructor(locale: string | Array&lt;string&gt;, options?: NumberOptions)
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------- | ---- | ---------------------------- |
| -------------------- | -------------------------------- | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [NumberOptions](#numberoptions9) | 否 | 用于创建数字格式化的选项。 |
......@@ -380,7 +380,7 @@ resolvedOptions(): NumberOptions
**返回值:**
| 类型 | 说明 |
| ------------------------------- | --------------------------- |
| -------------------------------- | --------------------------- |
| [NumberOptions](#numberoptions9) | NumberFormat&nbsp;对象的格式化选项。 |
......@@ -395,9 +395,9 @@ resolvedOptions(): NumberOptions
表示设备支持的能力。
**系统能力**以下各项对应的系统能力均为SystemCapability.Global.I18n
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------ | ------- | ---- | ---- | ---------------------------------------- |
| locale | string | 是 | 否 | 区域参数,&nbsp;如:"zh-Hans-CN"。 |
| currency | string | 是 | 是 | 货币单位,&nbsp;如:"EUR","CNY","USD"等。 |
......@@ -448,7 +448,7 @@ constructor(locale: string | Array&lt;string&gt;, options?: CollatorOptions)
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------------------------------- | ---- | ---------------------------- |
| -------------------- | ------------------------------------ | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [CollatorOptions](#collatoroptions9) | 否 | 用于创建排序对象的选项。 |
......@@ -497,7 +497,7 @@ resolvedOptions(): CollatorOptions
**返回值:**
| 类型 | 说明 |
| ----------------------------------- | ----------------- |
| ------------------------------------ | ----------------- |
| [CollatorOptions](#collatoroptions9) | 返回的Collator对象的属性。 |
**示例:**
......@@ -513,7 +513,7 @@ resolvedOptions(): CollatorOptions
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------- | ------- | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法,取值范围:"best&nbsp;fit",&nbsp;"lookup"。 |
| usage | string | 是 | 是 | 比较的用途,取值范围:"sort",&nbsp;"search"。 |
......@@ -552,7 +552,7 @@ constructor(locale: string | Array&lt;string&gt;, options?: PluralRulesOptions)
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ---------------------------------------- | ---- | ---------------------------- |
| -------------------- | ---------------------------------------- | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [PluralRulesOptions](#pluralrulesoptions9) | 否 | 用于创建单复数对象的选项。 |
......@@ -595,7 +595,7 @@ select(n: number): string
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------ | ------ | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法,取值包括:"best&nbsp;fit",&nbsp;"lookup"。 |
| type | string | 是 | 是 | 排序的类型,取值包括:"cardinal",&nbsp;"ordinal"。 |
......@@ -634,7 +634,7 @@ constructor(locale: string | Array&lt;string&gt;, options?: RelativeTimeFormatIn
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ---------------------------------------- | ---- | ---------------------------- |
| -------------------- | ---------------------------------------- | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options<sup>9+</sup> | [RelativeTimeFormatInputOptions](#relativetimeformatinputoptions9) | 否 | 用于创建相对时间格式化对象的选项。 |
......@@ -727,7 +727,7 @@ resolvedOptions(): RelativeTimeFormatResolvedOptions
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------- | ------ | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法,取值包括:"best&nbsp;fit",&nbsp;"lookup"。 |
| numeric | string | 是 | 是 | 输出消息的格式,取值包括:"always",&nbsp;"auto"。 |
......@@ -740,7 +740,7 @@ resolvedOptions(): RelativeTimeFormatResolvedOptions
**系统能力**:SystemCapability.Global.I18n
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------ | ---- | ---- | ---------------------------------------- |
| locale | string | 是 | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| numeric | string | 是 | 是 | 输出消息的格式,取值包括:"always",&nbsp;"auto"。 |
......
# Web
提供具有网页显示能力的Web组件。
> **说明:**
>
> - 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> - 示例效果请以真机运行为准,当前IDE预览器不支持。
提供具有网页显示能力的Web组件。
## 需要权限
访问在线网页时需添加网络权限:ohos.permission.INTERNET,具体申请方式请参考[权限申请声明](../../security/accesstoken-guidelines.md)
......@@ -27,7 +27,7 @@ Web(options: { src: ResourceStr, controller: WebController | WebviewController})
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ---------- | ---------------------------------------- | ---- | ------- |
| 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})
## 属性
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
......@@ -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#属性)。
## 事件
不支持通用事件。
......
......@@ -17,13 +17,13 @@ Link(propName: string): any
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | --------------------- |
| -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要双向绑定的属性名称。 |
**返回值:**
| 类型 | 描述 |
| ----- | ------------------------------------------------------------ |
| ----- | ---------------------------------------- |
| @Link | 在具有给定键的数据,则返回到此属性的双向数据绑定,该双向绑定意味着变量或者组件对数据的更改将同步到AppStorage,通过AppStorage对数据的修改将同步到变量或者组件。 |
```ts
......@@ -39,14 +39,14 @@ SetAndLink\<T>(propName: string, defaultValue: T): SubscribedAbstractProperty\<T
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | -------------------- |
| ------------ | ------ | ---- | ----------- |
| propName | string | 是 | 要进行创建的key值。 |
| defaultValue | T | 是 | 要进行设置的默认值。 |
**返回值:**
| 类型 | 描述 |
| ----- | ------------------------------------------------------------ |
| ----- | ---------------------------------------- |
| @Link | 与Link接口类似,如果当前的key保存于AppStorage,返回该key值对应的value值。如果该key值未被创建,则创建一个对应的defaultValue的Link返回。 |
```ts
......@@ -62,13 +62,13 @@ Prop(propName: string): any
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ------------------- |
| -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要进行创建的key值。 |
**返回值:**
| 类型 | 描述 |
| ----- | ------------------------------------------------------------ |
| ----- | ---------------------------------------- |
| @Prop | 如果存在具有给定键的属性,则返回此属性的单向数据绑定。该单向绑定意味着只能通过AppStorage将属性的更改同步到变量或者组件。该方法返回的变量为不可变变量,适用于可变和不可变的状态属性,如果具有此键的属性不存在则返回undefined。 |
```ts
......@@ -84,14 +84,14 @@ SetAndProp\<S>(propName: string, defaultValue: S): SubscribedAbstractProperty\<S
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | --------------------------- |
| ------------ | ------ | ---- | --------------- |
| propName | string | 是 | 要保存的的键值对中的key值。 |
| defaultValue | S | 是 | 创建的默认值。 |
**返回值:**
| 类型 | 描述 |
| ----- | ------------------------------------------------------------ |
| ----- | ---------------------------------------- |
| @Prop | 如果当前的key保存与AppStorage,返回该key值对应的value值。如果该key值未被创建,则创建一个对应的defaultValue的Prop返回。 |
```ts
......@@ -107,13 +107,13 @@ Has(propName: string): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | -------------- |
| -------- | ------ | ---- | ------- |
| propName | string | 是 | 属性的属性值。 |
**返回值:**
| 类型 | 描述 |
| ------- | -------------------------- |
| ------- | ------------- |
| boolean | 返回属性的属性值是否存在。 |
```ts
......@@ -129,13 +129,13 @@ Get\<T>(propName: string): T | undefined
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | ---- | ------------------- |
| -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要获取对应的key值。 |
**返回值:**
| 类型 | 描述 |
| ------------------ | -------------------------- |
| ----------------- | ------------- |
| boolean或undefined | 返回属性的属性值是否存在。 |
```ts
......@@ -151,14 +151,14 @@ Set\<T>(propName: string, newValue: T): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ----------------- |
| -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要设置的key值。 |
| newValue | T | 是 | 要设置的value值。 |
**返回值:**
| 类型 | 描述 |
| ------- | ----------------------------------------------------- |
| ------- | ----------------------------------- |
| boolean | 如果存在key值,设置value值并返回true,否则返回false。 |
```ts
......@@ -174,14 +174,14 @@ SetOrCreate\<T>(propName: string, newValue: T): void
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ------------------------- |
| -------- | ------ | ---- | --------------- |
| propName | string | 是 | 要更新或者创建的key值。 |
| newValue | T | 是 | 要更新或者创建的value值。 |
**返回值:**
| 类型 | 描述 |
| ------- | ------------------------------------------------------------ |
| ------- | ---------------------------------------- |
| boolean | 如果已存在与给定键名字相同的属性,更新其值且返回true。如果不存在具有给定名称的属性,在AppStorage中创建具有给定默认值的新属性,默认值必须是T类型。不允许undefined 或 null 返回true。 |
```ts
......@@ -197,13 +197,13 @@ Delete(propName: string): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | --------------------- |
| -------- | ------ | ---- | ------------ |
| propName | string | 是 | 要删除的属性的key值。 |
**返回值:**
| 类型 | 描述 |
| ------- | ------------------------------------------------------------ |
| ------- | ---------------------------------------- |
| boolean | 删除key指定的键值对,如果存在且删除成功返回true,不存在或删除失败返回false。 |
```ts
......@@ -219,7 +219,7 @@ keys(): IterableIterator\<string>
**返回值:**
| 类型 | 描述 |
| -------------- | ---------------------------- |
| -------------- | -------------- |
| array\<string> | 返回包含所有键的字符串数组。 |
```ts
......@@ -232,19 +232,19 @@ staticClear(): boolean
删除所有的属性。
**该属性在api9上已废弃,使用Clear属性替代**
从API version 9开始废弃,推荐使用[Clear](#clear)
**返回值:**
| 类型 | 描述 |
| ------- | ------------------------------------------------------------ |
| ------- | --------------------------------- |
| boolean | 删除所有的属性,如果当前有状态变量依旧引用此属性,返回false。 |
```ts
let simple = AppStorage.staticClear()
```
### Clear
### Clear<sup>9+</sup>
Clear(): boolean
......@@ -253,7 +253,7 @@ Clear(): boolean
**返回值:**
| 类型 | 描述 |
| ------- | ------------------------------------------------------------ |
| ------- | --------------------------------- |
| boolean | 删除所有的属性,如果当前有状态变量依旧引用此属性,返回false。 |
```typescript
......@@ -269,13 +269,13 @@ IsMutable(propName: string): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | :--- | --------------------- |
| -------- | ------ | :--- | ------------ |
| propName | string | 是 | 要查询的属性的key值。 |
**返回值:**
| 类型 | 描述 |
| ------- | ------------------------------------ |
| ------- | ------------------ |
| boolean | 返回此属性是否存在并且是否可以改变。 |
```ts
......@@ -291,7 +291,7 @@ Size(): number
**返回值:**
| 类型 | 描述 |
| ------ | ------------------ |
| ------ | --------- |
| number | 返回键值对的数量。 |
```ts
......@@ -309,7 +309,7 @@ constructor(initializingProperties?: Object)
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ---------------------- | ------ | ---- | ------------------------------------------------------------ |
| ---------------------- | ------ | ---- | ---------------------------------------- |
| initializingProperties | Object | 否 | object.keys(obj)返回的所有对象属性及其值都将添加到LocalStorage。 |
```ts
......@@ -327,7 +327,7 @@ static GetShared(): LocalStorage
**返回值:**
| 类型 | 描述 |
| ----------------------------- | ---------------------- |
| ----------------------------- | ----------------- |
| [LocalStorage](#localstorage) | 返回LocalStorage对象。 |
```ts
......@@ -343,13 +343,13 @@ has(propName: string): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | -------------- |
| -------- | ------ | ---- | ------- |
| propName | string | 是 | 属性的属性值。 |
**返回值:**
| 类型 | 描述 |
| ------- | -------------------------- |
| ------- | ------------- |
| boolean | 返回属性的属性值是否存在。 |
```ts
......@@ -366,13 +366,13 @@ get\<T>(propName: string): T
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ------------------- |
| -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要获取对应的key值。 |
**返回值:**
| 类型 | 描述 |
| -------------- | ------------------------------------------------------- |
| -------------- | ---------------------------------------- |
| T \| undefined | 当keyvalue存在时,返回keyvalue值。不存在返回undefined。 |
```ts
......@@ -389,14 +389,14 @@ set\<T>(propName: string, newValue: T): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ----------------- |
| -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要设置的key值。 |
| newValue | T | 是 | 要设置的value值。 |
**返回值:**
| 类型 | 描述 |
| ------- | ----------------------------------------------------- |
| ------- | ----------------------------------- |
| boolean | 如果存在key值,设置value值并返回true,否则返回false。 |
```ts
......@@ -413,14 +413,14 @@ setOrCreate\<T>(propName: string, newValue: T): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | :--- | ----------------------- |
| -------- | ------ | :--- | -------------- |
| propName | string | 是 | 要更新或创建的key值。 |
| newValue | T | 是 | 要更新或创建的value值。 |
**返回值:**
| 类型 | 描述 |
| ------- | ------------------------------------------------------------ |
| ------- | ---------------------------------------- |
| boolean | 如果已存在与给定键名字相同的属性,更新其值且返回true。如果不存在具有给定名称的属性,在LocalStorage中创建具有给定默认值的新属性,默认值必须是T类型,不允许undefined 或 null 。 |
```ts
......@@ -437,13 +437,13 @@ link\<T>(propName: string): T
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ---------------------- |
| -------- | ------ | ---- | ----------- |
| propName | string | 是 | 要双向绑定的属性名称。 |
**返回值:**
| 类型 | 描述 |
| ---- | ------------------------------------------------------------ |
| ---- | ---------------------------------------- |
| T | 如果存在具有给定键的属性,返回到此属性的双向绑定,该双向绑定意味着变量或者组件对数据的更改将同步到LocalStorage,然后通过LocalStorage实例同步到任何变量或组件。如果不存在给定键的属性,返回undefined。 |
```ts
......@@ -460,14 +460,14 @@ setAndLink\<T>(propName: string, defaultValue: T): T
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | -------------------- |
| ------------ | ------ | ---- | ----------- |
| propName | string | 是 | 要进行创建的key值。 |
| defaultValue | T | 是 | 要进行设置的默认值。 |
**返回值:**
| 类型 | 描述 |
| ------------------------------------ | ------------------------------------------------------------ |
| ----- | ---------------------------------------- |
| @Link | 与Link接口类似,如果当前的key保存于LocalStorage,返回该key值对应的value值。如果该key值未被创建,则创建一个对应的defaultValue的Link返回。 |
```ts
......@@ -484,13 +484,13 @@ prop\<T>(propName: string): T
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | --- | ----------------------- |
| -------- | ------ | ---- | ------------- |
| propName | string | 是 | 要单向数据绑定的key值。 |
**返回值:**
| 类型 | 描述 |
| ------------------------------------ | ------------------------------------------------------------ |
| ----- | ---------------------------------------- |
| @Prop | 如果存在具有给定键的属性,返回此属性的单向数据绑定。该单向绑定意味着只能通过LocalStorage将属性的更改同步到变量或组件。该方法返回的变量为不可变变量,适用于可变和不可变的状态变量。如果此键的属性不存在则返回undefined。 |
```ts
......@@ -507,14 +507,14 @@ setAndProp\<T>(propName: string, defaultValue: T): T
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | ------------------------- |
| ------------ | ------ | ---- | -------------- |
| propName | string | 是 | 要保存的键值对中的key值。 |
| defaultValue | T | 是 | 创建的默认值。 |
**返回值:**
| 类型 | 描述 |
| ------------------------------------ | ------------------------------------------------------------ |
| ----- | ---------------------------------------- |
| @Prop | 如果当前的key保存与LocalStorage,返回该key值对应的value值。如果该key值未被创建,则创建一个对应的defaultValue的Prop返回。 |
```ts
......@@ -531,13 +531,13 @@ delete(propName: string): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| -------- | ------ | :--- | --------------------- |
| -------- | ------ | :--- | ------------ |
| propName | string | 是 | 要删除的属性的key值。 |
**返回值:**
| 类型 | 描述 |
| ------- | ------------------------------------------------------------ |
| ------- | ---------------------------------------- |
| boolean | 删除key指定的键值对。存在且删除成功,返回true。不存在、删除失败或有状态变量依旧引用propName,返回false。 |
```ts
......@@ -554,7 +554,7 @@ keys(): IterableIterator\<string>
**返回值:**
| 类型 | 描述 |
| -------------- | -------------------------------------- |
| -------------- | ------------------- |
| array\<string> | 返回包含所有键不可序列化的字符串数组。 |
```ts
......@@ -571,7 +571,7 @@ size(): number
**返回值:**
| 类型 | 描述 |
| ------ | ------------------ |
| ------ | --------- |
| number | 返回键值对的数量。 |
```ts
......@@ -588,7 +588,7 @@ clear(): boolean
**返回值:**
| 类型 | 描述 |
| ------- | ------------------------------------------------------------ |
| ------- | --------------------------------- |
| boolean | 删除所有的属性,如果当前有状态变量依旧引用此属性,返回false。 |
```ts
......@@ -607,7 +607,7 @@ constructor(appStorage: AppStorage, storage: Storage)
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ---------- | ---------- | --- | -------------------------------- |
| ---------- | ---------- | ---- | ---------------- |
| appStorage | AppStorage | 是 | 保存所有属性及属性值的单例对象。 |
| storage | Storage | 是 | Storage实例对象。 |
......@@ -624,7 +624,7 @@ PersistProp(key:string,defaultValue:T): void
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ------------ | ------ | --- | ----------------------- |
| ------------ | ------ | ---- | -------------- |
| key | string | 是 | 要关联的属性的key值。 |
| defaultValue | T | 是 | 要关联的属性的value值。 |
......@@ -641,7 +641,7 @@ DeleteProp(key: string): void
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ------ | ------ | --- | --------------------- |
| ---- | ------ | ---- | ------------ |
| key | string | 是 | 要取消的属性的key值。 |
```ts
......@@ -657,7 +657,7 @@ PersistProps(properties: {key: string, defaultValue: any}[]): void;
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 |
| ------ | ---------------------------------- | -- | ------------------ |
| ---- | ---------------------------------- | ---- | --------- |
| key | {key: string, defaultValue: any}[] | 是 | 要关联的属性数组。 |
```ts
......@@ -673,7 +673,7 @@ Keys(): Array\<string>
**返回值:**
| 类型 | 描述 |
| ------------- | -------------------------- |
| -------------- | ------------- |
| Array\<string> | 返回所有持久化属性的标记。 |
```ts
......@@ -705,20 +705,20 @@ EnvProp\<S>(key: string, value: S): boolean
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 | 参数描述 |
| ------ | ------ | --- | --------------- | ----------------- |
| ----- | ------ | ---- | ---------- | ------------------------- |
| key | string | 是 | 要关联的key值 | 要关联的key值,支持的范围详见内置环境变量说明。 |
| value | S | 是 | 要关联的value值 | 要关联的value值。 |
**返回值:**
| 类型 | 描述 |
| ------- | ---------------------------------- |
| ------- | ---------------------- |
| boolean | 返回该属性在AppStorage中是否存在。 |
**内置环境变量说明:**
| key | 类型 | 说明 |
| ------------ | ------------- | ------------------- |
| -------------------- | --------------- | ---------------------------------------- |
| accessibilityEnabled | string | 无障碍屏幕朗读是否启用。 |
| colorMode | ColorMode | 深浅色模式,可选值为:<br>- ColorMode.LIGHT:浅色模式;<br>- ColorMode.DARK:深色模式。 |
| fontScale | number | 字体大小比例。 |
......@@ -739,7 +739,7 @@ EnvProps(props: {key: string, defaultValue: any}[]): void
**参数:**
| 参数名 | 类型 | 必填 | 参数描述 | 参数描述 |
| ------ | ---------------------------------- | --- | ------------------ | ------------------ |
| ---- | ---------------------------------- | ---- | --------- | --------- |
| key | {key: string, defaultValue: any}[] | 是 | 要关联的属性数组。 | 要关联的属性数组。 |
```ts
......@@ -755,7 +755,7 @@ Keys(): Array\<string>
**返回值:**
| 类型 | 描述 |
| ------------- | ---------------------- |
| -------------- | ----------- |
| Array\<string> | 返回关联的系统项数组。 |
```ts
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册