ArkTS常用组件知识点整理

发布时间:2026/6/30 16:03:10
ArkTS常用组件知识点整理 一、页面基础装饰器组件页面必备Component 装饰器作用将结构体标识为ArkUI自定义页面或组件仅有添加该装饰器结构体才可通过build()方法搭建UI界面。 示例Component struct LoginPage{}Entry 装饰器作用需与Component搭配使用用于标识当前页面为独立访问入口支持路由跳转、预览器直接渲染所有可跳转页面均必须配置该装饰器。 示例Entry Component struct Register{}State 状态装饰器作用实现数据与UI双向绑定被修饰的变量发生改动时页面会同步刷新输入框、开关等交互组件均依靠该装饰器存储交互数据。 示例State username:string二、基础布局容器组件7大类Column 垂直布局容器将内部所有组件自上而下垂直排列支持设置组件间距、水平与垂直对齐方式适用于表单、注册登录类页面布局。 示例页面整体外层通过Column包裹用户名、密码输入框及功能按钮。Row 水平布局容器内部组件从左至右单行横向排列可配置水平间距、垂直对齐方式适合一行内文字搭配输入框的组合布局。 示例将用户名文字与TextInput输入框放置在同一Row容器内实现横向展示效果。Stack 层叠容器组件按照代码编写顺序分层叠加后定义的组件会覆盖在前层组件之上可实现图片浮文字、页面遮罩等效果。 示例底层放置展示图片上层叠加半透明说明文字。Flex 弹性布局容器具备自动换行特性当容器宽度不足时内部组件可自动换行适配适用于数量不固定的标签、小图标等场景。Grid 网格容器可划分固定行列的等分宫格子组件必须嵌套GridItem使用多用于规整的九宫格菜单、相册展示等布局。List 滚动列表容器自带垂直滚动功能子组件需嵌套ListItem适配大量重复数据展示场景性能优于普通Column布局。 示例新闻列表、商品列表的渲染展示。RelativeContainer 相对布局容器通过组件ID绑定定位规则组件可参照父容器或其他组件精准摆放布局自由度最高。三、文本与媒体展示组件Text 文本组件核心用于文字内容展示支持自定义字号、字体颜色、加粗、居中、外边距等样式绑定onClick事件可实现页面点击跳转功能。 示例Text(已有账号立即登录)Image 图片组件用于加载项目media资源文件夹下的本地图片通过$r(app.media.图片名)方式引入可设置宽高、圆角属性支持制作圆形头像等样式。 示例页面顶部圆形头像展示图片。四、表单输入交互组件TextInput 文本输入框用于接收用户输入内容通过text属性绑定State变量实现数据双向同步placeholder属性可设置输入提示文字type属性可开启密码隐藏模式onChange事件可实时监听输入内容变化。 示例登录页用户名输入框、密码输入框。Toggle 开关组件提供切换按钮样式绑定布尔类型State变量可实现记住密码、功能开关设置等业务场景。 示例登录页面“记住密码”切换开关。五、按钮与弹窗组件Button 按钮组件支持自定义宽高、圆角、内边距等样式绑定onClick点击事件后可执行表单校验、页面跳转、输入内容清空等业务逻辑。 示例注册按钮、清空按钮、页面返回按钮。AlertDialog 弹窗提示组件调用静态show方法即可唤起提示弹窗可配置标题title、提示信息message用于反馈注册、登录操作的成功或失败结果。 示例注册密码输入不一致时弹出错误提示弹窗。六、循环渲染组件ForEach 循环组件接收数组数据与回调函数可批量生成重复UI元素简化列表、网格多元素的重复代码编写。 示例在Grid网格布局中批量生成多个功能格子。七、组件通用样式与交互方法通用样式通过width、height设置组件尺寸padding为内边距、margin为外边距borderRadius实现圆角效果backgroundColor设置组件背景色通用交互.onClick()方法用于监听组件点击事件所有可交互组件均支持该方法路由组件router路由模块不属于UI组件核心负责页面跳转可通过pushUrl传入页面路径url搭配params参数实现跨页面传参。整体总结ArkTS组件主要分为页面装饰器、布局容器、展示组件、表单交互组件、弹窗组件、循环渲染组件六大类别。开发过程中通过各类布局容器嵌套基础组件搭建页面结构依托State实现数据响应式更新借助onClick完成页面交互通过AlertDialog实现操作结果反馈依靠router完成页面跳转多类组件相互配合即可完整实现注册、登录等核心业务页面。