鸿蒙 ArkUI 常用组件体系总结

574 阅读3分钟

鸿蒙 ArkUI 提供了丰富的 UI 组件,涵盖了布局、基础 UI、输入、容器、手势、动画、高级组件、网络与存储、适配等多个方面。以下是完整的 ArkUI 控件总结,方便你快速查阅和理解鸿蒙的 UI 组件体系。


📌 1. 布局控件(Layout Components)

控件作用
Row横向排列 子组件
Column纵向排列 子组件
Flex弹性布局,支持主轴对齐、换行、自动填充
List滚动列表,适用于数据较多的列表
ListItemList 的子项,每个列表项
Grid网格布局,支持多列显示
Stack层叠布局,子组件可自由重叠
Tabs选项卡布局,用于页面切换
Scroll滚动视图,可支持横向/纵向滚动
Swiper轮播图,用于多张图片/页面的切换
Divider分割线,用于区分不同内容区域
Panel可折叠面板,用于展开/收起内容

📌 2. 基础 UI 控件(Basic UI Components)

控件作用
Text文本显示,支持字体、颜色、样式
Image图片显示,支持本地/网络图片
Button按钮,用于点击交互
Icon图标,内置常用图标,可自定义
Badge徽章,用于显示通知数字/状态
Marquee跑马灯,用于滚动显示文本
Progress进度条,支持线性进度、环形进度
Loading加载动画,用于显示加载状态
Rating评分组件,用于展示/输入评分
Divider分割线,用于区分内容区域

📌 3. 输入控件(Form Components)

控件作用
TextInput文本输入框,支持单行/多行输入
Search搜索框,带搜索图标
DatePicker日期选择器,支持年月日选择
TimePicker时间选择器,支持时分秒选择
Checkbox复选框,用于多选
Radio单选框,用于单选
Toggle开关按钮,用于开/关状态切换
Slider滑动条,用于音量、亮度等调节
Picker滚动选择器,适用于省市区、数字选择

📌 4. 容器控件(Container Components)

控件作用
Navigation导航栏,用于页面跳转
TabBar底部导航栏,用于切换不同页面
Toolbar顶部工具栏,可放置标题、按钮
Dialog弹窗,用于确认/提示用户
Popover弹出框,用于菜单或提示
Sheet底部弹出菜单
SideBar侧边栏,用于导航菜单

📌 5. 手势与动画(Gesture & Animation)

控件作用
Gesture手势识别(点击、滑动、长按)
Draggable拖拽组件,可用于拖拽排序
Transition动画过渡效果
AnimationController动画控制器,用于复杂动画
MotionPath路径动画,让元素沿自定义路径运动

📌 6. 高级控件(Advanced Components)

控件作用
Web嵌入网页,显示 HTML 内容
Canvas自定义绘制,适用于绘图
Video视频播放
Map地图组件
QRCode二维码扫描与生成

📌 7. 状态管理(State Management)

方式作用
@State组件内部状态,组件变化时自动更新 UI
@Prop父组件向子组件传值
@Link双向绑定
@Observed监听对象的变化,更新 UI
@ObjectLink更复杂的数据绑定

📌 8. 网络请求与数据存储

方式作用
HttpRequest进行 HTTP 请求,支持 GET/POST
DataStore轻量级本地存储(类似 SharedPreferences)
SQLite本地数据库存储
File读写本地文件
WebSocket长连接,如聊天功能

📌 9. 适配与多端支持

技术点作用
Breakpoint屏幕断点适配
WindowSizeClass根据设备窗口大小适配 UI
@MediaQuery适配不同屏幕尺寸
MultiDeviceSync多设备协同(手机、平板、智能手表)
ArkTS一次开发,多端运行

✅ 总结

鸿蒙 ArkUI 组件体系非常丰富,可以满足布局、基础 UI、输入、动画、存储、网络请求、适配等各种需求。