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