@ohos.application.AccessibilityExtensionAbility (AccessibilityExtensionAbility)

The AccessibilityExtensionAbility module provides accessibility extension capabilities based on the ExtensionAbility framework.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtensionAbility';

Attributes

System capability: SystemCapability.BarrierFree.Accessibility.Core

Name Type Readable Writable Description
context AccessibilityExtensionContext Yes No Context of the accessibility extension ability.

AccessibilityEvent

Defines an accessibility event.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Attributes

Name Type Readable Writable Description
eventType accessibility.EventType | accessibility.WindowUpdateType | TouchGuideType | GestureType | PageUpdateType Yes No Event type.
EventType: accessibility event type.
WindowUpdateType: Window update type.
TouchGuideType: touch guide event type.
GestureType: gesture type.
PageUpdateType: page update type. This API is not supported yet.
target AccessibilityElement Yes No Target component where the event occurs.
timeStamp number Yes No Timestamp of the event.

AccessibilityElement10+

Level-2 module of AccessibilityElement.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Example

import { AccessibilityElement } from '@ohos.application.AccessibilityExtensionAbility';

let accessibilityElement: AccessibilityElement;

ElementAttributeValues10+

Level-2 module of ElementAttributeValues.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Example

import { ElementAttributeValues } from '@ohos.application.AccessibilityExtensionAbility';

let elementAttributeValues: ElementAttributeValues;

FocusDirection10+

Enumerates the focus directions. It is a level-2 module of FocusDirection.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Example

import { FocusDirection } from '@ohos.application.AccessibilityExtensionAbility';

let focusDirection: FocusDirection;

ElementAttributeKeys10+

System capability: SystemCapability.BarrierFree.Accessibility.Core

Name Type Readable Writable Description
ElementAttributeKeys keyof ElementAttributeValues Yes No Key of ElementAttributeValues.

Example

import { ElementAttributeKeys } from '@ohos.application.AccessibilityExtensionAbility';

let elementAttributeKeys: ElementAttributeKeys;

FocusType10+

Enumerates the focus types. It is a level-2 module of FocusType.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Example

import { FocusType } from '@ohos.application.AccessibilityExtensionAbility';

let focusType: FocusType;

WindowType 10+

Enumerates the window types. It is a level-2 module of WindowType.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Example

import { WindowType } from '@ohos.application.AccessibilityExtensionAbility';

let windowType: WindowType;

Rect10+

Defines a rectangle. It is a level-2 module of Rect.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Example

import { Rect } from '@ohos.application.AccessibilityExtensionAbility';

let rect: Rect;

GestureType

Enumerates gesture types.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Name Type Description
left string Left gesture.
leftThenRight string Left-then-right gesture.
leftThenUp string Left-then-up gesture.
leftThenDown string Left-then-down gesture.
right string Right gesture.
rightThenLeft string Right-then-left gesture.
rightThenUp string Right-then-up gesture.
rightThenDown string Right-then-down gesture.
up string Up gesture.
upThenLeft string Up-then-left gesture.
upThenRight string Up-then-right gesture.
upThenDown string Up-then-down gesture.
down string Down gesture.
downThenLeft string Down-then-left gesture.
downThenRight string Down-then-right gesture.
downThenUp string Down-then-up gesture.
twoFingerSingleTap11+ string Two-finger tap gesture.
twoFingerDoubleTap11+ string Two-finger double-tap gesture.
twoFingerDoubleTapAndHold11+ string Two-finger double-tap and press-and-hold gesture.
twoFingerTripleTap11+ string Two-finger triple-tap gesture.
twoFingerTripleTapAndHold11+ string Two-finger triple-tap and press-and-hold gesture.
threeFingerSingleTap11+ string Three-finger tap gesture.
threeFingerDoubleTap11+ string Three-finger double-tap gesture.
threeFingerDoubleTapAndHold11+ string Three-finger double-tap and press-and-hold gesture.
threeFingerTripleTap11+ string Three-finger triple-tap gesture.
threeFingerTripleTapAndHold11+ string Three-finger triple-tap and press-and-hold gesture.
fourFingerSingleTap11+ string Four-finger tap gesture.
fourFingerDoubleTap11+ string Four-finger double-tap gesture.
fourFingerDoubleTapAndHold11+ string Four-finger double-tap and press-and-hold gesture.
fourFingerTripleTap11+ string Four-finger triple-tap gesture.
fourFingerTripleTapAndHold11+ string Four-finger triple-tap and press-and-hold gesture.
threeFingerSwipeUp11+ string Three-finger swipe-up gesture.
threeFingerSwipeDown11+ string Three-finger swipe-down gesture.
threeFingerSwipeLeft11+ string Three-finger swipe-left gesture.
threeFingerSwipeRight11+ string Three-finger swipe-right gesture.
fourFingerSwipeUp11+ string Four-finger swipe-up gesture.
fourFingerSwipeDown11+ string Four-finger swipe-down gesture.
fourFingerSwipeLeft11+ string Four-finger swipe-left gesture.
fourFingerSwipeRight11+ string Four-finger swipe-right gesture.

PageUpdateType

Enumerates the page update types. This API is not supported in the current version.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Name Type Description
pageContentUpdate string Update of the page content.
pageStateUpdate string Update of the page status.

TouchGuideType

Enumerates the touch guide event types.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Name Type Description
touchBegin string Start of touch in touch guide mode.
touchEnd string End of touch in touch guide mode.

AccessibilityExtensionAbility.onConnect

onConnect(): void;

Called when the AccessibilityExtensionAbility is enabled and connected to the system service. In this API, you can have the service logic initialized. This API can be overridden as required.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Example

import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtensionAbility';

class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility {
  onConnect(): void {
    console.log('AxExtensionAbility onConnect');
  }
}

AccessibilityExtensionAbility.onDisconnect

onDisconnect(): void;

Called when the AccessibilityExtensionAbility is disabled and disconnected from the system service. In this API, you can implement the service logic of resource release and exit. This API can be overridden as required.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Example

import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtensionAbility';

class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility {
  onDisconnect(): void {
    console.log('AxExtensionAbility onDisconnect');
  }
}

AccessibilityExtensionAbility.onAccessibilityEvent

onAccessibilityEvent(event: AccessibilityEvent): void;

Called when an event that matches the specified bundle and event type occurs. In this API, you can implement event-specific service logic. Generally, this API needs to be overridden.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Parameters

Name Type Mandatory Description
event AccessibilityEvent Yes Accessibility event. No value is returned.

Example

import AccessibilityExtensionAbility , { AccessibilityEvent } from '@ohos.application.AccessibilityExtensionAbility';

class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility {
  onAccessibilityEvent(event: AccessibilityEvent): void {
    console.log('AxExtensionAbility onAccessibilityEvent');
    if (event.eventType === 'click') {
      console.log('AxExtensionAbility onAccessibilityEvent: click');
    }
  }
}

AccessibilityExtensionAbility.onKeyEvent

onKeyEvent(keyEvent: KeyEvent): boolean;

Called when a physical key is pressed. In this API, you can determine whether to intercept an event based on the service.

System capability: SystemCapability.BarrierFree.Accessibility.Core

Parameters

Name Type Mandatory Description
keyEvent KeyEvent Yes Key event. If true is returned, the key is intercepted.

Example

import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtensionAbility';
import { KeyEvent } from '@ohos.multimodalInput.keyEvent';

class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility {
  onKeyEvent(keyEvent: KeyEvent): boolean {
    console.log('AxExtensionAbility onKeyEvent');
    if (keyEvent.key.code === 16) {
      console.log('AxExtensionAbility onKeyEvent: intercept 16');
      return true;
    }
    return false;
  }
}