HarmonyOS NEXT - @Component自定义组件
ccwgpt 2025-04-05 17:19 14 浏览 0 评论
在ArkUI中，UI显示的内容均为组件，由框架直接提供的称为系统组件，由开发者定义的称为自定义组件。在进行 UI 界面开发时，通常不是简单的将系统组件进行组合使用，而是需要考虑代码可复用性、业务逻辑与UI分离，后续版本演进等因素。因此，将UI和部分业务逻辑封装成自定义组件是不可或缺的能力。
自定义组件具有以下特点：
- 可组合：允许开发者组合使用系统组件、及其属性和方法。
- 可重用：自定义组件可以被其他组件重用，并作为不同的实例在不同的父组件或容器中使用。
- 数据驱动UI更新：通过状态变量的改变，来驱动UI的刷新。
定义
```typescript
@Component
struct componentName {
}
```
- 通过export导出自定义组件
- 通过import导入自定义组件
自定义组件的基本结构
- struct：自定义组件基于struct实现，struct + 自定义组件名 + {...}的组合构成自定义组件，不能有继承关系。对于struct的实例化，可以省略new。
- @Component装饰器仅能装饰struct关键字声明的数据结构。struct被@Component装饰后具备组件化的能力，需要实现build方法描述UI，一个struct只能被一个@Component装饰。@Component可以接受一个可选的bool类型参数。
- build()函数用于定义自定义组件的声明式UI描述，自定义组件必须定义build()函数。
- @Entry装饰的自定义组件将作为UI页面的入口。在单个UI页面中，最多可以使用@Entry装饰一个自定义组件。@Entry可以接受一个可选的LocalStorage的参数。
- @Reusable装饰的自定义组件具备可复用能力。
成员函数/变量
自定义组件除了必须要实现build()函数外，还可以实现其他成员函数，成员函数具有以下约束：自定义组件的成员函数为私有的，且不建议声明成静态函数。
自定义组件可以包含成员变量，成员变量具有以下约束：
- 自定义组件的成员变量为私有的，且不建议声明成静态变量。
- 自定义组件的成员变量本地初始化有些是可选的，有些是必选的。具体是否需要本地初始化，是否需要从父组件通过参数传递初始化子组件的成员变量，请参考状态管理。
代码实例
```typescript
import { Home } from './components/Home';
import { Person } from './components/Person';
@Entry
@Component
struct ComponentPage {
@State message: string = '第3节 @Component自定义组件';
build() {
Column() {
Text(this.message)
.fontSize(20)
.fontWeight(FontWeight.Bold)
Tabs() {
TabContent() {
//通过自定义组件模块化开发
Home({message:'你好'})
}.tabBar('首页')
TabContent() {
Person({data:'hello'})
}.tabBar('个人中心')
}
}
.height('100%')
.width('100%')
}
}
```
相关推荐
- Python+ Appium:Android手机连接与操作详解(附源码)
-
在移动端自动化测试领域，Appium一直是最热门的开源工具之一。今天这篇文章，我们聚焦Android端自动化测试的完整流程，从环境配置到代码实战，一步一步带你掌握用Python控制Android...
- 全平台开源即时通讯IM框架MobileIMSDK开发指南，支持鸿蒙NEXT
-
写在前面在着手基于MobileIMSDK开发自已的即时通讯应用前，建议以Demo工程为脚手架，快速上手MobileIMSDK！Demo工程主要用于演示SDK的API调用等，它位于SDK完整下载包的如下...
- 移动开发(一):使用.NET MAUI开发第一个安卓APP
-
对于工作多年的C#程序员来说，近来想尝试开发一款安卓APP，考虑了很久最终选择使用.NETMAUI这个微软官方的框架来尝试体验开发安卓APP，毕竟是使用VisualStudio开发工具，使用起来也...
- 在安卓系统上开发一款软件详细的流程
-
安卓app软件开发流程是一个系统而复杂的过程，涉及多个阶段和环节。以下是一个典型的安卓软件开发流程概述：1.需求分析目的：了解用户需求，确定APP的目标、功能、特性和预期效果。活动：开发团队与客户进...
- ArkUI-X在Android上使用Fragment开发指南
-
本文介绍将ArkUI框架的UIAbility跨平台部署至Android平台Fragment的使用说明，实现Android原生Fragment和ArkUI跨平台Fragment的混合开发，方便开发者灵活...
- Web3开发者必须要知道的6个框架与开发工具
-
在Web3领域，随着去中心化应用和区块链的兴起，开发者们需要掌握适用于这一新兴技术的框架与开发工具。这些工具和框架能够提供简化开发流程、增强安全性以及提供更好的用户体验。1.Truffle：Truff...
- Python开发web指南之创建你的RESTful APP
-
上回我们说到了：PythonFlask开发web指南：创建RESTAPI。我们知道了Flask是一个web轻量级框架，可以在上面做一些扩展，我们还用Flask创建了API，也说到了...
- python的web开发框架有哪些（python主流web框架）
-
python在web开发方面有着广泛的应用。鉴于各种各样的框架，对于开发者来说如何选择将成为一个问题。为此，我特此对比较常见的几种框架从性能、使用感受以及应用情况进行一个粗略的分析。 1Dja...
- Qwik:革新Web开发的新框架（webview开源框架）
-
听说关注我的人，都实现了财富自由！你还在等什么？赶紧加入我们，一起走向人生巅峰！Qwik：革新Web开发的新框架Qwik橫空出世：一场颠覆前端格局的革命？是炒作还是未来？前端框架的更新迭代速度，如同...
- Python中Web开发框架有哪些?（python主流web框架）
-
Python为Web开发提供了许多优秀的框架。以下是一些流行的PythonWeb框架：1.Django：一个高级的Web框架，旨在快速开发干净、实用的Web应用。Django遵...
- WPF 工业自动化数据管控框架，支持热拔插 DLL与多语言实现
-
前言工业自动化开发中，设备数据的采集、处理与管理成为提升生产效率和实现智能制造的关键环节。为了简化开发流程、提高系统的灵活性与可维护性，StarRyEdgeFramework应运而生。该框架专注...
- [汇川PLC] 汇川IFA程序框架06-建立气缸控制FB块
-
前言：汇川的iFA要跟西门子对标啦，这可是新的选择！就在2月14日，汇川刚发布的iFA平台，一眼就能看出来是对标西门子的全集成自动化平台博途（TIAPortal）。这个平台能在同一个...
- 微软发布.NET 10首个预览版:JIT编译器再进化、跨平台开发更流畅
-
IT之家2月26日消息，微软.NET团队昨日（2月25日）发布博文，宣布推出.NET10首个预览版更新，重点改进.NETRuntime、SDK、libraries、C#、AS...
- 大模型部署革命:GGUF量化+vLLM推理的极致性能调优方案
-
本文较长，建议点赞收藏，以免遗失。更多AI大模型应用开发学习视频及资料，尽在官网-聚客AI学院大模型应用开发微调项目实践课程学习平台一、模型微调核心概念与技术演进1.1微调的本质与优势数学表达：1....
- 拓扑学到底在研究什么?（拓扑学到底在研究什么问题）
-
拓扑是“不量尺寸的几何学”，那么它的核心内容，主要方法是什么？如果你问罗巴切夫斯基，他会说“附贴性是物体的一个特殊的属性。如果我们把这个性质掌握，而把物体其他的一切属性，不问是本质的或偶然出现的，均不...
欢迎 你 发表评论:
- 一周热门
- 最近发表
-
- Python+ Appium:Android手机连接与操作详解(附源码)
- 全平台开源即时通讯IM框架MobileIMSDK开发指南，支持鸿蒙NEXT
- 移动开发(一):使用.NET MAUI开发第一个安卓APP
- 在安卓系统上开发一款软件详细的流程
- ArkUI-X在Android上使用Fragment开发指南
- Web3开发者必须要知道的6个框架与开发工具
- Python开发web指南之创建你的RESTful APP
- python的web开发框架有哪些（python主流web框架）
- Qwik:革新Web开发的新框架（webview开源框架）
- Python中Web开发框架有哪些?（python主流web框架）
- 标签列表
-
- MVC框架 (46)
- spring框架 (46)
- 框架图 (58)
- flask框架 (53)
- quartz框架 (51)
- abp框架 (47)
- jpa框架 (47)
- laravel框架 (46)
- springmvc框架 (49)
- 分布式事务框架 (65)
- scrapy框架 (56)
- shiro框架 (61)
- 定时任务框架 (56)
- java日志框架 (61)
- JAVA集合框架 (47)
- grpc框架 (55)
- ppt框架 (48)
- 内联框架 (52)
- winform框架 (46)
- gui框架 (44)
- cad怎么画框架 (58)
- ps怎么画框架 (47)
- ssm框架实现登录注册 (49)
- oracle字符串长度 (48)
- oracle提交事务 (47)