鸿蒙中常用的修饰符汇总

原创 已于 2025-05-11 17:36:24 修改 · 370 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#typescript #鸿蒙

于 2025-05-11 17:33:56 首次发布

●@Entry- 修饰成为页面
●@Component -修饰成为组件
●@Preview - 让组件可预览
●@State - 在组件内部定义响应式数据- 必须给初始值
●@Prop- 接收父组件的响应式数据- 可以给初始值 也可以不给
●@Builder- 声明轻量复用UI
●@BuilderParam - 接收传入的轻量复用UI- 可以给初始值 也可以不给（如果不给的话，调用时需要判断）
●@CustomDialog- 修饰自定义弹层
●@Styles- 定义组件复用样式-不允许传参数，可以定义在组件内或全局
●@Extend- 修饰某个特定组件的样式复用集合- 允许传参数，仅支持在全局定义，不支持在组件内部定义
●@Link- 可以实现父-子的双向绑定- 注意： $$值得是组件内的双向绑定, $$同样可以实现和Link绑定（必须不能给初始值）
●@LocalStorageProp 单向读取LocalStorage共享的属性（必须给初始值）
●@LocalStorageLink 。双向读取LocalStorage共享的属性 必须给初始值）

●@StorageProp 单向读取AppStorage共享的属性必须给初始值

●@StorageLink 双向读取AppStorage共享的属性必须给初始值
新增- API11新增
●@Require装饰器：校验构造传参
●@Track- 用来标记一个对象中哪些字段可以被更新和使用-如果一个Track都没有，那无所谓，只要有一个Track， 只有被track标记的字段才可以被使用
●@ObjectLink- 它可以实现局部的数据更新-但是必须和Observed修饰的class配合使用，不能在Entry修饰的组件中使用ObjectLink，场景是子组件想要局部组件更新

●@Watch-用于监听状态变量的变化，当状态变量变化时，@Watch的回调方法将被调用。遵循状态变量前后严格相等===。第一次初始化不会执行

●@AnimatableExtend装饰器：定义不可动画属性可动画化，达到自定义可动画效果

hcty01
关注
【鸿蒙（ArkTs）开发---父子组件中的通讯（修饰符@State、 @Prop、@Link、@Provide、@Consume）】
我是盒饭 努力搬砖的码农
01-19 2216
【代码】【鸿蒙（ArkTs）开发---父子组件中的通讯（修饰符@State、 @Prop、@Link、@Provide、@Consume）】
【鸿蒙开发实战】HarmonyOS装饰详解
HarmonyOS_001的博客
06-24 771
调用的时候可以直接使用this.function()使用自定义组件内@Builder方法个数不限制，可以在build()函数内调用，也可以在其他自定义函数，但是不能在组件外调用。使用方法GlobalBuilderFunction()可以被整个应用获取，不允许使用this和bind方法。如果不涉及组件状态变化，建议使用全局自定义构建方法我们可以理解为这个装饰器可以把我们开发中组件重复的样式设置代码进行抽离成一个方法。语法。
鸿蒙修饰符
tatasix的博客
11-29 2141
在HarmonyOS（鸿蒙）应用开发中，修饰符（Decorator）是一个极其重要的概念。它们不仅能够简化开发过程，还能提供强大的功能扩展性。本文将深入探讨鸿蒙中的各类修饰符，帮助开发者更好地理解和使用这些工具。本文主要介绍`@Styles`，`@Extend`，`@Builder`，`@Component`，`@BuilderParam`，`@State`，`@Prop`，`@Link`，`@Provide`，`@Watch`，`@Observed`等等。
【鸿蒙开发基础】Harmony OS Next-@prop修饰符
weixin_74851434的博客
12-30 614
介绍了什么是@prop修饰符，以及@prop修饰符的用法
鸿蒙中常用的修饰符
ydx0618的博客
06-06 628
鸿蒙中的一些常用的修饰符
鸿蒙开发TS基础:ArkTS语言之:类class、类声明、字段、方法、构造函数、可见性修饰符、对象字面量
阿辉的博客
06-18 3506
鸿蒙开发TS基础:ArkTS语言之:类class、类声明、字段、方法、构造函数、可见性修饰符、对象字面量
HarmonyOS 实战开发 —— 瀑布流性能优化
CTrup的博客
11-29 1173
瀑布流是应用开发中相当常见的开发场景。它通过容器自身的布局规则，将元素项目自上而下排列，在整体界面的呈现上，多列参差不齐、不停加载的形式使其内容看着像瀑布一样从上而下倾泻。借助其特点，瀑布流通常被用于展示图片资讯、购物商品、直播视频等多种形式的数据。当瀑布流上下滑动时，由于无限加载的特性，其能展示的数目非常多；大小不一的子元素，也带来了测量绘制的性能消耗。针对瀑布流这种场景进行性能优化，可以在加快渲染速度、提升滑动帧率、降低内存占用等方面，增强应用的运行效率，进而提升用户的操作体验。
HarmonyOS 实战开发 —— 自定义tabs导航栏实现切换效果
CTrup的博客
11-09 766
但是该导航栏为默认样式，要想实现更多样式，必须自定义TabBar。自定义TabBar步骤1.使用@Builder修饰一个函数tabBarBuilder()，里面是自定义的TabBar的结构。2…tabBar()中传参为自定义构建器this.tabBarBuilder()。注：构建器函数里面是可以传参的，所以多个TabContent可以共用一个tabBarBuilder()然后传不同的参数。.onChange()事件和.onTabBarClick()事件都可以获得当前页面的索引。
鸿蒙ArkUI中自定义组件的生命周期详解
liuhaojiabin的博客
11-29 1054
自定义组件：@Component装饰的UI单元，可以组合多个系统组件实现UI的复用，可以调用组件的生命周期。页面：即应用的UI页面。可以由一个或者多个自定义组件组成，@Entry装饰的自定义组件为页面的入口组件，即页面的根节点，一个页面有且仅能有一个@Entry。只有被@Entry装饰的组件才可以调用页面的生命周期。像是我们的Mine以及Found组件，由于想要做到不使用tab的时候，也可以正常的访问，所以我们在其中加入了@Entry的修饰符，使其属于页面。
鸿蒙原生APP性能优化之ArkTS高性能编程
CTrup的博客
10-27 885
高性能编程指的是在语法使用过程中，通过优化一些影响性能的代码片段，使代码以最优的方式执行。以下实践是在开发过程中逐步总结出来的一些高性能的写法和建议，实践包含变量声明、属性的访问、数值计算、数据结构的使用以及函数声明与使用等内容，在业务功能实现过程中，要同步思考并理解高性能写法的原理，运用到代码逻辑实现中。
鸿蒙中的装饰器及其功能简介
Ronin_zzb的博客
06-04 1814
装饰器用于状态变量的监听。如果需要关注某个状态变量的值是否改变，可以使用@Watch（使用方法大概如下，还可以监听@Prop、@Link和@Provide等）Tips：在实际生产中，我们可自定义组件，只复用此组件的逻辑（例如检测当前设备类型、当前设备状态等），外部UI使用BuilderParam传入。时，执行的并发函数若需要传输类对象且使用该类的内部方法，该类需要使用此装饰器修饰，否则无法使用此对象内的方法。限制条件：不能在UI中使用非@Track装饰的属性，包括不能绑定在组件上、不能用于初始化子组件。
鸿蒙组件级状态管理
m0_51798113的博客
07-04 547
在@Prop，@Link，@Provide与@Consume这几个装饰器仅能观察到第一层的变化，在实际应用开发中，应用会根据开发需要，封装自己的数据模型。基本数据类型可以观察到（必须赋值），object和class直接属性没有问题，比如this.num++，但是类嵌套就不行比如两层类嵌套，this.p.num，好像现在可以监听到了，api5就可以监控到。修饰符除了@State还有@Prop，@Link,@Provide和@Consume，@ObjectLink和@Observed。
类与对象修饰符
用作学习记录
06-03 178
类与对象访问修饰符public,abstract,final,缺省
鸿蒙 stage 开发 arkTS 关于 @Entry使用
yakie的专栏
11-28 5206
因为MainPage.ets里使用了@Entry而且LoginPage也使用了@Entry，有个重复警告。仅仅去掉LoginPage.ets里的@Entry会出现如下错误。
服务端之NestJS接口响应message编写规范详解、写给前后端都舒服的接口、API提示信息标准化
优快云博客主页地址：https://mengjian.blog.youkuaiyun.com/
10-07 1719
服务端之NestJS接口响应message编写规范详解、写给前后端都舒服的接口、API提示信息标准化
基于C#与MySQL的高分课程设计：人事工资管理系统完整源码与数据库
最新发布
12-05
本资源提供了一套采用C#编程语言结合MySQL数据库技术构建的企业人力资源与薪酬管理软件解决方案。该方案包含完整的程序源代码及配套的结构化数据存储文件，专为满足高等院校计算机相关专业课程设计或毕业设计的高标准要求而准备，其设计目标旨在获得不低于九十五分的优异评价。 整套材料经过系统化整合与严格测试，确保了各功能模块的完整性与可执行性。用户获取后无需进行额外的环境配置或代码调整，即可直接部署并启动运行。系统架构严谨，实现了对企业员工信息档案、考勤记录、绩效评估及薪资核算等核心业务流程的数字化管理，显著提升了相关事务的处理效率与准确性。 该软件工程实践案例不仅展示了C#在Windows桌面应用开发中的实际应用，也体现了MySQL在中小型数据管理场景下的稳定表现，适合作为学习现代软件开发流程与数据库设计原理的参考范例。 资源来源于网络分享，仅用于学习交流使用，请勿用于商业，如有侵权请联系我删除！
产品碳足迹软件，全球前10强生产商排名及市场份额（by QYResearch）.pdf
12-05
产品碳足迹软件，全球前10强生产商排名及市场份额（by QYResearch）.pdf
深入浅出Core Data开发
12-05
本书系统讲解了Core Data在iOS开发中的应用，涵盖数据建模、增删改查、迁移与版本控制等核心技术。通过构建真实项目，读者可掌握高效数据管理的最佳实践，理解NSManagedObject、NSFetchRequest及NSFetchedResultsController等关键类的工作机制。书中还融合了iCloud同步、多设备通信与高级UI设计，帮助开发者打造高性能、易维护的移动应用。适合具备基础iOS知识的进阶开发者阅读。
Rails测试实战指南
12-05
本书系统讲解Rails应用中的自动化测试实践，涵盖单元测试、功能测试、集成测试与验收测试。通过真实案例深入探讨Test::Unit、Shoulda、RSpec、Cucumber等主流测试框架的使用技巧，并介绍测试数据管理、模拟对象、覆盖率分析及遗留系统测试等关键主题。强调测试驱动开发（TDD）在提升代码质量与开发效率中的核心作用，帮助开发者构建健壮、可维护的Rails应用。
鸿蒙自定义修饰符@
03-26
<think>嗯，用户想了解鸿蒙系统中如何使用自定义修饰符。首先，我需要回忆一下HarmonyOS的文档，特别是ArkUI部分的修饰符相关内容。记得修饰符在声明式UI中用于动态修改组件样式或行为，类似其他框架的修饰符概念。 首先，用户可能需要知道什么是自定义修饰符，以及为什么需要它。可能步骤包括定义修饰符类、实现修饰逻辑、应用修饰符到组件。需要确保语法正确，比如使用@Extend和@AnimatableExtend装饰器，这两个在HarmonyOS中应该常用。 然后，考虑到用户可能对具体代码示例感兴趣，应该给出一个简单的例子，比如边框和颜色的修饰符。另外，动画修饰符也是常见需求，可能需要@AnimatableExtend，并配合状态管理，比如@State来控制动画。 还要注意说明修饰符的链式调用，这样用户知道可以组合多个修饰符。另外，使用时的注意事项，比如参数类型限制或兼容性，需要提醒用户，避免出错。 可能用户在使用过程中会遇到性能问题，或者如何复用修饰符，这些也应该在注意事项中提到。需要确保引用的文档正确，比如引用官方指南或开发文档中的内容，这里可能需要查找相关资源，比如HarmonyOS的ArkUI开发指南，确保引用的准确性。 最后，生成相关问题时要围绕修饰符的扩展、性能优化、对比其他框架、动画实现等，帮助用户深入理解。需要检查回答是否符合之前的系统级指令，比如数学公式的格式是否正确，虽然这个问题可能不涉及数学，但如果有代码块要正确使用反引号包裹，并指定语言类型。 总结下来，回答的结构应该是先介绍概念，再分步骤说明使用方法，提供示例代码，然后注意事项，最后相关问题。确保每个部分都清晰，并正确引用官方文档作为支持。</think>### HarmonyOS自定义修饰符使用指南 在HarmonyOS的ArkUI框架中，自定义修饰符通过@Extend/@AnimatableExtend装饰器实现，用于扩展组件样式能力[^1]。以下是具体实现步骤： #### 一、基础修饰符定义 ```typescript // 定义颜色+边框修饰符 @Extend(Text) function customStyle( color: ResourceColor, borderWidth: number = 1 ) { .fontColor(color) .border({ width: borderWidth, color }) } // 应用示例 Text('Hello') .customStyle(Color.Red, 2) // 链式调用 ``` #### 二、动画修饰符定义 ```typescript @AnimatableExtend(Text) function animatedScale( scale: number = 1 ) { .scale({ x: scale, y: scale }) } // 配合状态管理 @State isScaled: boolean = false Text('Click') .animatedScale(this.isScaled ? 1.2 : 1) .onClick(() => { this.isScaled = !this.isScaled }) ``` #### 三、参数传递规则 1. 支持基础类型参数：number/string/boolean 2. 支持资源类型参数：ResourceColor/ResourceStr 3. 支持对象参数（需定义接口类型） #### 注意事项 1. 修饰符必须定义在全局作用域 2. @AnimatableExtend需配合动画属性使用 3. 链式调用顺序影响最终样式[^1]
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值