一、onClick()

1. 基础概念

ArkTS 中所有可点击组件(Button、Text、Image)都提供 onClick 回调,用户手指点击后执行自定义业务逻辑,是最基础交互入口。

2. 基础代码示例

3. 常用业务场景

  1. 新增、删除、提交、重置按钮操作
  2. 列表条目、卡片点击跳转详情
  3. 图标点击展开 / 收起、复制、下载
  4. 开关、折叠面板切换

二、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 自动更新

七、全文总结

  1. onClick():鸿蒙所有点击交互的基础回调,用来触发弹窗、路由、提交等逻辑;
  2. onChange():表单选择 / 输入完成回调,用于筛选、查询业务;
  3. @State(对应大纲 @status):鸿蒙核心响应式装饰器,数据驱动 UI,控制弹窗、加载、列表等所有动态状态;
  4. 弹窗(CustomDialog/AlertDialog):浮层交互载体,完全依赖@State做显隐控制;
  5. 路由 router:实现跨页面跳转与参数传递,完成应用多页面流转。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐