鸿蒙5.0开发进阶:ArkTS API UI界面(ArkUI)-NodeController

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

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


NodeController

NodeController用于实现自定义节点的创建、显示、更新等操作的管理,并负责将自定义节点挂载到NodeContainer上。

说明

本模块首批接口从API version 11开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

当前不支持在预览器中使用NodeController。

导入模块

import {  NodeController  } from '@kit.ArkUI';

NodeController

通常搭配NodeContainer进行使用。用于创建控制器管理绑定的NodeContainer组件。一个NodeController只允许与一个NodeContainer进行绑定。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

makeNode

abstract makeNode(uiContext : UIContext): FrameNode | null

当实例绑定的NodeContainer创建的时候进行回调。回调方法将返回一个节点,将该节点挂载至NodeContainer。

或者可以通过NodeController的rebuild()方法进行回调的触发。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
uiContextUIContext是回调该方法的时候,绑定NodeContainer的UI上下文。

返回值:

类型说明
FrameNode| null一个FrameNode对象,返回的节点将被挂载至NodeContainer的占位节点上。若返回null对象,将清空对应NodeContainer的子节点。

aboutToAppear

aboutToAppear?(): void

当NodeController绑定的NodeContainer挂载显示后触发此回调。

说明

回调时机参考onAppear。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

aboutToDisappear

aboutToDisappear?(): void

当NodeController绑定的NodeContainer卸载消失时触发此回调。

说明

回调时机参考onDisAppear。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

aboutToResize

aboutToResize?(size: Size): void

当NodeController绑定的NodeContainer布局的时候触发此回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
sizeSize是用于返回组件布局大小的宽和高,单位为vp。

onTouchEvent

onTouchEvent?(event: TouchEvent): void

当NodeController绑定的NodeContainer收到Touch事件时触发此回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
eventTouchEvent是触摸事件。

rebuild

rebuild(): void

调用此接口通知NodeContainer组件重新回调makeNode方法,更改子节点。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

说明

由于rebuild方法为应用主动调用的方法,且该操作与UI相关。需要开发者自行保证调用该接口时UI上下文有效,即与绑定的NodeContainer保持UI上下文一致。

监听回调等UI上下文不明确时,可以通过UIContext的runScopedTask方法明确调用时的UI上下文。

示例

通过NodeController挂载BuilderNode节点。

import {  NodeController, BuilderNode, Size, FrameNode ,UIContext } from '@kit.ArkUI';

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

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

class MyNodeController extends NodeController {
  private buttonNode: BuilderNode<[Params]> | null = null;
  private wrapBuilder: WrappedBuilder<[Params]> = wrapBuilder(buttonBuilder);

  makeNode(uiContext: UIContext): FrameNode {
    if (this.buttonNode == null) {
      this.buttonNode = new BuilderNode(uiContext);
      this.buttonNode.build(this.wrapBuilder, { text: "This is a Button" })
    }
    return this.buttonNode!.getFrameNode()!;
  }

  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");
  }
}

@Entry
@Component
struct Index {
  private myNodeController: MyNodeController = new MyNodeController();

  build() {
    Column() {
      NodeContainer(this.myNodeController)
    }
    .padding({ left: 35, right: 35, top: 35 })
    .width("100%")
    .height("100%")
  }
}

纯血鸿蒙APP实战开发——手写绘制及保存图片 本示例使用drawing库的Pen和Path结合NodeContainer组件实现手写绘制功能。手写板上完成绘制后,通过调用image库的packToFile和packing接口将手写板的绘制内容保存为图片,并将图片文件保存在应用沙箱路径中。如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。 阅读详情

相关推荐

鸿蒙5.0版开发:ArkTS组件-NodeContainer

基础组件,不支持尾随添加子节点。

m0_69424697的博客 613

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

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

wu1004019946的博客 2119

HarmonyOS Next开发学习手册——使用自定义能力

自定义节点是ArkUI框架通过接口提供了底层实体节点部分基础能力的节点对象,这些节点能够与原生控件进行混合显示。自定义节点的挂载和显示需要依赖 自定义占位节点。现有的自定义节点包括 FrameNode 、 RenderNode 、 BuilderNode 三类对象。FrameNode表示了单个的自定义组件节点,RenderNode表示更加轻量级的渲染节点,BuilderNode对象提供了能够创建、更新原生组件以及组件树的能力。自定义占位节点作为原生组件可以在原生组件树上为自定义节点提供挂载的点。

maniuT的博客 1499

鸿蒙API13开发【NodeController】UI界面API

NodeController用于实现自定义节点的创建、显示、更新等操作的管理,并负责将自定义节点挂载到[NodeContainer]上。

鸿蒙的技术博客 1272

鸿蒙HarmonyOS开发指南:UI动态操作基础用法规范

本文详细介绍了UI动态操作的基本用法,着重介绍了BuilderNode自定义节点和NodeController生命周期等内容。结合这些基础用法,提供了三方广告的场景案例作为参考。案例展示了如何使用UI动态操作实现三方广告,其最后的实现效果图如下所示。

DMZDAMS的博客 2029

HarmonyOS开发实战:全局自定义组件复用实现规范

父组件承载了复杂的带状态的业务逻辑,而builder是无状态的,修改会导致难以维护,因此开发者可以使用BuilderNode自行管理组件复用池。

DMZDAMS的博客 1548

鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.arkui.node

Node将自定义节点的二级模块API组织在一起,方便开发者进行导出使用。

Androidbye的博客 582

CentOS 9 Stream 上安装 MySQL 8.0+

根据提示进行设置,包括设置新的 root 密码、禁用远程 root 登录等。MySQL 在首次安装时会生成一个临时密码。这样就完成了 MySQL 8.0.37 的安装。这将安装最新的 MySQL 8.0 版本。

小强不是坑 1681

【鸿蒙next开发】ArkUI框架:ArkTS组件-NodeContainer

本文通过代码示例演示了如何通过NodeController挂载BuilderNode节点,包含Flex布局、Text和Button组件的构建过程。

m0_73088370的博客 448

解决OpenCASCADE性能瓶颈:显示加速与三角剖分优化全攻略

本文深入探讨OpenCASCADE在工业设计和CAD建模中的性能优化策略,重点解决显示加速与三角剖分等核心瓶颈问题。通过智能刷新控制、显示数据结构优化和动态LOD技术,显著提升渲染效率和交互体验,适用于复杂场景下的三维可视化应用。

weixin_30752699的博客 344

别再死记硬背HJB方程了!用Python数值求解一个简单最优控制问题(附完整代码)

本文通过Python数值求解Hamilton-Jacobi-Bellman(HJB)方程,帮助读者从工程实践角度理解最优控制问题。教程涵盖从建立简单车辆控制模型到离散化HJB方程、实现值迭代算法及可视化结果的完整流程,适合具备Python基础的开发者学习。

weixin_42520796的博客 371

鸿蒙6.1 @ohos.animator动画器坑:import真路径@kit.ArkUI不是@ohos.animator

鸿蒙 6.1 API 23 @ohos.animator 动画器坑:import 真路径是 @kit.ArkUI 不是 @ohos.animator(Animator namespace as ani

ConanYao的博客 263

Python爬虫实战:基于Playwright与异步技术的专利数据抓取系统

专利数据是企业技术创新、市场竞争分析和行业趋势预测的关键情报来源。然而,专利数据通常分散在各个国家的专利局网站,数据结构复杂,反爬机制严格,使得高效抓取成为技术挑战。本文将详细介绍如何构建一个基于最新Python技术的专利数据抓取系统,涵盖Selenium的现代化替代方案Playwright、异步编程、智能代理轮换等高级技术。

2201_76125261的博客 1564

HarmonyOS应用开发实战:小事记 - 共享元素转场(一镜到底):geometryTransition 实现详情页无缝过渡

本文介绍HarmonyOS中共享元素转场(一镜到底)的实现方法,重点讲解geometryTransition API的使用。通过对比三种实现方式的差异,分析geometryTransition的工作原理:通过绑定相同ID自动计算组件位置和大小差异,生成平滑过渡动画。文章提供完整代码示例,展示如何在首页卡片和详情页中绑定共享元素ID,并解决常见问题如动画不自然等。该技术可实现点击卡片平滑展开为详情页的效果,提升用户体验。

少湖说 407

14、深入解析Sigma - Delta调制算法:从原理到应用

本博客深入解析了Sigma-Delta调制(SDM)算法的原理与应用,特别是在Super Audio CD(SA-CD)音频编码中的作用。文章探讨了传统SDM的局限性,并介绍了一系列改进型前瞻式SDM技术,如Trellis Sigma-Delta调制、高效网格Sigma-Delta调制和修剪树Sigma-Delta调制。这些技术通过降低计算复杂度和提升信号转换质量,在音频处理和无损数据压缩领域展现出巨大潜力。此外,博客还对不同SDM技术进行了性能比较,并分析了如何实现最大信噪比(SNR),为未来音频技术和数

tgb34567890的博客 425

影像组学文章复现:ITHscore:通过多尺度放射学特征全面定量NSCLC肿瘤内异质性 ----小细胞肺癌肿瘤异质性评分

目的:通过计算机断层扫描(CT)图像量化非小细胞肺癌(NSCLC)的肿瘤内异质性(ITH)。 方法:整合局部辐射特征和全局像素分布模式,开发定量ITH测量-ITHscore。在六个患者队列(n = 1399)中检查ITHscore与肿瘤表型,基因型和患者预后的关联,以验证其在表征ITH方面的有效性。

xxx 1023

鸿蒙6.1 promptAction坑:showToast废迁getPromptAction+ToastType enum非字符串

本文是「鸿蒙 6.1 API 23 开发坑系列」第 10 篇(非 UI 系第 4 篇)。本篇讲 @ohos.promptAction namespace(API 9+,鸿蒙 6.1 API 23 基座

ConanYao的博客 403

OpenClaw进阶实战(二十五):抖音企业号——私信回复与视频评论分析

摘要:本文介绍抖音企业号自动化运营方案,突破抖音强风控体系的技术挑战。针对内容生产、私信互动和账号矩阵三大场景,提出混合架构解决方案: 私信自动化:结合关键词触发与随机延迟(45秒±15),实现拟人化回复,支持价格咨询/商务合作等高优先级消息识别 混合技术栈:官方API(合规)+真机RPA(覆盖长尾需求)+AI辅助生成(脚本→剪辑→发布闭环) 安全策略:通过设备指纹模拟、行为间隔随机化和内容差异化处理规避风控,提供每日200条的安全操作阈值。配套OpenClaw技能实现一键部署,包含cookie配置、回复规

PeterPan的博客 145

鸿蒙6.1 @ohos.router坑:push/replace废迁pushUrl/replaceUrl+RouterMode enum非字符串

本文是「鸿蒙 6.1 API 23 开发坑系列」第 9 篇(非 UI 系第 3 篇)。本篇讲 @ohos.router namespace(API 8+,鸿蒙 6.1 API 23 基座)——页面路由

ConanYao的博客 297

高通开发系列 - Camera之摄像头调试记录

记录一些调试内容

fulinux的博客 1220

IMSL CNL 7.0.0 (x86-64)Crack

IMSL CNL 7.0.0 (x86-64)Crack intel的算法库破解文件,这是C++版本的破解文件

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

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

高心星的专栏 1055

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

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

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

maniuT的博客 1951

贝叶斯统计 [韦来生编]

贝叶斯(Bayes)统计是近几十年来迅速发展起来的数理统计的一个重要分支。贝叶斯方法与经典统计方法的主要不同之处是进行统计推断时除了利用样本信息外,还要利用参数的先验信息,因此可以提高统计推断或统计决策的效果。它在经济、金融、生物、医学、自然科学和社会科学等许多领域具有广泛的应用。贝叶斯方法的研究已渗透到了统计学的几乎所有领域。作者在给中国科学技术大学概率论与数理统计专业本科生开设的“数理统计”课程中有一章专门讲授“贝叶斯方法和统计决策理论”,近十年来也给中国科学技术大学概率统计专业研究生开设过几次“贝叶斯分析”课。本书是在对过去讲稿的内容作了适当的增减和调整的基础上完成的。  本书共分六章。第1章是绪论,介绍了贝叶斯统计的若干基本概念,同时对必要的数理统计的基础知识有重点地作了回顾。第二章介绍了确定先验分布的若干可供选择的方法。第三章介绍了几类常见统计模型参数的后验分布的主要结果和计算方法。第四章和第五章分别介绍了“贝叶斯统计推断”和“贝叶斯统计决策”的内容。第六章介绍了贝叶斯统计计算的若干方法,包括蒙特卡洛方法和马尔可夫链蒙特卡洛(MCMC)方法以及相关统计软件的简介。本书的每一章附右大量的例题和习题,书末附有常用的几个表格和部分习题解答供读者查用。  大约可在54学时内讲授本书的第1章至第六章的主要内容,教师可根据学时需要选讲本书第1章至第六章的部分内容。书中标“*”号的章节可略去不讲,留给读者作为阅读材料。第六章例题中的R代码和部分例题的数据文件等可从作者个人主页下载。  作者在编写本书的过程中参考了J.O.Berger教授的《统计决策论及贝叶斯分析》和茆诗松教授编写的《贝叶斯统计》等书中的一些内容,以及《贝叶斯分析》一书中由张伟平博士编写的有关贝叶斯统计计算的一些内容。在此表示衷心感谢。  本书编写准备过程中,中国科学技术大学统计与金融系的几个研究生帮助完成了本书部分中文的录入和排版,作者对他们的辛勤工作表示真诚的感谢。高等教育出版社为本书的出版给予了大力支持。在此一并致谢。

迈瑞BS系列全自动生化分析仪LIS协议接口手册(内含HL7和ASTM)

迈瑞BS系列全自动生化分析仪LIS协议接口手册,内含HL7和ASTM)

Kubernetes--Node Controller

kubelet进程在启动时通过API Server注册自身节点信息,并定时向API Server汇报状态信息,API Server在接收到这些信息后,将这些信息更新到etcd中。在etcd中存储的节点信息包括节点健康状况、节点资源、节点名称、节点地址信息、操作系统版本、Docker版本、kubelet版本等。 节点健康状况包括就绪(True)、未就绪(False)、未知(Unkown)三种。 Node Controller通过API Server实时获取Node的相关信息,实现管理和监控集...

GaoChuang_的博客 1197

纯血鸿蒙实战开发-Web组件开发性能提升指导

开发者实现在应用中跳转显示网页需要分为两个方面:使用@ohos.web.webview提供Web控制能力;使用Web组件提供网页显示的能力。在实际应用中往往由于各种原因导致首次跳转Web网页或Web组件内跳转时出现白屏、卡顿等情况。本文介绍提升Web首页加载与Web网页间跳转速度的几种方法。

2401_82546228的博客 1283

【HarmonyOS NEXT】build方法里如何避免使用过多的if else判断语句

在楼层列表页面,根据后台模版参数,需要展示不同的楼层组件。大概有50-60个模版,现在只能在ForEach里面写很多个if else来展示不同的楼层组件,有没有更高效、更简洁的方式实现?动态构建组件树可以避免使用过多的判断语句,创建组件时可以向buttonBuilder传参,即可动态生成一个组件,不传参时即为空,对比多判断语句来说,相对比较方便。多判断语句替代方式 / 动态构建组件树 / @ohos.arkui.node。

Mayism123的博客 528
上一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面(ArkUI)-ComponentContent
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(点击事件)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值