一、轮播图(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:关闭 / 取消勾选

实用示例

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐