145 Star 1.4K Fork 1.7K

OpenHarmony/applications_app_samples

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
文件
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

使用ArkUI的FrameNode扩展实现动态布局类框架

介绍

本示例是使用ArkUI的FrameNode扩展实现动态布局类框架 的示例代码,主要讲解如何使用ArkUI的FrameNode扩展实现动态布局类框架。

效果图预览

使用说明

  1. 定义DSL用来描述UI。
  2. 定义DSL解析逻辑,使用FrameNode来创建对应组件。
  3. 使用NodeContainer组件占位,将创建的组件加载到页面中。

实现思路

  1. 定义DSL,DSL一般会使用JSON、XML等数据交换格式来描述UI,本案例使用JSON,详细代码请参考foo.json
{
  "type": "Column",
  "css": {
    "width": "100%"
  },
  "children": [
    {
      "type": "Row",
      "css": {
        "width": "100%",
        "padding": {
          "left": 15,
          "right": 15
        },
        "margin": {
          "top": 5,
          "bottom": 5
        },
        ...
      },
      ...
    },
    ...
  ]
}
  1. 定义相应数据结构用于接收UI描述数据,详细代码参考ImperativeView.ets
class VM {
  type?: string
  content?: string
  css?: ESObject
  children?: VM[]
  id?: string
}
  1. 自定义DSL解析逻辑,且使用carouselNodes保存轮播图节点,方便后续操作节点更新,详细代码参考ImperativeView.ets
let carouselNodes: typeNode.Image[] = [];

function FrameNodeFactory(vm: VM, context: UIContext): FrameNode | null {
  ...
  return null;
}

function setColumnNodeAttr(node: typeNode.Column, css: ESObject) {
  ...
}

function setRowNodeAttr(node: typeNode.Row, css: ESObject) {
  ...
}
  1. 使用NodeContainer组件占位,将创建的组件加载到页面中,详细代码请参考ImperativeView.ets
class ImperativeController extends NodeController {
  makeNode(uiContext: UIContext): FrameNode | null {
    return FrameNodeFactory(data, uiContext);
  }
}

@Entry
@Component
struct ImperativeView {
  controller: ImperativeController = new ImperativeController();
  build() {
    Column() {
      NodeContainer(this.controller)
    }
    .height('100%')
    .width('100%')
    .backgroundColor(Color.Black)
  }
}

高性能知识点

使用ArkUI的FrameNode扩展,可以避免创建自定义组件对象和状态变量对象,也无需进行依赖收集,从而显著提升组件创建的速度,并且能更快的组件更新操作以及对组件树结构的直接控制。

工程结构&模块类型

imperativedynamiclayouts                           // har类型
|---jsonpage                                       // 存放描述UI的数据文件
|---|---foo.json                                   // 描述UI的数据
|---view                                           // 视图
|---|---ImperativeView.ets                         // 视频首页

参考资料

NodeContainer

NodeController

相关权限

不涉及

依赖

不涉及

约束与限制

  1. 本示例仅支持标准系统上运行。

  2. 本示例已适配API version 12版本SDK。

  3. 本示例需要使用DevEco Studio 5.0.0 Release及以上版本才可编译运行。

下载

如需单独下载本工程,执行如下命令:

git init
git config core.sparsecheckout true
echo /code/UI/ImperativeDynamicLayouts/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/openharmony/applications_app_samples.git
git@gitee.com:openharmony/applications_app_samples.git
openharmony
applications_app_samples
applications_app_samples
master

搜索帮助