Swiper
是页面切换类容器组件,它提供了切换页面显示的能力, Swiper
包含的每一个子组件就表示一个页面,例如 Swiper
有 4 个子组件,那么 Swiper
就有 4 个页面。 Swiper
可以绑定一个 SwiperController
控制显示上一页或者下一页。
Swiper定义介绍
interface SwiperInterface {
(controller?: SwiperController): SwiperAttribute;
}
- controller:给
Swiper
绑定一个控制器,控制页面翻页。
简单样例如下:
Swiper() {
Text('Page1')
.fontSize(20)
.backgroundColor('#aabbcc')
Text('Page2')
.fontSize(20)
.backgroundColor('#aabbcc')
Text('Page3')
.fontSize(20)
.backgroundColor('#aabbcc')
}
.width('90%')
.height(120)
.backgroundColor(Color.Pink)
Swiper属性介绍
declare class SwiperAttribute<T> extends CommonMethod<T> {
index(value: number): T;
autoPlay(value: boolean): T;
interval(value: number): T;
indicator(value: boolean): T;
loop(value: boolean): T;
duration(value: number): T;
vertical(value: boolean): T;
itemSpace(value: number | string): T;
displayMode(value: SwiperDisplayMode): T;
onChange(event: (index: number) => void): T;
}
- index:默认显示显示第几页,默认值为 0。
- autoPlay:是否自动播放,默认值为 false ,当设置为自动播放时,导航点无法点击。
- interval:设置自动播放时,播放的时间间隔,单位毫秒,默认是 3000。
- indicator:是否显示导航点指示器,默认显示。
- loop:是否开启循环显示,也就是说当翻页到最后一页再往下翻页是否会回到第一页,默认开启。
- duration:页面切换的动画时长,单位为毫秒,默认是 400。
- vertical:是否竖直翻页,默认是 false。
简单样例如下所示:
Swiper() {
Text('Page1')
.fontSize(20)
.backgroundColor('#aabbcc')
Text('Page2')
.fontSize(20)
.backgroundColor('#aabbcc')
Text('Page3')
.fontSize(20)
.backgroundColor('#aabbcc')
}
.width('90%')
.height(120)
.backgroundColor(Color.Pink)
.index(1) // 设置默认显示第二页
.indicator(true) // 设置显示导航指示器
.vertical(true) // 设置竖直翻页
.loop(false) // 设置关闭循环翻页,当显示最后一页后首页时无法继续往下翻页
Swiper事件介绍
declare class SwiperAttribute<T> extends CommonMethod<T> {
onChange(event: (index: number) => void): T;
}
- onChange:页面切换时回到当前方法,显示当前第几页。
SwiperController简介
SwiperController
是 Swiper
的页面切换控制器,可以将此对象绑定至 Swiper
组件上,然后通过它控制翻页, SwiperController
定义如下:
export declare class SwiperController {
showNext();
showPrevious();
}
- showNext:显示下一页。
- showPrevious:显示上一页。
简单样例如下所示:
@Entry @Component struct ComponentTest {
private controller: SwiperController = new SwiperController();
build() {
Column() {
Swiper(this.controller) { // 绑定翻页控制器
Text('Page1')
.fontSize(20)
.backgroundColor('#aabbcc')
Text('Page2')
.fontSize(20)
.backgroundColor('#aabbcc')
Text('Page3')
.fontSize(20)
.backgroundColor('#aabbcc')
}
.width('90%')
.height(120)
.backgroundColor(Color.Pink)
.index(1) // 默认显示第二页
.indicator(true) // 显示导航指示器
Row({space: 20}) {
Button('上一页')
.onClick(() => {
this.controller.showPrevious();
})
Button('下一页')
.onClick(() => {
this.controller.showNext();
})
}
.margin({top: 10})
}
.alignItems(HorizontalAlign.Center)
.width('100%')
.height('100%')
.padding({ left: 20, right: 20, top: 10 })
}
}
为了能让大家更好的学习鸿蒙(HarmonyOS NEXT)开发技术,这边特意整理了《鸿蒙开发学习手册》(共计890页),希望对大家有所帮助:https://qr21.cn/FV7h05
《鸿蒙开发学习手册》:
如何快速入门:https://qr21.cn/FV7h05
- 基本概念
- 构建第一个ArkTS应用
- ……
开发基础知识:https://qr21.cn/FV7h05
- 应用基础知识
- 配置文件
- 应用数据管理
- 应用安全管理
- 应用隐私保护
- 三方应用调用管控机制
- 资源分类与访问
- 学习ArkTS语言
- ……
基于ArkTS 开发:https://qr21.cn/FV7h05
- Ability开发
- UI开发
- 公共事件与通知
- 窗口管理
- 媒体
- 安全
- 网络与链接
- 电话服务
- 数据管理
- 后台任务(Background Task)管理
- 设备管理
- 设备使用信息统计
- DFX
- 国际化开发
- 折叠屏系列
- ……
鸿蒙开发面试真题(含参考答案):https://qr18.cn/F781PH
鸿蒙开发面试大盘集篇(共计319页):https://qr18.cn/F781PH
1.项目开发必备面试题
2.性能优化方向
3.架构方向
4.鸿蒙开发系统底层方向
5.鸿蒙音视频开发方向
6.鸿蒙车载开发方向
7.鸿蒙南向开发方向