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

鸿蒙5.0版开发:ArkTS组件通用属性-浮层 设置组件的浮层。 阅读详情

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


ComponentContent

ComponentContent表示组件内容的实体封装,其对象支持在非UI组件中创建与传递,便于开发者对弹窗类组件进行解耦封装。

说明

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

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

导入模块

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

ComponentContent

constructor

constructor(uiContext: UIContext, builder: WrappedBuilder<[]>)

ComponentContent的构造函数。

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

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

参数:

参数名类型必填说明
uiContextUIContext是创建对应节点时候所需要的UI上下文。
builderWrappedBuilder<[]>是封装不带参builder函数的WrappedBuilder对象。

constructor

constructor(uiContext: UIContext, builder: WrappedBuilder<[T]>, args: T)

ComponentContent的构造函数。

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

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

参数:

参数名类型必填说明
uiContextUIContext是创建对应节点时候所需要的UI上下文。
builderWrappedBuilder<[T]>是封装带参builder函数的WrappedBuilder对象。
argsT是WrappedBuilder对象封装的builder函数的参数。

constructor

constructor(uiContext: UIContext, builder: WrappedBuilder<[T]>, args: T, options: BuildOptions)

ComponentContent的构造函数。

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

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

参数:

参数名类型必填说明
uiContextUIContext是创建对应节点时候所需要的UI上下文。
builderWrappedBuilder<[T]>是封装带参builder函数的WrappedBuilder对象。
argsT是WrappedBuilder对象封装的builder函数的参数。
optionsBuildOptions是build的配置参数,判断是否支持@Builder中嵌套@Builder的行为。

示例:

import { ComponentContent, NodeContent, typeNode } from "@kit.ArkUI"

interface ParamsInterface {
text: string;
func: Function;
}

@Builder
function buildTextWithFunc(fun: Function) {
Text(fun())
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({ bottom: 36 })
}

@Builder
function buildText(params: ParamsInterface) {
Column() {
Text(params.text)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({ bottom: 36 })
buildTextWithFunc(params.func)
}
}

@Entry
@Component
struct Index {
@State message: string = "HELLO"
private content: NodeContent = new NodeContent();

build() {
Row() {
Column() {
Button('addComponentContent')
.onClick(() => {
let column = typeNode.createNode(this.getUIContext(), "Column");
column.initialize();
column.addComponentContent(new ComponentContent<ParamsInterface>(this.getUIContext(),
wrapBuilder<[ParamsInterface]>(buildText), {
text: this.message, func: () => {
return "FUNCTION"
}
}, { nestingBuilderSupported: true }))
this.content.addFrameNode(column);
})
ContentSlot(this.content)
}
.id("column")
.width('100%')
.height('100%')
}
.height('100%')
}
}

update

update(args: T): void

用于更新WrappedBuilder对象封装的builder函数参数,与constructor传入的参数类型保持一致。

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

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

参数:

参数名类型必填说明
argsT是用于更新WrappedBuilder对象封装的builder函数参数,与constructor传入的参数类型保持一致。

示例:

import { ComponentContent } from "@kit.ArkUI";

class Params {
text: string = ""
constructor(text: string) {
this.text = text;
}
}

@Builder
function buildText(params: Params) {
Column() {
Text(params.text)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({bottom: 36})
}.backgroundColor('#FFF0F0F0')
}

@Entry
@Component
struct Index {
@State message: string = "hello"

build() {
Row() {
Column() {
Button("click me")
.onClick(() => {
let uiContext = this.getUIContext();
let promptAction = uiContext.getPromptAction();
let contentNode = new ComponentContent(uiContext, wrapBuilder(buildText), new Params(this.message));
promptAction.openCustomDialog(contentNode);

setTimeout(() => {
contentNode.update(new Params("new message"));
}, 2000); //2秒后自动更新弹窗内容文本
})
}
.width('100%')
.height('100%')
}
.height('100%')
}
}

reuse

reuse(param?: Object): void

传递reuse事件到ComponentContent中的自定义组件。

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

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

参数:

参数名类型必填说明
paramObject否用于复用WrappedBuilder对象封装的builder函数参数,与constructor传入的参数类型保持一致。

recycle

recycle(): void

传递recycle事件到ComponentContent中的自定义组件。

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

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

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

class Params {
text: string = ""

constructor(text: string) {
this.text = text;
}
}

@Builder
function buildText(params: Params) {
ReusableChildComponent2({ text: params.text });
}

@Component
struct ReusableChildComponent2 {
@Prop text: string = "false";

aboutToReuse(params: Record<string, object>) {
console.log("ReusableChildComponent2 Reusable " + JSON.stringify(params));
}

aboutToRecycle(): void {
console.log("ReusableChildComponent2 aboutToRecycle " + this.text);
}

build() {
Column() {
Text(this.text)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({ bottom: 36 })
}.backgroundColor('#FFF0F0F0')
}
}

@Entry
@Component
struct Index {
@State message: string = "hello"

build() {
Row() {
Column() {
Button("click me")
.onClick(() => {
let uiContext = this.getUIContext();
let promptAction = uiContext.getPromptAction();
let contentNode = new ComponentContent(uiContext, wrapBuilder(buildText), new Params(this.message));
promptAction.openCustomDialog(contentNode);

setTimeout(() => {
contentNode.reuse(new Params("new message"));
contentNode.recycle();
}, 2000); //2秒后自动更新弹窗内容文本
})
}
.width('100%')
.height('100%')
}
.height('100%')
}
}

dispose

dispose(): void

立即释放当前ComponentContent,即ComponentContent对象与后端实体节点解除引用关系。

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

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

示例:

import { BusinessError } from '@kit.BasicServicesKit';
import { ComponentContent } from '@kit.ArkUI';

class Params {
text: string = ""
constructor(text: string) {
this.text = text;
}
}

@Builder
function buildText(params: Params) {
Column() {
Text(params.text)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({bottom: 36})
}.backgroundColor('#FFF0F0F0')
}

@Entry
@Component
struct Index {
@State message: string = "hello"

build() {
Row() {
Column() {
Button("click me")
.onClick(() => {
let uiContext = this.getUIContext();
let promptAction = uiContext.getPromptAction();
let contentNode = new ComponentContent(uiContext, wrapBuilder(buildText), new Params(this.message));
promptAction.openCustomDialog(contentNode);

setTimeout(() => {
promptAction.closeCustomDialog(contentNode)
.then(() => {
console.info('customdialog closed.')
if (contentNode !== null) {
contentNode.dispose(); //释放contentNode
}
}).catch((error: BusinessError) => {
let message = (error as BusinessError).message;
let code = (error as BusinessError).code;
console.error(`closeCustomDialog args error code is ${code}, message is ${message}`);
})
}, 2000); //2秒后自动关闭
})
}
.width('100%')
.height('100%')
}
.height('100%')
}
}

updateConfiguration

updateConfiguration(): void

传递系统环境变化事件,触发节点的全量更新。

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

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

说明

updateConfiguration接口功能为通知对象更新,更新所使用的系统环境由当前的系统环境变化。

示例:

import { NodeController, FrameNode, ComponentContent, typeNode } from '@kit.ArkUI';
import { AbilityConstant, Configuration, EnvironmentCallback } from '@kit.AbilityKit';

@Builder
function buildText() {
Column() {
Text('hello')
.width(50)
.height(50)
.fontColor($r(`app.color.text_color`))
}.backgroundColor($r(`app.color.start_window_background`))
}

const componentContentMap: Array<ComponentContent<[Object]>> = new Array();

class MyNodeController extends NodeController {
private rootNode: FrameNode | null = null;

makeNode(uiContext: UIContext): FrameNode | null {
return this.rootNode;
}

createNode(context: UIContext) {
this.rootNode = new FrameNode(context);
let component = new ComponentContent<Object>(context, wrapBuilder(buildText));
componentContentMap.push(component);
this.rootNode.addComponentContent(component);
}

deleteNode() {
let node = componentContentMap.pop();
this.rootNode?.dispose();
node?.dispose();
}
}

function updateColorMode() {
componentContentMap.forEach((value, index) => {
value.updateConfiguration();
})
}

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

aboutToAppear(): void {
let environmentCallback: EnvironmentCallback = {
onMemoryLevel: (level: AbilityConstant.MemoryLevel): void => {
console.log('onMemoryLevel');
},
onConfigurationUpdated: (config: Configuration): void => {
console.log('onConfigurationUpdated ' + JSON.stringify(config));
updateColorMode();
}
}
// 注册监听回调
this.getUIContext().getHostContext()?.getApplicationContext().on('environment', environmentCallback);
this.myNodeController.createNode(this.getUIContext());
}

aboutToDisappear(): void {
//移除map中的引用,并将自定义节点释放
this.myNodeController.deleteNode();
}

build() {
Row() {
NodeContainer(this.myNodeController);
}
}
}
 

HarmonyOS Next开发学习手册——使用NDK接口构建UI(嵌入ArkTS组件) ArkUI在Native侧提供的能力作为ArkTS的子集,部分能力不会在Native侧提供,如声明式UI语法,自定义struct组件,UI高级组件。 阅读详情

相关推荐

HarmonyOS核心知识点:使用NDK接口构建UI(嵌入ArkTS组件)

针对需要使用ArkTS侧独立能力的场景,ArkUI开发框架提供了Native侧嵌入ArkTS组件的能力,该能力依赖 ComponentContent 机制,通过ComponentContent完成对ArkTS组件的封装,然后将封装对象转递到Native侧,通过Native侧的 OH_ArkUI_GetNodeHandleFromNapiValue 接口转化为ArkUI_NodeHandle对象用于Native侧组件挂载使用。以下示例代码在 接入ArkTS页面 章节基础上引入ArkTS的Refresh组件。

wuliusan5的博客 839

HarmonyOS二:ArkTS基础知识-常用得装饰器

与@State有相同的语义,但初始化方式不同,不允许有初始化的值。@Prop装饰的变量必须使用其父组件提供的@State变量进行初始化,允许组件内部修改@Prop变量,但更改不会通知给父组件,即@Prop属于单向数据绑定。装饰的变量可以和父组件的@State变量建立双向数据绑定,需要注意的是:@Link变量不能在组件内部进行初始化。用来装饰某一类标签,括号内必须写上要装饰的标签名,例如:@Extend(Text)表示要该装饰器装饰的函数内部只能写与Text有关的样式设置,不能写其他无关的内容,否则会报错。

Yuan_Xiao_Tian_的博客 1188

HarmonyOS NEXT实战开发:嵌入ArkTS组件

ArkUI在Native侧提供的能力作为ArkTS的子集,部分能力不会在Native侧提供,如声明式UI语法,自定义struct组件,UI高级组件。

2401_87288236的博客 1652

Android无障碍服务监听实现自动点击按钮

通过监听窗口改变事件,监听目标应用,通过视图ID(或文本、或描述、或其他如坐标之类的)找到目标视图,使用无障碍动作点击方法点击它

侠亦狐的博客 2059

鸿蒙ArkTS实战开发-Native XComponent组件的使用

本篇Codelab主要介绍如何使用XComponent组件调用NAPI来创建EGL/GLES环境,实现在主页面绘制一个正方形,并可以改变正方形的颜色。本篇CodeLab使用Native C++模板创建。

2401_82546228的博客 2490

鸿蒙第16篇——数据持久化

本文介绍的数据持久化是指鸿蒙应用的数据持久化存储。它是将内存中的数据通过文件或数据库的形式保存到设备存储中。鸿蒙支持多种数据存储方式, 包括用户首选项Preferences、 键值型数据库KV-Store和关系型数据库。

daozhongyang的专栏 176

HarmonyOS:@Reusable装饰器:组件复用

@Reusable适用自定义组件,与@Component结合使用,标记为@Reusable的自定义组件从组件树上被移除时,组件和其对应的JSView对象都会被放入复用缓存中,后续创建新自定义组件节点时,会复用缓存区中的节点,节约组件重新创建的时间。

ChinaDragon10的博客 1316

计组实验5:cache大小测量与 cache line 大小测量

前言 今天做了实验5,通过 c 语言测 cache 参数。其实按理来说挺简单的,只是我们班没给代码,纯靠自己。听说别的班有给代码 emm 因为《深入理解计算机系统》这本书上面给的代码是 Linux 平台下的,而且需要一个 fcyc2 头文件,可以在 https://github.com/fabiensanglard/CpuCacheMountainViewer 这里找到。 ⚠ 我没有在 Linux 下试过课本上面的代码。。。 我是在 win10 下测试的。。。 所以 。。。 我并不确定我的代码是否正确。

AKGWSB 's blog 1万+

【鸿蒙next开发】ArkUI框架:UI界面-ComponentContent

本文详细介绍了鸿蒙5.0开发中的ComponentContent模块..........

m0_73088370的博客 823

别再硬啃理论了!用Simulink双脉冲实验,5分钟搞懂MOSFET二极管反向恢复

本文通过Simulink双脉冲实验仿真,帮助电力电子学习者快速理解MOSFET二极管反向恢复特性。文章详细介绍了实验搭建步骤、关键参数配置及波形解析,将抽象理论转化为可视波形,大幅提升学习效率。特别适合需要直观理解反向恢复过程的工程师和学生。

weixin_30918633的博客 957

解决AutoDock与Python版本冲突导致的内存泄漏问题:从BHtree *错误到环境配置优化

本文深入解析了AutoDock分子对接中常见的‘BHtree *’内存泄漏错误,其根源在于SWIG接口模块与Python运行环境的版本不匹配。文章提供了根治方案:通过构建Python 2.5.4与MGLTools 1.5.6的黄金兼容组合,并详细指导环境清理、安装配置及实战测试,从而彻底解决该内存泄漏问题,确保AutoDock工作流的稳定运行。

g5h6i的博客 1116

鸿蒙5.0版开发:ArkUI框架开发-嵌入ArkTS组件

ArkUI在Native侧提供的能力作为ArkTS的子集...........

m0_73088370的博客 1320

STM32 ADC精准采集12V电池电压:从分压电路到软件校准全解析

本文详细解析了STM32 ADC精准采集12V电池电压的全过程,涵盖分压电路设计、电阻选型、ADC配置优化及软件校准方法。针对电池电压监测中的噪声、温漂等挑战,提供了硬件滤波与软件过采样等实战技巧,确保测量精度达到1%以内,满足嵌入式设备对电源管理的严苛要求。

tech5的博客 1016

鸿蒙5.0开发进阶:使用NDK接口构建UI(嵌入ArkTS组件)

ArkUI在Native侧提供的能力作为ArkTS的子集........

Androidbye的博客 1212

告别黑窗口!用VSCode+Native Debug调试C/C++程序,比GDB命令行舒服多了

本文介绍了如何使用VSCode配合Native Debug扩展来调试C/C++程序,替代传统的GDB命令行方式。通过可视化调试环境,开发者可以更高效地管理断点、查看变量和调用栈,大幅提升调试效率。文章详细讲解了环境配置、核心调试功能及高级技巧,帮助开发者快速上手这一现代调试工具。

weixin_26833139的博客 251

深入IR2104数据手册:被忽略的SD引脚用法和死区时间调节实战

本文深入解析IR2104半桥驱动芯片的SD引脚用法和死区时间调节技巧,帮助硬件工程师优化电机控制和电源转换系统。通过详细的电路设计、实测数据和调试方法,揭示SD引脚的多重保护机制和死区时间的精密调节策略,提升系统安全性和效率。

weixin_30342363的博客 392

鸿蒙5.0开发实战案例:使用NDK接口构建UI(嵌入ArkTS组件)

针对需要使用ArkTS侧独立能力的场景,ArkUI开发框架提供了Native侧嵌入ArkTS组件的能力,该能力依赖 ComponentContent 机制,通过ComponentContent完成对ArkTS组件的封装,然后将封装对象转递到Native侧,通过Native侧的 OH_ArkUI_GetNodeHandleFromNapiValue 接口转化为ArkUI_NodeHandle对象用于Native侧组件挂载使用。以下示例代码在 接入ArkTS页面 章节基础上引入ArkTS的Refresh组件。

liudiaosi6的博客 834

7、RNA 二级结构预测:包含接吻发夹基序的新策略

本文提出三种用于预测RNA二级结构中接吻发夹基序的新策略,结合规范化规则与非歧义动态规划,分别在时间与空间复杂度之间进行权衡。策略A以O(n⁴)时间和O(n²)空间实现高效预测;策略B通过存储次优结果扩大搜索空间,空间复杂度升至O(n³);策略C全面探索组合可能,时间复杂度为O(n⁵),但保持O(n²)空间。实验表明不同策略适用于不同复杂度的序列,为RNA结构预测提供了灵活且可扩展的解决方案。

j7k8l的博客 133

鸿蒙5.0进阶开发:UI开发-嵌入ArkTS组件

ArkUI在Native侧提供的能力作为ArkTS的子集.........

AyomQAQ的博客 1211

GB28181 —— 3、C++编写GB28181设备端,完成注册、注销、保活心跳、响应查询目录等功能(附源码)

GB28181 —— Win10下编写GB28181设备端,完成注册、注销、保活心跳、响应查询目录等功能(附源码)

1311

怀旧版电脑GBC模拟器

再现原版GBC掌机的界面,电脑运行连游戏界面都一样大小,很怀旧,很真实,(英文版)强烈推荐,很小的文件,很难才找到的。

鸿蒙NEXT开发:ArkUI框架UI界面-Content

定义ComponentContent和NodeContent基类。

ZPYQAQ的博客 257

锂电池充电器电路设计 里面有电路

锂电池充电器电路设计 里面有电路 3.7V升压到5V电路设计。

HarmonyOS新特性-沉浸光感在叠叠消小游戏中的落地实践

本文分享了如何在叠叠消小游戏中使用HarmonyOS NEXT的沉浸光感(Immersive Light Sensing)技术优化UI体验。重点改造了三个核心场景:1)游戏页标题栏实现渐变模糊和动态显隐;2)底部操作栏改为悬浮胶囊式毛玻璃效果并支持左右手自适应;3)弹窗系统加入毛玻璃背景。文章详细介绍了沉浸光感的API、材质档位选择,以及具体实现过程中的关键属性和代码优化方案,为鸿蒙应用开发者提供了实用的UI质感提升参考。

邵东的博客 323

蓝牙模块HM-10手册

蓝牙模块HM-10手册,该手册对蓝牙模块HM-10进行了详细的介绍和使用方法以及一些AT指令。

温度PID控制PLC程序

温度PID稳定控制程序,适用于欧姆龙PLC,对其他PLC也具有很大参考价值

自定义组件封装:构建高复用性的业务组件库(24)

适用场景:当需要复用的不仅是 UI 样式,还包含特定的布局结构和业务逻辑时(例如:一个由 Image + Text 垂直排列组成的图文复合组件),应将其封装为自定义组件。实现方式使用@Component装饰器定义组件,在内部实现不变的布局结构。将可能变化的部分(如文本内容、图片资源、点击事件等)作为参数变量暴露出来。进阶复用:为了让外部使用者能够灵活定制内部子组件的样式,可以在封装组件的变量中添加类型的参数。这样,外部调用方既可以直接传入数据,也可以通过传入Modifier实例来修改内部子组件的样式。

Davina_yu的博客 428

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

用于EmbeddedUIExtensionAbility(或UIExtensionAbility)中获取宿主应用的窗口信息或对应的EmbeddedComponent组件的信息。

Androidbye的博客 840

HarmonyOS API 26 Navigation路由栈上限:stackSizeLimit、过载保护与容量观测

解析API 26 NavigationConfiguration.stackSizeLimit的活跃页面节点限制,并用入口节流、容量水位、降级策略和纯函数测试治理深栈风险。

2401_84996024的博客 350

React Native 鸿蒙端侧 OCR 实战:TurboModule 与纯 TS 引擎的逐字契约

本文以鸿蒙真机上的 React Native 0.84 工程为例,详解三大难题:通过 TurboModule 接入 HarmonyOS Core Vision Kit 实现端侧离线 OCR;规避 Metro 预置头导致的 require 不存在问题;实现 npm 包与 HAR 双形态交付。项目采用 codegen 生成 ArkTS 接口,结合纯 TS 回退引擎,确保跨引擎逐字符一致,并通过 autolinking 支持无缝集成。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 106
上一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面(ArkUI)-BuilderNode
下一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面(ArkUI)-NodeController
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值