ArkTS 组件事件、状态管理与资源管理

1. 组件事件

组件事件是在用户与界面交互时触发的操作,如点击、触碰、滑屏、按键等。在 ArkTS 中,通过为组件绑定事件处理函数,实现对用户交互的响应。

常用事件示例
事件类型 描述 示例
onClick() 点击事件 Button().onClick(handler)
onTouch() 触摸事件 Image().onTouch(handler)
onKey() 按键事件 TextField().onKey(handler)
onSwipe() 滑屏事件 ScrollView().onSwipe(handler)
按钮点击事件
typescript 复制代码
@Entry
@Component
struct ButtonExample {
  build() {
    Button("点击我")
      .onClick(() => {
        console.log("按钮被点击了!");
      });
  }
}

2. 组件状态

组件状态是指由 @State 装饰的变量,这些变量与 UI 渲染绑定。当状态变量的值发生变化时,UI 会自动刷新。

3. 资源管理

资源管理是开发中必不可少的一环,用于存储和管理应用中的图片、音视频、多语言文本等资源。HarmonyOS 提供了 resource 目录来管理这些资源。

3.1 资源目录结构
目录类型 说明 示例资源文件
base/element 存放 JSON 格式的元素资源,如字符串、颜色、布尔值等 color.json, string.json
base/media 存放图片、音视频等非文本资源 icon.png, background.mp3
base/profile 存放自定义配置文件 test_profile.json
rawfile 自由放置资源文件,未编译直接打包 my_resource.txt, data.csv
3.2 语言环境支持
目录名称 说明
zh_CN 存放中文资源,当设备语言为中文时优先匹配。
en_US 存放英文资源,当设备语言为英文时优先匹配。

4. 文本组件与图片组件

4.1 文本组件

文本组件用于显示固定或动态的文字内容。

typescript 复制代码
Text("欢迎来到 ArkTS 开发")
  .fontSize(18)
  .textColor(Color.Blue);
4.2 图片组件

图片组件 Image 用于展示本地或网络图片。

typescript 复制代码
Image($rawfile("icon.png"))
  .width(100)
  .height(100);

官方文档


凡是过去,皆为序章;凡是未来,皆有可期。

相关推荐
行者-全栈开发14 小时前
【鸿蒙心迹】国际化 i18n 与多语言资源管理实战(HarmonyOS 7.x)
ui·华为·重构·国际化·harmonyos·多语言
钉先生贾1 天前
性能、体积与稳定性:怎样写出可信的适配结论
华为·harmonyos
redtank20002 天前
纯血鸿蒙小工具三件套实测:弹幕手持、爱记录与仓库管理软件
学习·华为·智能手机·harmonyos
xyzzklk2 天前
变相解决华为Mate 8锁屏后无法建立入站网络连接
linux·运维·服务器·网络·华为·go·安卓
贾伟康3 天前
【鸿蒙心迹】个人开发者上架复盘:备案、合规与审核指南没写透的细节
华为·harmonyos
不爱学英文的码字机器3 天前
2026鸿蒙远程控制软件完全选购指南:从入门到精通选型攻略
华为·harmonyos
贾伟康4 天前
【共创稿事节】HarmonyOS 7.0 BindContentCover全屏模态:从接入到生产验证
性能优化·实战·harmonyos·arkts·arkui
贾伟康4 天前
【共创稿事节】HarmonyOS 7.0 Menu菜单与上下文:从接入到生产验证
性能优化·实战·harmonyos·arkts·arkui
行者-全栈开发4 天前
Flutter 插件 device_calendar_plus 开源鸿蒙适配实战:从权限弹窗失灵到循环日程跑通
flutter·跨平台·harmonyos·arkts·日历·适配·开源鸿蒙
贾伟康4 天前
【共创稿事节】HarmonyOS 7.0 BindSheet半模态浮层:从接入到生产验证
性能优化·实战·harmonyos·arkts·arkui