• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AbilityComponent (系统接口)
2<!--Kit: ArkUI-->
3<!--Subsystem: ArkUI-->
4<!--Owner: @zjsxstar-->
5<!--Designer: @sunbees-->
6<!--Tester: @liuli0427-->
7<!--Adviser: @HelloCrease-->
8<!--deprecated_code_no_check-->
9
10独立显示Ability的容器。
11
12>  **说明:**
13>
14>  从API Version 10开始,该组件不再维护,推荐使用[UIExtensionComponent](ts-container-ui-extension-component-sys.md)。
15>
16>  该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
17>
18>  本模块为系统接口。
19
20## 使用约束
21
22AbilityComponent为独立层次渲染,不能再之上叠加其他显示内容。
23
24AbilityComponent不支持处理输入事件,事件不经过当前Ability,直接分发给内部的Ability处理。
25
26AbilityComponent需设置且只能设置width、height,且width、height不支持动态更新。
27
28被拉起的Ability必须继承[WindowExtension](../js-apis-application-windowExtensionAbility-sys.md)。
29
30## 子组件
31
3233
34
35## 接口
36
37AbilityComponent(value: {want: Want})
38
39**系统接口:** 此接口为系统接口。
40
41**系统能力:** SystemCapability.ArkUI.ArkUI.Full
42
43**参数:**
44
45| 参数名 | 类型                                                   | 必填 | 说明                |
46| ------ | ---------------------------------------------------------- | ---- | ----------------------- |
47| want   | [Want](../../apis-ability-kit/js-apis-app-ability-want.md) | 是   | 默认加载的Ability描述。 |
48
49
50## 事件
51
52### onConnect
53
54onConnect(callback:()&nbsp;=&gt;&nbsp;void)
55
56AbilityComponent环境启动完成时的回调,之后可使用AbilityComponent的方法。
57
58**系统接口:** 此接口为系统接口。
59
60**系统能力:** SystemCapability.ArkUI.ArkUI.Full
61
62### onDisconnect
63
64onDisconnect(callback:()&nbsp;=&gt;&nbsp;void)
65
66AbilityComponent环境销毁时的回调。
67
68**系统接口:** 此接口为系统接口。
69
70**系统能力:** SystemCapability.ArkUI.ArkUI.Full
71
72## 示例
73
74```ts
75// xxx.ets
76@Entry
77@Component
78struct MyComponent {
79
80  build() {
81      Column() {
82          AbilityComponent({
83              want: {
84                  bundleName: '',
85                  abilityName: ''
86              },
87          })
88          .onConnect(() => {
89              console.log('AbilityComponent connect')
90          })
91          .onDisconnect(() => {
92              console.log('AbilityComponent disconnect')
93          })
94      }
95  }
96}
97```
98