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