1. 组件事件
组件事件是在用户与界面交互时触发的操作，如点击、触碰、滑屏、按键等。在 ArkTS 中，通过为组件绑定事件处理函数，实现对用户交互的响应。
常用事件示例
| 事件类型 | 描述 | 示例 |
|---|---|---|
onClick() | 点击事件 | Button().onClick(handler) |
onTouch() | 触摸事件 | Image().onTouch(handler) |
onKey() | 按键事件 | TextField().onKey(handler) |
onSwipe() | 滑屏事件 | ScrollView().onSwipe(handler) |
按钮点击事件
@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 文本组件
文本组件用于显示固定或动态的文字内容。
Text("欢迎来到 ArkTS 开发")
.fontSize(18)
.textColor(Color.Blue);
4.2 图片组件
图片组件 Image 用于展示本地或网络图片。
Image($rawfile("icon.png"))
.width(100)
.height(100);
官方文档
凡是过去，皆为序章；凡是未来，皆有可期。
