尧图网站建设 尧图网络
  • 首页
  • 关于我们
  • 服务项目
  • 案例展示
  • 建站流程
  • 资讯中心
  • 联系我们
首页/资讯中心/详情

鸿蒙应用开发从入门到实战(八):ArkTS自定义组件语法

鸿蒙应用开发从入门到实战(八):ArkTS自定义组件语法
📅 发布时间:2026/6/22 18:42:01
ArkUI除系统预置的组件外,还支持自定义组件。使用自定义组件,可使代码的结构更加清晰,并且能提高代码的复用性。
 **大家好,我是潘Sir,持续分享IT技术,帮你少走弯路。《鸿蒙应用开发从入门到项目实战》系列文章持续更新中,陆续更新AI+编程、企业级项目实战等原创内容、欢迎关注!**	

​ 除去系统预置的组件外,ArkTS 还支持自定义组件。使用自定义组件,可使代码的结构更加清晰,并且能提高代码的复用性。

一、自定义组件语法

自定义组件的语法如下图所示

1自定义组件语法

各部分语法说明如下:

  • struct关键字

struct是ArkTS新增的用于自定义组件或者自定义弹窗的关键字。其声明的数据结构和TS中的类十分相似,可包含属性和方法。

  • build方法

build()方法用于声明自定义组件的UI结构。

  • 组件属性

组件属性可用作自定义组件的参数,使得自定义组件更为通用。

  • @Compnent装饰器

@Component装饰器用于装饰struct关键字声明的数据结构。struct被@Component装饰后才具备组件化的能力。

注: 装饰器是Typescript中的一种特殊语法,常用于装饰类、方法、属性,用于修改或扩展其原有的行为。

在学完自定义组件的语法之后,我们会发现前文案例中的每个页面实际上都是一个自定义组件。但是和自定义组件的语法相比,前边的每个案例还会多出一个@Entry装饰器,那@Entry的作用又是啥呢?

在鸿蒙应用中,每个页面都是由一些列组件组合而成的,并且这些组件都是逐层嵌套的,因此这些组件最终形成了一个组件树的结构,如下图所示
2组件树

​ 我们前边所编写的每个页面就相当于是组件树的根节点,而@Entry装饰器的作用就是标识该组件为组件树的根节点,也就是一个页面的入口组件。

二、自定义组件案例

​ 现在需要对前文的开/关灯的案例做出如下改造,由于两个按钮的结构十分相似,所以可考虑自定义一个按钮组件,然后进行复用。

​ 自定义组件可以放在文件内,也可以单独成一个文件

文件内:

@Entry
@Component
// 自定义组件
struct CustomCom {@State isOpen: boolean = falsebuild() {Column({space:50}) {if (this.isOpen) {Image('pages/imgs/light-on.png').height(300).width(300)}else {Image('pages/imgs/light-off.png').height(300).width(300)}Row({space:50}){CustomButton({text:'Open',color:Color.Red}) //自定义组件传参.onClick(()=>{this.isOpen=false})Button('Open').onClick(()=>{this.isOpen=true})}}.width('100%').width('100%').justifyContent(FlexAlign.Center)}
}@Component
struct CustomButton {text:String ='Close'  //接收参数color:Color =Color.Bluebuild() {Button(this.text.toString()).backgroundColor(this.color)}
}

单独文件:

新建ArkTS文件,将自定义组件内容拷贝

@Component
export  struct CustomButton {text:String ='Close'  //接收参数color:Color =Color.Bluebuild() {Button(this.text.toString()).backgroundColor(this.color)}
}

在要使用的文件中引入:

import { CustomButton } from './CumtomButton'

光标置于报错处,alt+回车,选择导入类即可

《鸿蒙应用开发从入门到项目实战》系列文章持续更新中,陆续更新AI+编程、企业级项目实战等原创内容,防止迷路,欢迎关注!


作者:黑马腾云
微信公众账号:自学帮
博客园:黑马腾云博客
如果你想及时得到个人撰写文章以及著作的消息推送,或者想看看个人推荐的技术资料,可以扫描左边二维码(或者长按识别二维码)关注微信公众号)。
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

相关新闻

  • 动态黑名单的运作机制与实时防护策略
  • 微服务分布式事务解决方案梳理 - 指南
  • JS对象池

最新新闻

  • 02-数字孪生三大厂商2026最新技术布局深度解析
  • 如何用WeChatMsg将微信聊天记忆变成永久数字财富?
  • foobar2000终极美化指南:5分钟打造专业音乐播放界面
  • 5个必装插件!让ComfyUI AI绘画工作流效率翻倍的终极指南
  • 计算机视觉(实训一)
  • 从零开始掌握SiYuan笔记:5个实用技巧让你的知识管理更高效

日新闻

  • Arduino-ESP32项目深度解析:解锁隐藏芯片支持与架构演进
  • 2026年 系统窗厂家/品牌推荐榜单:隔音系统窗+高端系统门窗的核心优势与选购指南 - 品牌发掘
  • NVBench:首个双语非言语发声语音合成评测基准详解与实践

周新闻

  • Visual C++运行库修复终极指南:5分钟快速解决Windows软件启动错误
  • 手把手教你构建统计局地区经济数据爬虫:从环境搭建到数据持久化全指南
  • 2026多Agent深度解析:用AI团队替代单一模型,四种架构实战落地

月新闻

  • 【总结】入门篇:50句话让你记住架构核心概念
  • WeChatMsg技术方案解析:实现Mac微信数据自主管理的完整解决方案
  • WeChatMsg:革新性微信数据备份方案,打造你的专属数字记忆库

关于尧图

  • 公司简介
  • 团队介绍
  • 企业文化
  • 荣誉资质

服务项目

  • 定制开发
  • 电商建站
  • UI 设计
  • 运维服务

快速链接

  • 案例展示
  • 建站流程
  • 常见问题
  • 资讯中心

联系方式

  • 📍北京市朝阳区互联网产业园 A 座 10 层
  • 📞400-888-8888
  • ✉️contact@rkmt.cn
  • 🕐周一至周日 9:00-21:00

© 2024 北京尧图网络科技有限公司 版权所有 | 京 ICP 备 XXXXXXXX 号