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