diff --git a/zh-cn/application-dev/quick-start/arkts-localstorage.md b/zh-cn/application-dev/quick-start/arkts-localstorage.md index c05a4b844751dcb76be12414e8d700f9eac21393..44b40476549018261de0edcd314787d69bad410d 100644 --- a/zh-cn/application-dev/quick-start/arkts-localstorage.md +++ b/zh-cn/application-dev/quick-start/arkts-localstorage.md @@ -300,9 +300,9 @@ struct CompA { ``` -### 兄弟节点之间同步状态变量 +### 兄弟组件之间同步状态变量 -下面的示例展示了通过\@LocalStorageLink双向同步兄弟节点之间的状态。 +下面的示例展示了通过\@LocalStorageLink双向同步兄弟组件之间的状态。 先看Parent自定义组件中发生的变化： diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md index d8e6a45b2092c524051afb8ac2b443b9d3b4f0be..1668fba77d83b5d6c45b1a9533f4def3fac94aae 100755 --- a/zh-cn/application-dev/reference/apis/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis/Readme-CN.md @@ -302,6 +302,7 @@ - [@ohos.web.webview (Webview)](js-apis-webview.md) - [console (控制台)](js-apis-logs.md) - [Timer (定时器)](js-apis-timer.md) + - [@system.app (应用上下文)](js-apis-system-app.md) - application - [AccessibilityExtensionContext (辅助功能扩展上下文)](js-apis-inner-application-accessibilityExtensionContext.md) @@ -397,7 +398,6 @@ - [@ohos.systemParameter (系统属性)](js-apis-system-parameter.md) - [@ohos.systemTime (系统时间、时区)](js-apis-system-time.md) - [@ohos.usb (USB管理)](js-apis-usb-deprecated.md) - - [@system.app (应用上下文)](js-apis-system-app.md) - [@system.battery (电量信息)](js-apis-system-battery.md) - [@system.bluetooth (蓝牙)](js-apis-system-bluetooth.md) - [@system.brightness (屏幕亮度)](js-apis-system-brightness.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-app.md b/zh-cn/application-dev/reference/apis/js-apis-system-app.md index c4e234dabd5ae908906e0becb28ea25707a5373f..2d6184406643c76b1c67f6c834fe2bb4f810e7ef 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-app.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-app.md @@ -26,8 +26,8 @@ static getInfo(): AppResponse **返回值：** -| 参数类型 | 说明 | -| -------- | -------- | +| 参数类型 | 说明 | +| --------------------------- | ---------------- | | [AppResponse](#appresponse) | 定义AppResponse信息。 | **示例：** @@ -69,9 +69,9 @@ static setImageCacheCount(value: number): void **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| value | number | 是 | 内存中解码后图片的缓存数量。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ------ | ---- | -------------- | +| value | number | 是 | 内存中解码后图片的缓存数量。 | **示例：** @@ -99,9 +99,9 @@ static setImageRawDataCacheSize(value: number): void **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| value | number | 是 | 内存中解码前图片数据的缓存大小，单位为字节。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ------ | ---- | ---------------------- | +| value | number | 是 | 内存中解码前图片数据的缓存大小，单位为字节。 | **示例：** @@ -130,9 +130,9 @@ static setImageFileCacheSize(value: number): void **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| value | number | 是 | 图片文件的缓存大小，单位为字节。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----- | ------ | ---- | ---------------- | +| value | number | 是 | 图片文件的缓存大小，单位为字节。 | **示例：** @@ -162,9 +162,9 @@ static screenOnVisible(options?: ScreenOnVisibleOptions): void **系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full -| 名称 | 类型 | 必填 | 说明 | -| ------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | -| options | [ScreenOnVisibleOptions](#screenonvisibleoptions) | 否 | 当启动保活时，锁屏时将阻止系统返回桌面显示，以保持屏幕唤醒时应用可见。 | +| 名称 | 类型 | 必填 | 说明 | +| ------- | ---------------------------------------- | ---- | ----------------------------------- | +| options | [ScreenOnVisibleOptions](#screenonvisibleoptions) | 否 | 当启动保活时，锁屏时将阻止系统返回桌面显示，以保持屏幕唤醒时应用可见。 | ### requestFullWindow(deprecated) @@ -178,9 +178,9 @@ static requestFullWindow(options?: RequestFullWindowOptions): void **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ | -| options | [RequestFullWindowOptions](#requestfullwindowoptions) | 否 | 请求全屏时，设定非全屏到全屏的过渡时间，单位为毫秒，默认时间与非全屏到全屏的距离成正比。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ---------------------------------------- | ---- | ---------------------------------------- | +| options | [RequestFullWindowOptions](#requestfullwindowoptions) | 否 | 请求全屏时，设定非全屏到全屏的过渡时间，单位为毫秒，默认时间与非全屏到全屏的距离成正比。 | **示例：** @@ -200,12 +200,12 @@ export default { **系统能力：** 以下各项对应的系统能力有所不同，详见下表。 -| 名称 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- |-------- | -| appID6+ | string | 是 | 表示应用的包名，用于标识应用的唯一性。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full| -| appName | string | 是 | 表示应用的名称。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite| -| versionName | string | 是 | 表示应用的版本名称。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite| -| versionCode | number | 是 | 表示应用的版本号。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite| +| 名称 | 类型 | 必填 | 说明 | +| ------------------ | ------ | ---- | ---------------------------------------- | +| appID6+ | string | 是 | 表示应用的包名，用于标识应用的唯一性。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full | +| appName | string | 是 | 表示应用的名称。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite | +| versionName | string | 是 | 表示应用的版本名称。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite | +| versionCode | number | 是 | 表示应用的版本号。
**系统能力：** SystemCapability.ArkUI.ArkUI.Lite | ## ScreenOnVisibleOptions @@ -213,12 +213,12 @@ export default { **系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full -| 名称 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| visible | boolean | 否 | 是否启动保活，默认值false。 | -| success | () => void | 否 | 接口调用成功的回调函数。 | -| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 | -| complete | () => void | 否 | 接口调用结束的回调函数。 | +| 名称 | 类型 | 必填 | 说明 | +| -------- | ------------------------------------ | ---- | ---------------- | +| visible | boolean | 否 | 是否启动保活，默认值false。 | +| success | () => void | 否 | 接口调用成功的回调函数。 | +| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 | +| complete | () => void | 否 | 接口调用结束的回调函数。 | ## RequestFullWindowOptions @@ -226,7 +226,7 @@ export default { **系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full -| 名称 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| duration | number | 是 | 定义动画选项的数量。 | +| 名称 | 类型 | 必填 | 说明 | +| -------- | ------ | ---- | ---------- | +| duration | number | 是 | 定义动画选项的数量。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md index cfe4d6873ed8981156f5e9f301ee7c822f6a6e6a..27130b8e17eaa2b93e10dacc191d83b139e0604c 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md @@ -23,36 +23,36 @@ Navigation() | 名称 | 参数类型 | 描述 | | ----------------------------- | ---------------------------------------- | ---------------------------------------- | -| title | string \| [CustomBuilder](ts-types.md#custombuilder8)8+ \| [NavigationCommonTitle](#navigationcommontitle类型说明)9+ \| [NavigationCustomTitle](#navigationcustomtitle类型说明)9+ | 页面标题。 | +| title | string \| [CustomBuilder](ts-types.md#custombuilder8)8+ \| [NavigationCommonTitle](#navigationcommontitle类型说明)9+ \| [NavigationCustomTitle](#navigationcustomtitle类型说明)9+ | 页面标题。 | | subTitledeprecated | string | 页面副标题。从API Version 9开始废弃，建议使用title代替。 | -| menus | Array<[NavigationMenuItem](#navigationmenuitem类型说明)> \| [CustomBuilder](ts-types.md#custombuilder8)8+ | 页面右上角菜单。使用Array<[NavigationMenuItem](#navigationmenuitem类型说明)> 写法时，竖屏最多支持显示3个图标，横屏最多支持显示5个图标，多余的图标会被放入自动生成的更多图标。 | +| menus | Array<[NavigationMenuItem](#navigationmenuitem类型说明)> \| [CustomBuilder](ts-types.md#custombuilder8)8+ | 页面右上角菜单。使用Array<[NavigationMenuItem](#navigationmenuitem类型说明)> 写法时，竖屏最多支持显示3个图标，横屏最多支持显示5个图标，多余的图标会被放入自动生成的更多图标。 | | titleMode | [NavigationTitleMode](#navigationtitlemode枚举说明) | 页面标题栏显示模式。
默认值：NavigationTitleMode.Free | -| toolBar | [object](#object类型说明) \| [CustomBuilder](ts-types.md#custombuilder8)8+ | 设置工具栏内容。不设置时不显示工具栏。
items: 工具栏所有项。
**说明：**
items均分底部工具栏，在每个均分内容区布局文本和图标，文本超长时，逐级缩小，缩小之后换行，最后...截断。 | -| hideToolBar | boolean | 隐藏工具栏。
默认值：false
true: 隐藏工具栏。
false: 显示工具栏。 | -| hideTitleBar | boolean | 隐藏标题栏。
默认值：false
true: 隐藏标题栏。
false: 显示标题栏。 | -| hideBackButton | boolean | 隐藏返回键。
默认值：false
true: 隐藏返回键。
false: 显示返回键。
不支持隐藏NavDestination组件标题栏中的返回图标。
**说明：**
返回键键仅针对titleMode为NavigationTitleMode.Mini时才生效。 | +| toolBar | [object](#object类型说明) \| [CustomBuilder](ts-types.md#custombuilder8)8+ | 设置工具栏内容。不设置时不显示工具栏。
items: 工具栏所有项。
**说明：**
items均分底部工具栏，在每个均分内容区布局文本和图标，文本超长时，逐级缩小，缩小之后换行，最后...截断。 | +| hideToolBar | boolean | 隐藏工具栏。
默认值：false
true: 隐藏工具栏。
false: 显示工具栏。 | +| hideTitleBar | boolean | 隐藏标题栏。
默认值：false
true: 隐藏标题栏。
false: 显示标题栏。 | +| hideBackButton | boolean | 隐藏返回键。
默认值：false
true: 隐藏返回键。
false: 显示返回键。
不支持隐藏NavDestination组件标题栏中的返回图标。
**说明：**
返回键键仅针对titleMode为NavigationTitleMode.Mini时才生效。 | | navBarWidth9+ | [Length](ts-types.md#length) | 导航栏宽度。
默认值：200
单位：vp
**说明：**
仅在Navigation组件分栏时生效。 | | navBarPosition9+ | [NavBarPosition](#navbarposition枚举说明) | 导航栏位置。
默认值：NavBarPosition.Start
**说明：**
仅在Navigation组件分栏时生效。 | | mode9+ | [NavigationMode](#navigationmode枚举说明) | 导航栏的显示模式。
默认值：NavigationMode.Auto
自适应：基于组件宽度自适应单栏和双栏。 | -| backButtonIcon9+ | string \| [PixelMap](../apis/js-apis-image.md#pixelmap7) \| [Resource](ts-types.md#resource) | 设置导航栏返回图标。不支持隐藏NavDestination组件标题栏中的返回图标。 | +| backButtonIcon9+ | string \| [PixelMap](../apis/js-apis-image.md#pixelmap7) \| [Resource](ts-types.md#resource) | 设置导航栏返回图标。不支持隐藏NavDestination组件标题栏中的返回图标。 | | hideNavBar9+ | boolean | 是否显示导航栏（仅在mode为NavigationMode.Split时生效）。 | ## NavigationMenuItem类型说明 -| 名称 | 类型 | 必填 | 描述 | -| ------ | ----------------------- | ---- | --------------- | -| value | string | 是 | 菜单栏单个选项的显示文本。 | -| icon | string | 否 | 菜单栏单个选项的图标资源路径。 | -| action | () => void | 否 | 当前选项被选中的事件回调。 | +| 名称 | 类型 | 必填 | 描述 | +| ------ | ------------- | ---- | --------------- | +| value | string | 是 | 菜单栏单个选项的显示文本。 | +| icon | string | 否 | 菜单栏单个选项的图标资源路径。 | +| action | () => void | 否 | 当前选项被选中的事件回调。 | ## object类型说明 -| 名称 | 类型 | 必填 | 描述 | -| ------ | ----------------------- | ---- | --------------- | -| value | string | 是 | 工具栏单个选项的显示文本。 | -| icon | string | 否 | 工具栏单个选项的图标资源路径。 | -| action | () => void | 否 | 当前选项被选中的事件回调。 | +| 名称 | 类型 | 必填 | 描述 | +| ------ | ------------- | ---- | --------------- | +| value | string | 是 | 工具栏单个选项的显示文本。 | +| icon | string | 否 | 工具栏单个选项的图标资源路径。 | +| action | () => void | 否 | 当前选项被选中的事件回调。 | ## NavigationTitleMode枚举说明 @@ -74,7 +74,7 @@ Navigation() | 名称 | 类型 | 必填 | 描述 | | ------- | ---------------------------------------- | ---- | -------- | | builder | [CustomBuilder](ts-types.md#custombuilder8) | 是 | 设置标题栏内容。 | -| height | [TitleHeight](#titleheight枚举说明) \| [Length](ts-types.md#length) | 是 | 设置标题栏高度。 | +| height | [TitleHeight](#titleheight枚举说明) \| [Length](ts-types.md#length) | 是 | 设置标题栏高度。 | ## NavBarPosition枚举说明 @@ -107,8 +107,8 @@ Navigation() | 名称 | 功能描述 | | ---------------------------------------- | ---------------------------------------- | -| onTitleModeChange(callback: (titleMode: NavigationTitleMode) => void) | 当titleMode为NavigationTitleMode.Free时，随着可滚动组件的滑动标题栏模式发生变化时触发此回调。 | -| onNavBarStateChange(callback: (isVisible: boolean) => void) | 导航栏显示状态切换时触发该回调。返回值isVisible为true时表示显示，为false时表示隐藏。 | +| onTitleModeChange(callback: (titleMode: NavigationTitleMode) => void) | 当titleMode为NavigationTitleMode.Free时，随着可滚动组件的滑动标题栏模式发生变化时触发此回调。 | +| onNavBarStateChange(callback: (isVisible: boolean) => void) | 导航栏显示状态切换时触发该回调。返回值isVisible为true时表示显示，为false时表示隐藏。 | ## 示例