事件和掌握知识
一、onClick()
1. 基础概念
ArkTS 中所有可点击组件(Button、Text、Image)都提供 onClick 回调,用户手指点击后执行自定义业务逻辑,是最基础交互入口。
2. 基础代码示例

3. 常用业务场景
- 新增、删除、提交、重置按钮操作
- 列表条目、卡片点击跳转详情
- 图标点击展开 / 收起、复制、下载
- 开关、折叠面板切换
二、onChange()
1. 概念说明
onChange 是表单类组件专属回调,监听输入框、下拉选择、单选框、滑块的值发生改变时触发;区别于实时输入回调
2. 完整示例




三、@status
1. 核心概念
大纲里的@status对应鸿蒙 ArkTS**@State装饰器 **,是页面本地响应式状态核心:被@State修饰的变量一旦修改,绑定该变量的 UI 组件会自动刷新,无需手动操作 DOM,实现数据驱动视图。 弹窗显隐、加载动画、开关、筛选标记全部依靠@State管理。
2. 高频业务用法
控制弹窗、侧边抽屉、下拉菜单显示 / 隐藏
接口请求时切换加载 loading 状态
标签页切换、筛选条件存储 表
单输入双向绑定、表单错误提示
四、弹窗
弹窗配合onClick打开 / 关闭。

这是鸿蒙系统简易弹窗,无需自定义组件,一行 API 快速唤起提示框:
| 参数 | 作用 |
|---|---|
| title | 弹窗标题文本 |
| message | 弹窗正文提示内容 |
交互特性:弹出后自动带遮罩,点击空白 / 确定按钮即可关闭,适合轻量提示、操作反馈。
五、路由
鸿蒙 Stage 模型使用router模块实现页面跳转,通常在onClick点击事件中触发,支持传参、返回上一页、替换页面。
1. 基础路由使用

2. 目标页面接收路由参数

3.路由
根据目录,写上使用路由的文件

4.传参


核心 API:router.pushUrl(options) url:跳转目标页面的路由路径,对应 pages 目录下的 HomePage 页面; params:路由传参载体,是自定义对象,可存放任意需要传递的数据(这里传递输入的账号、密码); 逻辑分支: 账号 / 密码不为空:执行页面跳转,并把输入内容打包进 params 传给首页; 账号 / 密码为空:弹出弹窗拦截跳转,提示用户输入。

onPageShow():页面每次显示都会触发的生命周期函数,适合接收路由参数; router.getParams():路由 API,读取上一个页面 pushUrl 中 params 携带的全部数据;
as Record<string, string>:类型断言,告诉 TS 参数是key:字符串,value:字符串的键值对象,方便直接 .username 取值;
this.name = params.username:提取登录页传来的用户名,存入当前页面 @State 响应变量。
| 代码模块 | 作用 |
|---|---|
router.pushUrl({url, params}) | 页面跳转 + 向后端页面传递参数 |
router.getParams() | 获取上一页路由携带的所有参数 |
onPageShow() | 页面显示时执行,最佳接收参数生命周期 |
Record<string, string> | 类型约束,规范路由参数键值类型 |
@State | 响应式变量,参数赋值后 UI 自动更新 |
七、全文总结
- onClick():鸿蒙所有点击交互的基础回调,用来触发弹窗、路由、提交等逻辑;
- onChange():表单选择 / 输入完成回调,用于筛选、查询业务;
- @State(对应大纲 @status):鸿蒙核心响应式装饰器,数据驱动 UI,控制弹窗、加载、列表等所有动态状态;
- 弹窗(CustomDialog/AlertDialog):浮层交互载体,完全依赖
@State做显隐控制; - 路由 router:实现跨页面跳转与参数传递,完成应用多页面流转。
更多推荐
所有评论(0)