• HarmonyOS/OpenHarmony应用开发-FA卡片开发体验


    卡片概述

    卡片是一种界面展示形式,可以将应用的重要信息或操作前置到卡片,以达到服务直达,减少体验层级的目的。

    卡片常用于嵌入到其他应用(当前只支持系统应用)中作为其界面的一部分显示,并支持拉起页面,发送消息等基础的交互功能。卡片使用方负责显示卡片。

    卡片的基本概念:

    卡片提供方:提供卡片显示内容原子化服务,控制卡片的显示内容、控件布局以及控件点击事件。

    卡片使用方:显示卡片内容的宿主应用,控制卡片在宿主中展示的位置。

    卡片管理服务:用于管理系统中所添加卡片的常驻代理服务,包括卡片对象的管理与使用,以及卡片周期性刷新等。

    场景介绍

    FA卡片开发,即基于FA模型的卡片提供方开发,主要涉及如下功能逻辑:

    开发卡片生命周期回调函数LifecycleForm。

    创建卡片数据FormBindingData对象。

    通过FormProvider更新卡片。

    开发卡片页面。

    接口说明

    LifecycleForm API接口功能介绍

    接口名

    描述

    onCreate(want: Want): formBindingData.FormBindingData

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

    onCastToNormal(formId: string): void

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

    onUpdate(formId: string): void

    卡片提供方接收更新卡片的通知接口。

    onVisibilityChange(newStatus: { [key: string]: number }): void

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

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

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

    onDestroy(formId: string): void

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

    onAcquireFormState?(want: Want): formInfo.FormState

    卡片提供方接收查询卡片状态的通知接口。

     FormProvider API接口功能介绍

    接口名

    描述

    setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback): void;

    设置指定卡片的下一次更新时间。

    setFormNextRefreshTime(formId: string, minute: number): Promise;

    设置指定卡片的下一次更新时间,以promise方式返回。

    updateForm(formId: string, formBindingData: FormBindingData, callback: AsyncCallback): void;

    更新指定的卡片。

    updateForm(formId: string, formBindingData: FormBindingData): Promise;

    更新指定的卡片,以promise方式返回。

    开发体验:

     

     

    示例效果:

     

    示例代码:

    HarmonyOSAPP开发相关组件: 深圳市蛟龙腾飞网络科技有限公司 - Gitee.com

    参考文档:

    文档中心

  • 相关阅读:
    利用WebSocket +MQ发送紧急订单消息,并在客户端收到消息的用户的页面自动刷新列表
    MySQL中如何计算时间相差的分钟数
    竞赛选题 深度学习疲劳驾驶检测 opencv python
    pybind11
    Java安全之CC4,5,7
    111. 二叉树的最小深度
    【Java+SSM】请假审批系统
    聚类标签的艺术:SKlearn中的数据聚类标签分配策略
    【C语言从青铜到王者】第五篇·数据在内存中的存储
    边云协同架构设计
  • 原文地址:https://blog.csdn.net/weixin_69135651/article/details/128202998