鸿蒙UI开发 - 多设备自适应服务卡片(JS) 源码下载地址
介绍
本示例展示Js工程中服务卡片的布局和使用,其中卡片内容显示使用了一次开发,多端部署的能力实现多设备自适应。
用到了卡片扩展模块接口@ohos.app.form.FormExtensionAbility。
卡片信息和状态等相关类型和枚举接口@ohos.app.form.formInfo。
卡片数据绑定的能力接口@ohos.app.form.formBindingData。
效果预览
主页 | 卡片 |
---|---|
使用说明
1.部分设备的桌面不支持卡片,可以通过自己的开发卡片使用方,进行卡片的创建、更新和删除等操作。
2.安装应用,并在桌面上长按本应用的桌面图标,长按后弹出选项列表。
3.点击弹出列表中的服务卡片选项进入卡片添加界面。
4.点击正下方的添加到桌面按钮,卡片就会出现在桌面上。
工程目录
├──entry/src/main/ets // ets代码区
│ ├──entryability
│ │ └──EntryAbility.ets
│ ├──entryformability
│ │ └──EntryFormAbility.ets // 定义卡片对象首次被创建时需要做的操作
│ ├──pages
│ │ └──index.ets // 首页
│ └──utils
│ └──Logger.ets // 日志工具类
├──entry/src/main/js // js代码区
│ └──complex/pages/index // 定义卡片内容
│ ├──index.hml
│ ├──index.css
│ └──index.json
├──entry/src/main/resources // 应用资源目录
└──module.json5 // 添加卡片拓展能力
具体实现
1、在module.json5文件添加拓展能力,类型为卡片,并设置卡片入口srcEntrance和卡片元数据metadata。源码参考 例如:"metadata": [ { "name": "ohos.extension.form", "resource": "$profile:form_config" }。
2、初始化卡片:通过实现@ohos.app.form.FormExtensionAbility卡片操作类,在卡片对象首次被创建时,初始化卡片绑定数据为空,并将卡片状态设置为就绪状态READY。 例如:onCreate(){ formBindingData.createFormBindingData({}) onAcquireFormState(want) { return formInfo.FormState.READY }。
3、配置卡片:用js编写相应的卡片,将卡片配置到resources/base/profile/form_config, 源码参考 。
相关权限
不涉及。
依赖
不涉及。