README_zh.md

自定义占位节点

介绍

本工程主要实现了自定义占位节点指南文档中示例代码片段的工程化,主要目标是实现指南中示例代码需要与sample工程文件同源。

使用说明:

  1. 该工程可以选择在模拟器和开发板上运行。
  2. 点击构建,即可在生成的应用中点击对应的按钮,观察自定义占位节点的不同应用。
  3. 进入”DocsSample/ArkUISample/ArkTSUserPlaceHolder/entry/src/ohosTest/ets/test/UserPlaceHolderAbility.test.ets“文件,可以对本项目进行UI的自动化测试。

工程目录

ArkTSUserPlaceHolder
├──entry/src/main
│  ├──ets  // ets代码区
|  |  ├──common
|  |  |  ├──logger.ts               // 日志类
│  │  ├──entryability
|  |  |  └──EntryAbility.ets        // 程序入口类
|  |  ├──entrybackupability
│  │  │  └──EntryBackupAbility.ets   
│  │  └──pages                      // 页面文件
│  │     └──Index.ets               // 主界面
│  │     └──CustomNode.ets          // 使用NodeContainer挂载自定义节点界面
│  │     └──LayoutDiff.ets          // NodeContainer和ContentSlot添加子节点布局差异界面
|  ├──resources         			// 资源文件目录

具体实现

  1. 通过NodeController,在NodeContainer下挂载自定义节点。
  2. 通过容器节点NodeContainer布局,不会按照父容器的布局规则进行布局。ContentSlot只是一个语法节点,不参与布局,添加的子节点会按照父容器的布局规则进行布局。

相关权限

无。

依赖

不涉及。

约束和限制

  1. 本示例仅支持标准系统上运行, 支持设备:华为手机。

  2. HarmonyOS系统:HarmonyOS 5.0.5 Release及以上。

  3. DevEco Studio版本:6.0.0 Release及以上。

  4. HarmonyOS SDK版本:HarmonyOS 6.0.0 Release SDK及以上。

下载

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

git init
git config core.sparsecheckout true
echo ArkUISample/ArkTSUserPlaceHolder/ > .git/info/sparse-checkout
git remote add origin https://gitcode.com/harmonyos_samples/guide-snippets.git
git pull origin master