鸿蒙-FormExtensionAbility卡片生命周期

163 阅读1分钟

FormExtensionAbility为卡片扩展模块,提供卡片创建、销毁、刷新等生命周期回调

onAddForm

onAddForm(want: Want): formBindingData.FormBindingData

卡片提供方接收创建卡片的通知接口。

onCastToNormalForm

onCastToNormalForm(formId: string): void

卡片提供方接收临时卡片转常态卡片的通知接口。

  • formId:请求转换为常态的卡片标识。

onUpdateForm

onUpdateForm(formId: string, wantParams?: Record<string, Object>): void

卡片提供方接收携带参数的更新卡片的通知接口。获取最新数据后调用formProvider的updateForm接口刷新卡片数据。

  • formId:请求更新的卡片ID
  • wantParams:更新参数

onChangeFormVisibility

onChangeFormVisibility(newStatus: Record<string, number>): void

卡片提供方接收修改可见性的通知接口。

  • newStatus:请求修改的卡片标识和可见状态。

onFormEvent

onFormEvent(formId: string, message: string): void

卡片提供方接收处理卡片事件的通知接口。

  • formId:请求触发事件的卡片标识。
  • message:事件消息。

onRemoveForm

onRemoveForm(formId: string): void

卡片提供方接收销毁卡片的通知接口。

  • formId:请求销毁的卡片标识。

onConfigurationUpdate

onConfigurationUpdate(newConfig: Configuration): void

当系统配置更新时调用。

  • newConfig:表示需要更新的配置信息。

onAcquireFormState

onAcquireFormState?(want: Want): formInfo.FormState

卡片提供方接收查询卡片状态通知接口,默认返回卡片初始状态(该方法可以选择性重写)。

onStop

onStop?(): void

当卡片提供方的卡片进程退出时,触发该回调。