如果需要在页面中获得当前Ability的Context,可调用getContext接口获取当前页面关联的UIAbilityContext或ExtensionContext。
getContext(component?: Object):Context
获取与页面上下文组件关联的Context对象。
从API version 9开始支持,从API version 18开始废弃,建议使用getHostContext替代。getHostContext需先通过getUIContext()获取UIContext实例后再调用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
模型约束: 此接口仅可在Stage模型下使用。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| component | Object | 否 | 当前自定义组件的实例。当需要获取指定自定义组件关联的Context时,传入该组件实例;不传入component或传入的参数类型非法时,返回默认上下文。默认上下文是指通过追溯当前方法的调用链所跟踪到的Context。传入component时返回该组件关联的Context,不传入时返回通过当前方法调用链跟踪到的默认上下文。 |
返回值:
| 类型 | 说明 |
|---|---|
| Context | 返回当前组件所在Ability的Context,Context的具体类型为当前Ability关联的Context对象。例如:在UIAbility(用户界面Ability)窗口中的页面调用该接口,返回类型为UIAbilityContext。在ExtensionAbility(扩展Ability)窗口中的页面调用该接口,返回类型为ExtensionContext。 |
type Context = import('../api/application/Context').default
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
模型约束: 此接口仅可在Stage模型下使用。
| 类型 | 说明 |
|---|---|
| import('../api/application/Context').default | 返回当前组件所在Ability的Context,Context的具体类型为当前Ability关联的Context对象。例如:在UIAbility窗口中的页面调用该接口,返回类型为UIAbilityContext。在ExtensionAbility窗口中的页面调用该接口,返回类型为ExtensionContext。 |
示例:
在UIAbility中通过windowStage.loadContent加载具体页面。
// EntryAbility.ets
import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';
export default class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
}
onDestroy() {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
}
onWindowStageCreate(windowStage: window.WindowStage) {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
windowStage.loadContent('pages/Index', (err, data) => {
if (err.code) {
console.error(`Failed to load the content. Code: ${err.code}, message: ${err.message}`);
return;
}
hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
});
}
onWindowStageDestroy() {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
}
onForeground() {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onForeground');
}
onBackground() {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onBackground');
}
} 在Index.ets中可以通过getContext接口获取Context,本示例返回的Context类型为UIAbilityContext。
// pages/Index.ets
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
// 建议使用this.getUIContext().getHostContext()
let context: Context = getContext(this) as Context;
console.info('CacheDir:' + context.cacheDir);
})
}
.width('100%')
}
.height('100%')
}
}