鸿蒙组件概述
一、轮播图(Swiper)
Swiper 是鸿蒙官方轮播容器:
内部子组件一页一页滑动切换
支持自动播放、循环滑动、指示器、滑动时长、间隔时间
支持手势左右滑动
核心特点 :
一页一个子组件,自动分页
支持无限循环轮播
自带小圆点指示器
可控制自动播放、播放间隔、滑动动画时长
1.Swiper 常用属性
| 属性 | 作用 |
|---|---|
| loop | 是否无限循环,默认 true |
| autoPlay | 是否自动播放 |
| interval | 自动播放间隔(毫秒) |
| duration | 滑动动画时长 |
| indicator | 是否显示小圆点指示器 |
| index | 当前展示页码 |
| onChange | 页面切换回调 |
2.实战示例

图片需要放在media文件夹下
3.Swiper 常见坑点总结
自动播放不生效原因:没开 autoPlay(true) 解决:必须手动开启
无法循环播放原因:loop(false) 默认是 true,但手动关闭就不能无限轮播
Swiper 高度塌陷Swiper 必须固定 height,不写高度直接不显示
4.Swiper总结
Swiper 是鸿蒙轮播容器,专门实现首页 Banner 广告;
核心配置:autoPlay自动播放、loop无限循环、interval间隔时间;
支持自定义指示器样式,满足 UI 设计需求;
通过 onChange 监听页面切换,实现业务逻辑;
Swiper 必须设置宽高,否则页面无法显示。
二、选项卡
1. 组成结构
Tabs 外层容器 + TabContent 子页面容器,一一对应:
Tabs:控制切换逻辑、标签栏位置、动画、样式TabContent:每一个标签对应的页面内容,一个 TabContent 对应一个标签页
2. 核心特性
自带手势左右滑动切换页面,同步联动顶部 / 底部标签;
支持标签栏置顶 / 置底两种布局;
自定义文字选中 / 未选中颜色、字号、下划线指示器;
支持禁止滑动、监听切换事件、隐藏标签栏。
3.基础语法结构

4.常用属性
barPosition 标签栏位置(BarPosition 枚举)
| 枚举 | 效果 |
|---|---|
| BarPosition.Start | 默认,标签栏在顶部 |
| BarPosition.End | 标签栏在底部(底部导航栏常用) |
index 默认选中页
index(0) 默认打开第 0 个页面。
5.实战示例

三、文本(Text)/输入框(Textinput)
(一)、Text 文本组件
1. 核心作用
用于展示固定文字,不支持用户编辑。
2. 常用属性大全
textAlign:对齐方式(Center、Start、End)fontSize:字体大小fontColor:字体颜色fontWeight:字体粗细maxLines:最大行数、超出隐藏textOverflow:文字溢出省略letterSpacing:字间距lineHeight:行高
(二)TextInput 输入框(核心交互组件)
1. 核心作用
接收用户输入:账号、密码、搜索、表单信息。
2.常用属性
type:输入类型(普通文本、密码、数字、手机号)maxLength:最大输入字数限制caretColor:光标颜色placeholderColor:提示文字颜色onChange:实时监听输入变化
3.输入类型

实用案例


四、按钮(Button)
1.常用属性演示

五、图片(Image)
图片资源
本地资源
将图片放在rawfile文件夹下。
媒体库file://data/storage
支持file://路径前缀的字符串,用于访问通过选择器提供的图片路径。
实用案例

六、视频
1.视频路径
普通本地视频。
加载本地视频时,需在工程资源的rawfile目录中放置视频文件,如下图所示。
加载沙箱路径视频
支持file://路径前缀的字符串,用于读取应用沙箱路径内的资源,需要确保应用沙箱目录路径下的文件存在并且有可读权限。
2.视频不能用预览器播放
3.实用示例

七、单选框(Radio)
Radio是单选框组件,通常用于提供相应的用户交互选择项,同一组的Radio中只有一个可以被选
1.属性和事件
RadioGroup 容器常用属性中
| 属性 | 作用 |
|---|---|
| selectedId / value | 设置当前默认选中项的标识值 |
| orientation | 布局方向:Horizontal 水平 / Vertical 垂直 |
| width / height | 宽高,支持固定数值、百分比"100%" |
| padding / margin | 内边距、外边距 |
Radio 单个单选框常用属性
| 属性 | 作用 |
|---|---|
| value | 给当前选项绑定唯一标识,供 RadioGroup 识别 |
| checked | 手动控制是否选中(布尔值 true/false) |
| text | 单选框右侧显示的文本 |
| fontSize / fontColor | 文字字号、文字颜色 |
| width / height | 控件尺寸 |
| enabled | 是否可点击,false 则置灰不可选 |
常用事件
onChange(value)
触发时机:组内任意单选框切换选中状态时
回调参数:当前选中项的 value 值
用途:获取选中结果、更新状态变量
2.实用示例

八、Toggle
Toggle组件提供状态按钮样式、勾选框样式和开关样式,一般用于两种状态之间的切换
1.核心事件:onChange ()
Toggle 唯一核心事件为 .onChange(callback),作用:用户点击切换选中状态时触发
回调参数 status: boolean,代表切换后的最新状态:
true:开启 / 勾选
false:关闭 / 取消勾选
实用示例

更多推荐
所有评论(0)