鸿蒙5.0开发进阶:自定义节点(自定义占位节点)

HarmonyOS NEXT实战开发:自定义占位节点 ArkUI提供了ArkTS原生组件作为自定义节点的占位节点。该占位节点具备组件的通用属性。 阅读详情

往期鸿蒙全套实战文章必看:


自定义占位节点

ArkUI提供了ArkTS原生组件作为自定义节点的占位节点。该占位节点具备组件的通用属性。

NodeContainer和NodeController

NodeContainer作为原生组件,仅具备组件的通用属性,其节点规格参考默认左上角对齐的Stack组件。NodeContainer作为一个占位容器组件,主要是用于显示自定义节点以及自定义节点树的显示和复用。

NodeController提供了一系列生命周期回调,通过makeNode回调返回一个 FrameNode 节点树的根节点。将FrameNode节点树挂载到对应的NodeContainer下。同时提供了aboutToAppear、aboutToDisappear、aboutToResize、onTouchEvent、rebuild五个回调方法用于监听对应的NodeContainer的状态。

说明

  • NodeContainer下仅支持挂载自定义的FrameNode节点以及BuilderNode创建的组件树的根节点。

  • 从API Version 12开始支持的接口,可以通过FrameNode的查询接接口返回原生组件的代理节点,代理节点可以作为makeNode的返回值进行返回,但代理节点无法成功挂载在组件树上,最终的显示结果为代理节点挂载失败。

  • 需要保证一个节点只能作为一个父节点的子节点去使用,否则可能存在显示异常或者功能异常,尤其是页面路由场景或者动效场景。例如,如果通过NodeController将同一个节点挂载在多个NodeContainer上,仅一个占位容器下会显示节点,且多个NodeContainer的可见性、透明度等影响子组件状态的属性更新均会影响被挂载的子节点。

// common.ets
import { BuilderNode, UIContext } from '@kit.ArkUI'

class Params {
  text: string = "this is a text"
}

let buttonNode: BuilderNode<[Params]> | null = null;

@Builder
function buttonBuilder(params: Params) {
  Column() {
    Button(params.text)
      .fontSize(12)
      .borderRadius(8)
      .borderWidth(2)
      .backgroundColor(Color.Orange)
  }
}

export function createNode(uiContext: UIContext) {
  buttonNode = new BuilderNode<[Params]>(uiContext);
  buttonNode.build(wrapBuilder(buttonBuilder), { text: "This is a Button" });
  return buttonNode;
}

export function getOrCreateNode(uiContext: UIContext): BuilderNode<[Params]> | null {
  if (buttonNode?.getFrameNode() && buttonNode?.getFrameNode()?.getUniqueId() != -1) {
    return buttonNode;
  } else {
    return createNode(uiContext);
  }
}
// Index.ets
import { FrameNode, NodeController, Size, UIContext } from '@kit.ArkUI'
import { getOrCreateNode } from "./common"

class MyNodeController extends NodeController {
  private isShow: boolean = false;

  constructor(isShow: boolean) {
    super();
    this.isShow = isShow;
  }

  makeNode(uiContext: UIContext): FrameNode | null {
    if (!this.isShow) {
      return null;
    }
    let frameNode = getOrCreateNode(uiContext)?.getFrameNode();
    return frameNode ? frameNode : null;
  }

  aboutToResize(size: Size) {
    console.log("aboutToResize width : " + size.width + " height : " + size.height)
  }

  aboutToAppear() {
    console.log("aboutToAppear")
  }

  aboutToDisappear() {
    console.log("aboutToDisappear");
  }

  onTouchEvent(event: TouchEvent) {
    console.log("onTouchEvent");
  }

  toShow() {
    this.isShow = true;
    this.rebuild();
  }

  toHide() {
    this.isShow = false;
    this.rebuild();
  }
}

@Entry
@Component
struct Index {
  private myNodeController1: MyNodeController = new MyNodeController(true);
  private myNodeController2: MyNodeController = new MyNodeController(false);

  build() {
    Column() {
      NodeContainer(this.myNodeController1)
        .width("100%")
        .height("40%")
        .backgroundColor(Color.Brown)
      NodeContainer(this.myNodeController2)
        .width("100%")
        .height("40%")
        .backgroundColor(Color.Gray)
      Button("Change the place of button")
        .onClick(() => {
          // 先在原始占位节点中下树
          // 后在新的占位节点中上树
          // 保证自定义节点仅作为一个节点的子节点存在
          this.myNodeController1.toHide();
          this.myNodeController2.toShow();
        })
    }
    .padding({ left: 35, right: 35, top: 35 })
    .width("100%")
    .height("100%")
  }
}

鸿蒙5.0版开发:ArkTS组件-NodeContainer 基础组件,不支持尾随添加子节点。 阅读详情

相关推荐

HarmonyOS(63) ArkUI 自定义占位组件NodeContainer和NodeController

NodeContainer

菜鸟博客 1432

HarmonyOS NEXT应用开发之ArkWeb同层渲染

该方案展示了ArkWeb同层渲染:将系统原生组件直接渲染到前端H5页面上,原生组件不仅可以提供H5组件无法实现的一些功能,还能提升用户体验的流畅度。

maniuT的博客 1951

鸿蒙5.0进阶开发:UI开发-自定义占位节点

ArkUI提供了系统组件NodeContainer和ContentSlot作为自定义节点的占位节点。

AyomQAQ的博客 1152

【HarmonyOS NEXT】鸿蒙如何动态添加组件(NodeController)

一个FrameNode对象,返回的节点将被挂载至NodeContainer的占位节点上。若返回null对象,将清空对应NodeContainer的子节点。NodeController用于实现自定义节点的创建、显示、更新等操作的管理,并负责将自定义节点挂载到。当实例绑定的NodeContainer创建的时候进行回调。或者可以通过NodeController的rebuild()方法进行回调的触发。回调该方法时候,绑定NodeContainer的UI上下文。挂载显示时触发此回调。布局的时候触发此回调。

wu1004019946的博客 2119

鸿蒙HarmonyOS开发实战:自定义节点占位节点规范

自定义节点是ArkUI框架通过接口提供了底层实体节点部分基础能力的节点对象,这些节点能够与原生控件进行混合显示。

2401_84917132的博客 1432

鸿蒙HarmonyOS开发(5.0 Beta)自定义占位节点规范

自定义节点的挂载和显示需要依赖自定义占位节点。现有的自定义节点包括FrameNode、RenderNode、BuilderNode三类对象。FrameNode表示了单个的自定义组件节点,RenderNode表示更加轻量级的渲染节点,BuilderNode对象提供了能够创建、更新原生组件以及组件树的能力。

yguyf1235的博客 1296

探索华为鸿蒙系统的多行文本输入框组件(Textarea)

在华为鸿蒙系统的应用开发中,用户交互组件是构建出色用户体验的关键要素之一。其中,多行文本输入框组件(Textarea)为用户提供了方便的多行文本输入功能,适用于各种场景,如评论框、消息输入框等。今天,我们将深入了解 Textarea 组件的使用方法、属性以及示例代码。一、组件概述Textarea 是华为鸿蒙系统中的多行文本...

cnzzs的博客 1176

鸿蒙5.0进阶开发:UI开发-自定义组件节点 (FrameNode)

对于拥有自定义前端的第三方框架(如JSON、XML、DOM树等),需将特定的DSL转换为ArkUI的声明式描述。

AyomQAQ的博客 1277

鸿蒙5.0开发进阶:自定义节点(FrameNode)

对于具备自己前端定义的三方框架,需要将特定的dsl转换成为ArkUI的声明式描述。

Androidbye的博客 1035

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:LoadingProgress)

ArkTS声明式开发(基础手势:LoadingProgress)

m0_64420071的博客 1644

【HarmonyOS 鸿蒙实战开发】全局自定义组件复用实现案例

本示例是 全局自定义组件复用实现 的示例代码,主要讲解如何通过BuilderNode创建全局的自定义组件复用池,实现跨页面的组件复用。

CTrup的博客 1738

鸿蒙5.0版开发:ArkUI框架开发-自定义占位节点

ArkUI提供了ArkTS原生组件作为自定义节点的占位节点。

m0_73088370的博客 609

HarmonyOS NEXT实战开发:FrameNode(自定义节点)

对于具备自己前端定义的三方框架,需要将特定的dsl转换成为ArkUI的声明式描述。

hanyanyou的博客 1039

鸿蒙HarmonyOS 5.0开发:ContentSlot:混合开发

用于渲染并管理Native层使用C-API创建的组件。

m0_73088370的博客 1202

鸿蒙5.0开发进阶:翻页动效实现案例

本例将介绍如何通过ArkUI提供的显示动画接口animateTo实现翻页的效果。

HSMMQAQ的博客 1108

鸿蒙HarmonyOS开发(5.0 Beta)NDK接口构建UI界面实践

NDK提供的UI组件能力如组件创建、树操作、属性设置、事件注册等是通过函数指针结构体(如ArkUI_NativeNodeAPI_1)进行暴露,该函数指针结构体可以通过模块查询接口获取。

yguyf1235的博客 1013

HarmonyOS 5.0应用开发——NodeContainer自定义占位节点

NodeContainer是用来占位的系统组件,主要用于自定义节点以及自定义节点树的显示,支持组件的通用属性,对通用属性的处理请参考默认左上角对齐的Stack组件。NodeController提供了一系列生命周期回调,通过makeNode回调返回一个 FrameNode 节点树的根节点。

高心星的专栏 1055

别再拿空气标定法糊弄了!手把手教你搞定水下相机标定(附Python代码)

本文详细解析水下相机标定的关键技术,揭示传统空气标定法失效原因,并提供基于单视点模型(SVP)的完整Python解决方案。通过折射效应分析、标定板设计优化和代码实战演示,帮助读者掌握水下标定核心方法,有效提升水下视觉系统测量精度。

weixin_30530939的博客 211
上一篇: 鸿蒙5.0开发进阶:UI框架使用手势事件(多层级手势事件)
下一篇: 鸿蒙5.0开发进阶:自定义节点(FrameNode)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值