From 6a98eb1db13909bf1877d4b97d4bf18d3bfb7935 Mon Sep 17 00:00:00 2001 From: laiguizhong Date: Tue, 8 Mar 2022 11:57:50 +0800 Subject: [PATCH 1/5] add accessibility docs Signed-off-by: laiguizhong Change-Id: I57ed963554fc551403d020dc6e6ff17fc23a4613 --- .../reference/apis/js-apis-accessibility.md | 585 ++++++++++++++++++ 1 file changed, 585 insertions(+) create mode 100644 zh-cn/application-dev/reference/apis/js-apis-accessibility.md diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md new file mode 100644 index 00000000000..bba00f38db9 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md @@ -0,0 +1,585 @@ +# 辅助功能 + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> 本模块首批接口从 API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +## 导入模块 + +```typescript +import accessibility from '@ohos.accessibility'; +``` + +## 权限列表 + +无 + +## AbilityState + +辅助应用状态类型。 + +| 名称 | 描述 | +| -------- | -------- | +| enable | 无障碍服务已启用。 | +| disable | 无障碍服务已禁用。 | +| install | 无障碍服务已安装。 | + +## AbilityType + +无障碍辅助应用类型。 + +| 名称 | 描述 | +| -------- | -------- | +| audible | 表示具有听觉反馈。 | +| generic | 表示具有通用反馈。 | +| haptic | 表示具有触觉反馈。 | +| spoken | 表示具有语音反馈。 | +| visual | 表示具有视觉反馈。 | + +## AccessibilityAbilityInfo + +辅助应用信息。 + +### 属性 + +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| -------- | -------- | -------- | -------- | -------- | +| id | number | 是 | 否 | ability id。 | +| name | string | 是 | 否 | ability 名。 | +| bundleName | string | 是 | 否 | 包名。 | +| abilityTypes | Array<[AbilityType](#abilitytype)> | 是 | 否 | 辅助应用类型。 | +| capabilities | Array<[Capability](#capability)> | 是 | 否 | 辅助应用能力列表。 | +| description | string | 是 | 否 | 辅助应用描述。 | +| eventTypes | Array<[EventType](#eventtype)> | 是 | 否 | 辅助应用关注的无障碍事件列表。 | + +## Action + +应用所支持的目标动作。 + +| 名称 | 描述 | +| -------- | -------- | +| click | 表示点击操作。 | +| longClick | 表示长按操作。 | +| scrollForward | 表示向前滚动操作。 | +| scrollBackward | 表示向后滚动操作。 | +| focus | 表示获得焦点操作。 | +| clearFocus | 表示清除焦点操作。 | +| clearSelection | 表示清除选择操作。 | +| accessibilityFocus | 表示获得无障碍焦点操作。 | +| clearAccessibilityFocus | 表示清除无障碍焦点操作。 | +| cut | 表示剪切操作。 | +| copy | 表示复制操作。 | +| paste | 表示粘贴操作。 | +| select | 表示选择操作。 | +| setText | 表示设置文本操作。 | +| delete | 表示删除操作。 | +| setSelection | 表示选择操作。 | + +## Capability + +辅助应用能力类型。 + +| 名称 | 描述 | +| -------- | -------- | +| retrieve | 具有检索窗口内容的能力。 | +| touchGuide | 具有触摸探索模式的能力。 | +| keyEventObserver | 具有过滤按键事件的能力。 | +| zoom | 具有控制显示放大的能力。 | +| gesture | 具有执行手势动作的能力。 | + +## CaptionsFontEdgeType8+ + +字幕字体边缘类型。 + +| 名称 | 描述 | +| -------- | -------- | +| none | 无效果。 | +| raised | 凸起效果。 | +| depressed | 凹陷效果。 | +| uniform | 轮廓效果。 | +| dropShadow | 阴影效果。 | + +## CaptionsFontFamily8+ + +字幕字体。 + +| 名称 | 描述 | +| -------- | -------- | +| default | 默认字体。 | +| monospacedSerif | 等宽 Serif 字体。 | +| serif | Serif 字体。 | +| monospacedSansSerif | 等宽 Sans Serif 字体。 | +| sansSerif | Sans Serif 字体。 | +| casual | 非正式字体。 | +| cursive | 手写字体。 | +| smallCapitals | 小型大写字母字体。 | + +## CaptionsStyle8+ + +字幕风格。 + +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| -------- | -------- | -------- | -------- | -------- | +| fontFamily | [CaptionsFontFamily](#captionsfontfamily) | 是 | 否 | 描述字幕字体。 | +| fontScale | number | 是 | 否 | 描述字幕字体缩放系数。 | +| fontColor | number \| string | 是 | 否 | 描述字幕字体颜色。 | +| fontEdgeType | [CaptionsFontEdgeType](#captionsfontedgetype) | 是 | 否 | 描述字幕字体边缘。 | +| backgroundColor | number \| string | 是 | 否 | 描述字幕背景颜色。 | +| windowColor | number \| string | 是 | 否 | 描述字幕窗口颜色。 | + +## CaptionsManager8+ + +字幕配置。 + +### 属性 + +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| -------- | -------- | -------- | -------- | -------- | +| enabled | boolean | 是 | 否 | 表示字幕风格。 | +| style | [CaptionsStyle](#captionsstyle) | 是 | 否 | 表示是否启用字幕配置。 | + +## 方法 + +### on + +on(type: 'enableChange', callback: Callback<boolean>): void; + +注册字幕配置启用的监听函数。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | type | 'enableChange' | 是 | 监听字幕配置启用状态。 | + | callback | Callback<boolean> | 是 | 回调函数，在启用状态变化时将状态通过此函数进行通知。 | + +- 示例 + + ```typescript + captionsMgr.on('enableChange',(data) => { + console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) + }) + ``` + +### on + +on(type: 'styleChange', callback: Callback<CaptionsStyle>): void; + +注册字幕风格变化的监听函数。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | type | 'styleChange' | 是 | 监听字幕风格变化。 | + | callback | Callback<CaptionsStyle> | 是 | 回调函数，在字幕风格变化时通过此函数进行通知。 | + +- 示例 + + ```typescript + captionsMgr.on('styleChange',(data) => { + console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) + }) + ``` + +### off + +off(type: 'enableChange', callback: Callback<boolean>): void; + +移除字幕配置启用的监听函数。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | type | 'enableChange' | 是 | 监听字幕配置启用状态。 | + | callback | Callback<boolean> | 否 | 回调函数，在启用状态变化时将状态通过此函数进行通知。 | + +- 示例 + + ```typescript + captionsMgr.off('enableChange') + ``` + +### off + +off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; + +移除字幕风格变化的监听函数。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | type | 'styleChange' | 是 | 字幕风格变化。 | + | callback | Callback<CaptionsStyle> | 否 | 回调函数，在字幕风格变化时通过此函数进行通知。 | + +- 示例 + + ```typescript + captionsMgr.off('styleChange') + ``` + +## EventInfo + +界面变更事件。 + +### 属性 + +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| -------- | -------- | -------- | -------- | -------- | +| type | [EventType](#eventtype) | 是 | 是 | 无障碍事件类型。 | +| windowUpdateType | [WindowUpdateType](#windowupdatetype) | 是 | 是 | 窗口变化类型。 | +| bundleName | string | 是 | 是 | 目标应用名。 | +| componentType | string | 是 | 是 | 事件源组件类型，如按钮、图表。 | +| pageId | number | 是 | 是 | 事件源的页面 ID。 | +| description | string | 是 | 是 | 事件描述。 | +| triggerAction | [Action](#Action) | 是 | 是 | 触发事件的 Action。 | +| textMoveUnit | [TextMoveUnit](#textmoveunit) | 是 | 是 | 文本移动粒度。 | +| contents | Array<string> | 是 | 是 | 内容列表。 | +| lastContent | string | 是 | 是 | 最新内容。 | +| beginIndex | number | 是 | 是 | 画面显示条目的开始序号。 | +| currentIndex | number | 是 | 是 | 当前条目序号。 | +| endIndex | number | 是 | 是 | 画面显示条目的结束序号。 | +| itemCount | number | 是 | 是 | 条目总数。 | + +## EventType + +无障碍事件类型。 + +| 名称 | 描述 | +| -------- | -------- | +| click | 描述点击组件的事件。 | +| longClick | 描述长按组件的事件。 | +| select | 描述选择组件的事件。 | +| focus | 描述组件获得焦点的事件。 | +| textUpdate | 描述组件文本已更改的事件。 | +| hoverEnter | 描述悬停进入组件的事件。 | +| hoverExit | 描述悬停离开组件的事件。 | +| scroll | 描述滚动视图的事件。 | +| textSelectionUpdate | 描述选定文本已更改的事件。 | +| accessibilityFocus | 描述获得无障碍焦点的事件。 | +| accessibilityFocusClear | 描述清除无障碍焦点的事件。 | + +## TextMoveUnit + +文本无障碍导航移动粒度。 + +| 名称 | 描述 | +| -------- | -------- | +| char | 以字符为移动粒度遍历节点文本。 | +| word | 以词为移动粒度遍历节点文本。 | +| line | 以行为移动粒度遍历节点文本。 | +| page | 以页为移动粒度遍历节点文本。 | +| paragraph | 以段落为移动粒度遍历节点文本。 | + +## WindowUpdateType + +窗口变化类型。 + +| 名称 | 描述 | +| -------- | -------- | +| add | 添加窗口的窗口变化事件。 | +| remove | 一个窗口被删除的窗口变化事件。 | +| title | 窗口标题已更改的窗口变化事件。 | +| bounds | 窗口边界已更改的窗口变化事件。 | +| layer | 窗口层级发生变化的窗口变化事件。 | +| active | 窗口变为活动或不活动的窗口变化事件。 | +| focus | 窗口焦点发生变化的窗口变化事件。 | +| accessibilityFocus | 窗口无障碍焦点发生变化的窗口更改事件。 | +| parent | 父窗口已更改的窗口变化事件。 | +| children | 子窗口已更改的窗口变化事件。 | +| pip | 窗口进入或退出画中画（PIP）模式的窗口变化事件。 | + +## accessibility.getAbilityLists + +getAbilityLists(abilityType: AbilityType, stateType: AbilityState): Promise<Array<AccessibilityAbilityInfo>> + +查询辅助应用列表。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | abilityType | [AbilityType](#abilitytype) | 是 | 辅助应用的类型。 | + | stateType | [AbilityState](#abilitystate) | 是 | 辅助应用的状态。 | + +- 返回值： + + | 类型 | 说明 | + | -------- | -------- | + | Promise<Array<[AccessibilityAbilityInfo](#accessibilityabilityinfo)>> | 返回辅助应用信息列表。 | + +- 示例 + + ```typescript + accessibility.getAbilityLists("spoken", "enable") + .then((data) => { + console.info('success data:getAbilityList1 : ' + JSON.stringify(data)); + for (let item of data) { + console.info(item.id); + console.info(item.name); + console.info(item.description); + console.info(item.abilityTypes); + console.info(item.eventTypes); + console.info(item.capabilities); + console.info(item.packageName); + console.info(item.filterBundleNames); + console.info(item.bundleName); + } + }).catch((error) => { + console.error('failed to getAbilityList1 because ' + JSON.stringify(error)); + }) + ``` + +## accessibility.getAbilityLists + +getAbilityLists(abilityType: AbilityType, stateType: AbilityState,callback: AsyncCallback<Array<AccessibilityAbilityInfo>>): void + +查询辅助应用列表。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | abilityType | [AbilityType](#abilitytype) | 是 | 辅助应用的类型。 | + | stateType | [AbilityState](#abilitystate) | 是 | 辅助应用的状态。 | + | callback | AsyncCallback<Array<[AccessibilityAbilityInfo](#accessibilityabilityinfo)>> | 是 | 回调函数，返回辅助应用信息列表。 | + +- 示例 + + ```typescript + accessibility.getAbilityLists("visual", "enable", (err, data) => { + if (err) { + console.error('failed to getAbilityList2 because ' + JSON.stringify(err)); + return; + } + console.info('success data:getAbilityList2 : ' + JSON.stringify(data)); + for (let item of data) { + console.info(item.id); + console.info(item.name); + console.info(item.description); + console.info(item.abilityTypes); + console.info(item.eventTypes); + console.info(item.capabilities); + console.info(item.packageName); + console.info(item.filterBundleNames); + console.info(item.bundleName); + } + }) + ``` + +## accessibility.getCaptionsManager + +getCaptionsManager(): CaptionsManager + +获取无障碍字幕配置。 + +- 参数： + + 无 + +- 返回值： + + | 类型 | 说明 | + | -------- | -------- | + | CaptionsManager | 无障碍字幕配置管理。 | + +- 示例 + + ```typescript + captionsManager = accessibility.getCaptionsManager() + ``` + +## accessibility.on + +on(type: 'accessibilityStateChange' | 'touchGuideStateChange', callback: Callback<boolean>): void + +启用变化监听。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | type | 'accessibilityStateChange'\|'touchGuideStateChange' | 是 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。 | + | callback | Callback<boolean> | 是 | 回调函数，在启用状态变化时将状态通过此函数进行通知。 | + +- 示例 + + ```typescript + accessibility.on('accessibilityStateChange',(data) => { + console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) + }) + ``` + +## accessibility.off + +off(type: ‘accessibilityStateChange ’ | ‘touchGuideStateChange’, callback?: Callback<boolean>): void + +关闭变化监听。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | type | 'accessibilityStateChange'\|'touchGuideStateChange' | 否 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。 | + | callback | Callback<boolean> | 否 | 要取消的监听回调函数。 | + +- 示例 + + ```typescript + accessibility.off('accessibilityStateChange',(data) => { + console.info('success data:unSubscribeStateObserver : ' + JSON.stringify(data)) + }) + ``` + +## accessibility.isOpenAccessibility + +isOpenAccessibility(): Promise<boolean> + +判断是否启用了辅助功能。 + +- 参数： + + 无 + +- 返回值： + + | 类型 | 说明 | + | -------- | -------- | + | Promise<boolean> | 如果辅助功能已启用，则返回 true；否则返回 false。 | + +- 示例 + + ```typescript + accessibility.isOpenAccessibility() + .then((data) => { + console.info('success data:isOpenAccessibility : ' + JSON.stringify(data)) + }).catch((error) => { + console.error('failed to isOpenAccessibility because ' + JSON.stringify(error)); + }) + ``` + +## accessibility.isOpenAccessibility + +isOpenAccessibility(callback: AsyncCallback<boolean>): void + +判断是否启用了辅助功能。 + +- 参数 + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | callback | AsyncCallback<boolean> | 是 | 回调函数，如果辅助功能已启用，则返回 true；否则返回 false。 | + +- 示例 + + ```typescript + accessibility.isOpenAccessibility((err, data) => { + if (err) { + console.error('failed to isOpenAccessibility because ' + JSON.stringify(err)); + return; + } + console.info('success data:isOpenAccessibility : ' + JSON.stringify(data)) + }) + ``` + +## accessibility.isOpenTouchGuide + +isOpenTouchGuide(): Promise<boolean> + +判断触摸浏览模式是否开启。 + +- 返回值： + + | 类型 | 说明 | + | -------- | -------- | + | Promise<boolean> | 如果触摸浏览模式已开启，则返回 true；否则返回 false。 | + +- 示例 + + ```typescript + accessibility.isOpenTouchGuide() + .then((data) => { + console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data)) + }).catch((error) => { + console.error('failed to isOpenTouchGuide because ' + JSON.stringify(error)); + }) + ``` + +## accessibility.isOpenTouchGuide + +isOpenTouchGuide(callback: AsyncCallback<boolean>): void + +判断触摸浏览模式是否开启。 + +- 参数 + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | callback | AsyncCallback<boolean> | 是 | 回调函数，如果触摸浏览模式已开启，则返回 true；否则返回 false。 | + +- 示例 + + ```typescript + accessibility.isOpenTouchGuide((err, data) => { + if (err) { + console.error('failed to isOpenTouchGuide because ' + JSON.stringify(err)); + return; + } + console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data)) + }) + ``` + +## accessibility.sendEvent + +sendEvent(event: EventInfo): Promise<void> + +发送无障碍事件。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | event | [EventInfo](#eventinfo) | 是 | 无障碍事件对象。 | + +- 返回值： + + | 类型 | 说明 | + | -------- | -------- | + | Promise<void> | 以 Promise 形式返回结果，如果发送无障碍事件成功，则 data 有数据返回；如果发送无障碍事件失败，则 err 有数据返回。 | + +- 示例 + + ```typescript + accessibility.sendEvent(this.eventInfo) + .then((data) => { + console.info('success data:sendEvent : ' + JSON.stringify(data)) + }).catch((error) => { + console.error('failed to sendEvent because ' + JSON.stringify(error)); + }) + ``` + +## accessibility.sendEvent + +sendEvent(event: EventInfo, callback: AsyncCallback<void>): void + +发送无障碍事件。 + +- 参数： + + | 参数名 | 参数类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | event | [EventInfo](#eventinfo) | 是 | 辅助事件对象。 | + | callback | AsyncCallback<void> | 是 | 回调函数，如果发送无障碍事件成功，则 AsyncCallback 中 data 有数据返回；如果发送无障碍事件失败，则 AsyncCallback 中 err 有数据返回。 | + +- 示例 + + ```typescript + accessibility.sendEvent(this.eventInfo,(err, data) => { + if (err) { + console.error('failed to sendEvent because ' + JSON.stringify(err)); + return; + } + console.info('success data:sendEvent : ' + JSON.stringify(data)) + }) + ``` -- Gitee From f8942f21426840351cb311fd4ec7bd816713e03d Mon Sep 17 00:00:00 2001 From: laiguizhong Date: Tue, 8 Mar 2022 12:14:30 +0800 Subject: [PATCH 2/5] add syscap Signed-off-by: laiguizhong Change-Id: I0f9f124ed30c2a9cbecdc78d4f1d73a3ae2d561e --- .../reference/apis/js-apis-accessibility.md | 56 ++++++++++++++++++- 1 file changed, 54 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md index bba00f38db9..efa6f736a13 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md @@ -17,6 +17,8 @@ import accessibility from '@ohos.accessibility'; 辅助应用状态类型。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + | 名称 | 描述 | | -------- | -------- | | enable | 无障碍服务已启用。 | @@ -27,6 +29,8 @@ import accessibility from '@ohos.accessibility'; 无障碍辅助应用类型。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + | 名称 | 描述 | | -------- | -------- | | audible | 表示具有听觉反馈。 | @@ -39,6 +43,8 @@ import accessibility from '@ohos.accessibility'; 辅助应用信息。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + ### 属性 | 名称 | 参数类型 | 可读 | 可写 | 说明 | @@ -55,6 +61,8 @@ import accessibility from '@ohos.accessibility'; 应用所支持的目标动作。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + | 名称 | 描述 | | -------- | -------- | | click | 表示点击操作。 | @@ -78,6 +86,8 @@ import accessibility from '@ohos.accessibility'; 辅助应用能力类型。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + | 名称 | 描述 | | -------- | -------- | | retrieve | 具有检索窗口内容的能力。 | @@ -90,6 +100,8 @@ import accessibility from '@ohos.accessibility'; 字幕字体边缘类型。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing + | 名称 | 描述 | | -------- | -------- | | none | 无效果。 | @@ -102,6 +114,8 @@ import accessibility from '@ohos.accessibility'; 字幕字体。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing + | 名称 | 描述 | | -------- | -------- | | default | 默认字体。 | @@ -117,6 +131,8 @@ import accessibility from '@ohos.accessibility'; 字幕风格。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | fontFamily | [CaptionsFontFamily](#captionsfontfamily) | 是 | 否 | 描述字幕字体。 | @@ -145,6 +161,8 @@ on(type: 'enableChange', callback: Callback<boolean>): void; 注册字幕配置启用的监听函数。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | @@ -166,6 +184,8 @@ on(type: 'styleChange', callback: Callback<CaptionsStyle>): void; 注册字幕风格变化的监听函数。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | @@ -187,6 +207,8 @@ off(type: 'enableChange', callback: Callback<boolean>): void; 移除字幕配置启用的监听函数。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | @@ -206,6 +228,8 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; 移除字幕风格变化的监听函数。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | @@ -223,6 +247,8 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; 界面变更事件。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + ### 属性 | 名称 | 参数类型 | 可读 | 可写 | 说明 | @@ -246,6 +272,8 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; 无障碍事件类型。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + | 名称 | 描述 | | -------- | -------- | | click | 描述点击组件的事件。 | @@ -264,6 +292,8 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; 文本无障碍导航移动粒度。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + | 名称 | 描述 | | -------- | -------- | | char | 以字符为移动粒度遍历节点文本。 | @@ -276,6 +306,8 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; 窗口变化类型。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + | 名称 | 描述 | | -------- | -------- | | add | 添加窗口的窗口变化事件。 | @@ -296,6 +328,8 @@ getAbilityLists(abilityType: AbilityType, stateType: AbilityState): Promise<A 查询辅助应用列表。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | @@ -337,6 +371,8 @@ getAbilityLists(abilityType: AbilityType, stateType: AbilityState,callback: Asyn 查询辅助应用列表。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | @@ -374,6 +410,8 @@ getCaptionsManager(): CaptionsManager 获取无障碍字幕配置。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing + - 参数： 无 @@ -400,7 +438,7 @@ on(type: 'accessibilityStateChange' | 'touchGuideStateChange', callback: Callbac | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | 'accessibilityStateChange'\|'touchGuideStateChange' | 是 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。 | + | type | 'accessibilityStateChange'\|'touchGuideStateChange' | 是 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
**系统能力**：SystemCapability.Barrierfree.Accessibility.Core
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。
**系统能力**：SystemCapability.Barrierfree.Accessibility.Vision | | callback | Callback<boolean> | 是 | 回调函数，在启用状态变化时将状态通过此函数进行通知。 | - 示例 @@ -417,11 +455,13 @@ off(type: ‘accessibilityStateChange ’ | ‘touchGuideStateChange’, callbac 关闭变化监听。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | 'accessibilityStateChange'\|'touchGuideStateChange' | 否 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。 | + | type | 'accessibilityStateChange'\|'touchGuideStateChange' | 否 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
**系统能力**：SystemCapability.Barrierfree.Accessibility.Core
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。
**系统能力**：SystemCapability.Barrierfree.Accessibility.Vision | | callback | Callback<boolean> | 否 | 要取消的监听回调函数。 | - 示例 @@ -438,6 +478,8 @@ isOpenAccessibility(): Promise<boolean> 判断是否启用了辅助功能。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 参数： 无 @@ -465,6 +507,8 @@ isOpenAccessibility(callback: AsyncCallback<boolean>): void 判断是否启用了辅助功能。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 参数 | 参数名 | 参数类型 | 必填 | 说明 | @@ -489,6 +533,8 @@ isOpenTouchGuide(): Promise<boolean> 判断触摸浏览模式是否开启。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 返回值： | 类型 | 说明 | @@ -512,6 +558,8 @@ isOpenTouchGuide(callback: AsyncCallback<boolean>): void 判断触摸浏览模式是否开启。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 参数 | 参数名 | 参数类型 | 必填 | 说明 | @@ -536,6 +584,8 @@ sendEvent(event: EventInfo): Promise<void> 发送无障碍事件。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | @@ -565,6 +615,8 @@ sendEvent(event: EventInfo, callback: AsyncCallback<void>): void 发送无障碍事件。 +**系统能力**：SystemCapability.Barrierfree.Accessibility.Core + - 参数： | 参数名 | 参数类型 | 必填 | 说明 | -- Gitee From 82107ec6f68d904cc4910ebaf63bff11c7c34a1a Mon Sep 17 00:00:00 2001 From: laiguizhong Date: Wed, 9 Mar 2022 17:35:56 +0800 Subject: [PATCH 3/5] fix review opinion Signed-off-by: laiguizhong Change-Id: Ib201450c2500a2a88fbc2cf2355232317396d6f8 --- .../reference/apis/Readme-CN.md | 1 + .../reference/apis/js-apis-accessibility.md | 102 ++++++++---------- 2 files changed, 48 insertions(+), 55 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md index 837523f1a20..1b5b6af076a 100644 --- a/zh-cn/application-dev/reference/apis/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis/Readme-CN.md @@ -79,6 +79,7 @@ - [WebGL](js-apis-webgl.md) - [WebGL2](js-apis-webgl2.md) - [屏幕截图](js-apis-screenshot.md) + - [辅助功能](js-apis-accessibility.md) - DFX - [应用打点](js-apis-hiappevent.md) - [性能打点](js-apis-hitracemeter.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md index efa6f736a13..dd94e8a7360 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md @@ -9,27 +9,23 @@ import accessibility from '@ohos.accessibility'; ``` -## 权限列表 - -无 - ## AbilityState 辅助应用状态类型。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core | 名称 | 描述 | | -------- | -------- | -| enable | 无障碍服务已启用。 | -| disable | 无障碍服务已禁用。 | -| install | 无障碍服务已安装。 | +| enable | 辅助应用已启用。 | +| disable | 辅助应用已禁用。 | +| install | 辅助应用已安装。 | ## AbilityType 无障碍辅助应用类型。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core | 名称 | 描述 | | -------- | -------- | @@ -43,7 +39,7 @@ import accessibility from '@ohos.accessibility'; 辅助应用信息。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core ### 属性 @@ -61,7 +57,7 @@ import accessibility from '@ohos.accessibility'; 应用所支持的目标动作。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core | 名称 | 描述 | | -------- | -------- | @@ -86,7 +82,7 @@ import accessibility from '@ohos.accessibility'; 辅助应用能力类型。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core | 名称 | 描述 | | -------- | -------- | @@ -100,7 +96,7 @@ import accessibility from '@ohos.accessibility'; 字幕字体边缘类型。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Hearing | 名称 | 描述 | | -------- | -------- | @@ -114,7 +110,7 @@ import accessibility from '@ohos.accessibility'; 字幕字体。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Hearing | 名称 | 描述 | | -------- | -------- | @@ -131,14 +127,14 @@ import accessibility from '@ohos.accessibility'; 字幕风格。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Hearing | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | -| fontFamily | [CaptionsFontFamily](#captionsfontfamily) | 是 | 否 | 描述字幕字体。 | +| fontFamily | [CaptionsFontFamily](#CaptionsFontFamily8) | 是 | 否 | 描述字幕字体。 | | fontScale | number | 是 | 否 | 描述字幕字体缩放系数。 | | fontColor | number \| string | 是 | 否 | 描述字幕字体颜色。 | -| fontEdgeType | [CaptionsFontEdgeType](#captionsfontedgetype) | 是 | 否 | 描述字幕字体边缘。 | +| fontEdgeType | [CaptionsFontEdgeType](#CaptionsFontEdgeType8) | 是 | 否 | 描述字幕字体边缘。 | | backgroundColor | number \| string | 是 | 否 | 描述字幕背景颜色。 | | windowColor | number \| string | 是 | 否 | 描述字幕窗口颜色。 | @@ -150,12 +146,14 @@ import accessibility from '@ohos.accessibility'; | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | -| enabled | boolean | 是 | 否 | 表示字幕风格。 | -| style | [CaptionsStyle](#captionsstyle) | 是 | 否 | 表示是否启用字幕配置。 | +| enabled | boolean | 是 | 否 | 表示是否启用字幕配置。 | +| style | [CaptionsStyle](#CaptionsStyle8) | 是 | 否 | 表示字幕风格。 | + +### 方法 -## 方法 +下列 API 示例中都需要使用 [accessibility.CaptionsManager()](#accessibilitygetCaptionsManager8) 获取 captionsManager 实例，再通过此实例调用对应的方法。 -### on +#### on('enableChange') on(type: 'enableChange', callback: Callback<boolean>): void; @@ -167,18 +165,18 @@ on(type: 'enableChange', callback: Callback<boolean>): void; | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | 'enableChange' | 是 | 监听字幕配置启用状态。 | + | type | string | 是 | 监听字幕配置启用状态。 | | callback | Callback<boolean> | 是 | 回调函数，在启用状态变化时将状态通过此函数进行通知。 | - 示例 ```typescript - captionsMgr.on('enableChange',(data) => { + captionsManager.on('enableChange',(data) => { console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) }) ``` -### on +#### on('styleChange') on(type: 'styleChange', callback: Callback<CaptionsStyle>): void; @@ -190,20 +188,20 @@ on(type: 'styleChange', callback: Callback<CaptionsStyle>): void; | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | 'styleChange' | 是 | 监听字幕风格变化。 | - | callback | Callback<CaptionsStyle> | 是 | 回调函数，在字幕风格变化时通过此函数进行通知。 | + | type | string | 是 | 监听字幕风格变化。 | + | callback | Callback<[CaptionsStyle](#CaptionsStyle8)> | 是 | 回调函数，在字幕风格变化时通过此函数进行通知。 | - 示例 ```typescript - captionsMgr.on('styleChange',(data) => { + captionsManager.on('styleChange',(data) => { console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) }) ``` -### off +#### off('enableChange') -off(type: 'enableChange', callback: Callback<boolean>): void; +off(type: 'enableChange', callback?: Callback<boolean>): void; 移除字幕配置启用的监听函数。 @@ -213,16 +211,16 @@ off(type: 'enableChange', callback: Callback<boolean>): void; | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | 'enableChange' | 是 | 监听字幕配置启用状态。 | + | type | string | 是 | 监听字幕配置启用状态。 | | callback | Callback<boolean> | 否 | 回调函数，在启用状态变化时将状态通过此函数进行通知。 | - 示例 ```typescript - captionsMgr.off('enableChange') + captionsManager.off('enableChange') ``` -### off +#### off('styleChange') off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; @@ -234,20 +232,20 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | 'styleChange' | 是 | 字幕风格变化。 | + | type | string | 是 | 字幕风格变化。 | | callback | Callback<CaptionsStyle> | 否 | 回调函数，在字幕风格变化时通过此函数进行通知。 | - 示例 ```typescript - captionsMgr.off('styleChange') + captionsManager.off('styleChange') ``` ## EventInfo 界面变更事件。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core ### 属性 @@ -272,7 +270,7 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; 无障碍事件类型。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core | 名称 | 描述 | | -------- | -------- | @@ -292,7 +290,7 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; 文本无障碍导航移动粒度。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core | 名称 | 描述 | | -------- | -------- | @@ -306,7 +304,7 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; 窗口变化类型。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力均为 SystemCapability.Barrierfree.Accessibility.Core | 名称 | 描述 | | -------- | -------- | @@ -404,7 +402,7 @@ getAbilityLists(abilityType: AbilityType, stateType: AbilityState,callback: Asyn }) ``` -## accessibility.getCaptionsManager +## accessibility.getCaptionsManager8+ getCaptionsManager(): CaptionsManager @@ -412,15 +410,11 @@ getCaptionsManager(): CaptionsManager **系统能力**：SystemCapability.Barrierfree.Accessibility.Hearing -- 参数： - - 无 - - 返回值： | 类型 | 说明 | | -------- | -------- | - | CaptionsManager | 无障碍字幕配置管理。 | + | [CaptionsManager](#CaptionsManager8) | 无障碍字幕配置管理。 | - 示例 @@ -428,17 +422,19 @@ getCaptionsManager(): CaptionsManager captionsManager = accessibility.getCaptionsManager() ``` -## accessibility.on +## accessibility.on('accessibilityStateChange' | 'touchGuideStateChange') on(type: 'accessibilityStateChange' | 'touchGuideStateChange', callback: Callback<boolean>): void -启用变化监听。 +启用辅助应用和触摸浏览功能的状态变化监听。 + +**系统能力**：以下各项对应的系统能力有所不同，详见下表。 - 参数： | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | 'accessibilityStateChange'\|'touchGuideStateChange' | 是 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
**系统能力**：SystemCapability.Barrierfree.Accessibility.Core
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。
**系统能力**：SystemCapability.Barrierfree.Accessibility.Vision | + | type | string | 是 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
**系统能力**：SystemCapability.Barrierfree.Accessibility.Core
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。
**系统能力**：SystemCapability.Barrierfree.Accessibility.Vision | | callback | Callback<boolean> | 是 | 回调函数，在启用状态变化时将状态通过此函数进行通知。 | - 示例 @@ -449,19 +445,19 @@ on(type: 'accessibilityStateChange' | 'touchGuideStateChange', callback: Callbac }) ``` -## accessibility.off +## accessibility.off('accessibilityStateChange' | 'touchGuideStateChange') off(type: ‘accessibilityStateChange ’ | ‘touchGuideStateChange’, callback?: Callback<boolean>): void -关闭变化监听。 +关闭辅助应用和触摸浏览功能的状态变化监听。 -**系统能力**：SystemCapability.Barrierfree.Accessibility.Core +**系统能力**：以下各项对应的系统能力有所不同，详见下表。 - 参数： | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | type | 'accessibilityStateChange'\|'touchGuideStateChange' | 否 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
**系统能力**：SystemCapability.Barrierfree.Accessibility.Core
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。
**系统能力**：SystemCapability.Barrierfree.Accessibility.Vision | + | type | string | 否 | 监听的事件类型。
- type 为'accessibilityStateChange'时表示监听类型为辅助功能启用状态变化监听；
**系统能力**：SystemCapability.Barrierfree.Accessibility.Core
- type 为'touchGuideStateChange'时表示监听类型为触摸浏览启用状态变化监听。
**系统能力**：SystemCapability.Barrierfree.Accessibility.Vision | | callback | Callback<boolean> | 否 | 要取消的监听回调函数。 | - 示例 @@ -480,10 +476,6 @@ isOpenAccessibility(): Promise<boolean> **系统能力**：SystemCapability.Barrierfree.Accessibility.Core -- 参数： - - 无 - - 返回值： | 类型 | 说明 | -- Gitee From 47089da0aa1d36af4c83f846ff380bfce4850298 Mon Sep 17 00:00:00 2001 From: laiguizhong Date: Thu, 10 Mar 2022 11:21:27 +0800 Subject: [PATCH 4/5] fix jump link Signed-off-by: laiguizhong Change-Id: Id52b1b1ebf78e950a5659402d2e8d9a130319da5 --- .../reference/apis/js-apis-accessibility.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md index dd94e8a7360..d91a478a4e3 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md @@ -131,10 +131,10 @@ import accessibility from '@ohos.accessibility'; | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | -| fontFamily | [CaptionsFontFamily](#CaptionsFontFamily8) | 是 | 否 | 描述字幕字体。 | +| fontFamily | [CaptionsFontFamily](#captionsfontfamily8) | 是 | 否 | 描述字幕字体。 | | fontScale | number | 是 | 否 | 描述字幕字体缩放系数。 | | fontColor | number \| string | 是 | 否 | 描述字幕字体颜色。 | -| fontEdgeType | [CaptionsFontEdgeType](#CaptionsFontEdgeType8) | 是 | 否 | 描述字幕字体边缘。 | +| fontEdgeType | [CaptionsFontEdgeType](#captionsfontedgetype8) | 是 | 否 | 描述字幕字体边缘。 | | backgroundColor | number \| string | 是 | 否 | 描述字幕背景颜色。 | | windowColor | number \| string | 是 | 否 | 描述字幕窗口颜色。 | @@ -147,11 +147,11 @@ import accessibility from '@ohos.accessibility'; | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | enabled | boolean | 是 | 否 | 表示是否启用字幕配置。 | -| style | [CaptionsStyle](#CaptionsStyle8) | 是 | 否 | 表示字幕风格。 | +| style | [CaptionsStyle](#captionsstyle8) | 是 | 否 | 表示字幕风格。 | ### 方法 -下列 API 示例中都需要使用 [accessibility.CaptionsManager()](#accessibilitygetCaptionsManager8) 获取 captionsManager 实例，再通过此实例调用对应的方法。 +下列 API 示例中都需要使用 [accessibility.CaptionsManager()](#accessibilitygetcaptionsmanager8) 获取 captionsManager 实例，再通过此实例调用对应的方法。 #### on('enableChange') @@ -189,7 +189,7 @@ on(type: 'styleChange', callback: Callback<CaptionsStyle>): void; | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 监听字幕风格变化。 | - | callback | Callback<[CaptionsStyle](#CaptionsStyle8)> | 是 | 回调函数，在字幕风格变化时通过此函数进行通知。 | + | callback | Callback<[CaptionsStyle](#captionsstyle8)> | 是 | 回调函数，在字幕风格变化时通过此函数进行通知。 | - 示例 @@ -233,7 +233,7 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; | 参数名 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 字幕风格变化。 | - | callback | Callback<CaptionsStyle> | 否 | 回调函数，在字幕风格变化时通过此函数进行通知。 | + | callback | Callback<[CaptionsStyle](#captionsstyle8)> | 否 | 回调函数，在字幕风格变化时通过此函数进行通知。 | - 示例 @@ -414,7 +414,7 @@ getCaptionsManager(): CaptionsManager | 类型 | 说明 | | -------- | -------- | - | [CaptionsManager](#CaptionsManager8) | 无障碍字幕配置管理。 | + | [CaptionsManager](#captionsmanager8) | 无障碍字幕配置管理。 | - 示例 -- Gitee From ba26cfaf4c047df91c573b9ec25236afe7f66a90 Mon Sep 17 00:00:00 2001 From: laiguizhong Date: Thu, 10 Mar 2022 16:39:12 +0800 Subject: [PATCH 5/5] fix indent problem Change-Id: Ie7ef7ad2f4a6fe70a358de6f943fb6d23aa65547 Signed-off-by: laiguizhong --- .../reference/apis/js-apis-accessibility.md | 48 +++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md index d91a478a4e3..7d3076a1c53 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md @@ -151,7 +151,7 @@ import accessibility from '@ohos.accessibility'; ### 方法 -下列 API 示例中都需要使用 [accessibility.CaptionsManager()](#accessibilitygetcaptionsmanager8) 获取 captionsManager 实例，再通过此实例调用对应的方法。 +下列 API 示例中都需要使用 [accessibility.getCaptionsManager()](#accessibilitygetcaptionsmanager8) 获取 captionsManager 实例，再通过此实例调用对应的方法。 #### on('enableChange') @@ -257,7 +257,7 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; | componentType | string | 是 | 是 | 事件源组件类型，如按钮、图表。 | | pageId | number | 是 | 是 | 事件源的页面 ID。 | | description | string | 是 | 是 | 事件描述。 | -| triggerAction | [Action](#Action) | 是 | 是 | 触发事件的 Action。 | +| triggerAction | [Action](#action) | 是 | 是 | 触发事件的 Action。 | | textMoveUnit | [TextMoveUnit](#textmoveunit) | 是 | 是 | 文本移动粒度。 | | contents | Array<string> | 是 | 是 | 内容列表。 | | lastContent | string | 是 | 是 | 最新内容。 | @@ -347,20 +347,20 @@ getAbilityLists(abilityType: AbilityType, stateType: AbilityState): Promise<A accessibility.getAbilityLists("spoken", "enable") .then((data) => { console.info('success data:getAbilityList1 : ' + JSON.stringify(data)); - for (let item of data) { - console.info(item.id); - console.info(item.name); - console.info(item.description); - console.info(item.abilityTypes); - console.info(item.eventTypes); - console.info(item.capabilities); - console.info(item.packageName); - console.info(item.filterBundleNames); - console.info(item.bundleName); - } - }).catch((error) => { - console.error('failed to getAbilityList1 because ' + JSON.stringify(error)); - }) + for (let item of data) { + console.info(item.id); + console.info(item.name); + console.info(item.description); + console.info(item.abilityTypes); + console.info(item.eventTypes); + console.info(item.capabilities); + console.info(item.packageName); + console.info(item.filterBundleNames); + console.info(item.bundleName); + } + }).catch((error) => { + console.error('failed to getAbilityList1 because ' + JSON.stringify(error)); + }) ``` ## accessibility.getAbilityLists @@ -538,10 +538,10 @@ isOpenTouchGuide(): Promise<boolean> ```typescript accessibility.isOpenTouchGuide() .then((data) => { - console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data)) - }).catch((error) => { - console.error('failed to isOpenTouchGuide because ' + JSON.stringify(error)); - }) + console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data)) + }).catch((error) => { + console.error('failed to isOpenTouchGuide because ' + JSON.stringify(error)); + }) ``` ## accessibility.isOpenTouchGuide @@ -595,10 +595,10 @@ sendEvent(event: EventInfo): Promise<void> ```typescript accessibility.sendEvent(this.eventInfo) .then((data) => { - console.info('success data:sendEvent : ' + JSON.stringify(data)) - }).catch((error) => { - console.error('failed to sendEvent because ' + JSON.stringify(error)); - }) + console.info('success data:sendEvent : ' + JSON.stringify(data)) + }).catch((error) => { + console.error('failed to sendEvent because ' + JSON.stringify(error)); + }) ``` ## accessibility.sendEvent -- Gitee