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 32无 33 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:() => void) 55 56AbilityComponent环境启动完成时的回调,之后可使用AbilityComponent的方法。 57 58**系统接口:** 此接口为系统接口。 59 60**系统能力:** SystemCapability.ArkUI.ArkUI.Full 61 62### onDisconnect 63 64onDisconnect(callback:() => 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