大网数据广告活动
OpenHarmony 设备与应用开发

OpenHarmony 中文参考:swiper

· 52CE 我爱测

# swiper 滑动容器,提供切换子组件显示的能力。 > **说明:** > > 该组件从API version 4 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 ## 子组件 支持除<list>之外的子组件。 ## 属性 | 名称 | 类型 | 默认值 | 必填 | 描述 | | -------- | -------- | -------- | -------- | -------- | | index |

swiper

滑动容器,提供切换子组件显示的能力。

说明:

该组件从API version 4 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

子组件

支持除<list>之外的子组件。

属性

名称 类型 默认值 必填 描述
index number 0 否 当前在容器中显示的子组件的索引值。
loop boolean true 否 是否开启循环轮播。true为开启循环,false为不开启循环。
duration number - 否 子组件切换的动画时长。
vertical boolean false 否 是否为纵向滑动,纵向滑动时采用纵向的指示器。true为纵向滑动,false为水平滑动。
不支持动态修改。
id string - 否 组件的唯一标识。
style string - 否 组件的样式声明。
class string - 否 组件的样式类,用于引用样式表。
ref string - 否 用来指定指向子元素的引用信息,该引用将注册到父组件的$refs 属性对象上。

事件

名称 参数 描述
change { index: currentIndex } 当前显示的组件索引变化时触发该事件。
click - 点击动作触发该事件。
longpress - 长按动作触发该事件。
swipe5+ SwipeEvent 组件上快速滑动后触发。

样式

名称 类型 默认值 必填 描述
width <length> | <percentage>5+ - 否 设置组件自身的宽度。
未设置时组件宽度默认为0。
height <length> | <percentage>5+ - 否 设置组件自身的高度。
未设置时组件高度默认为0。
padding <length> 0 否 使用简写属性设置所有的内边距属性。
  该属性可以有1到4个值:
- 指定一个值时,该值指定四个边的内边距。
- 指定两个值时,第一个值指定上下两边的内边距,第二个指定左右两边的内边距。
- 指定三个值时,第一个指定上边的内边距,第二个指定左右两边的内边距,第三个指定下边的内边距。
- 指定四个值时分别为上、右、下、左边的内边距(顺时针顺序)。
padding-[left|top|right|bottom] <length> 0 否 设置左、上、右、下内边距属性。
margin <length> | <percentage>5+ 0 否 使用简写属性设置所有的外边距属性,该属性可以有1到4个值。
- 只有一个值时,这个值会被指定给全部的四个边。
- 两个值时,第一个值被匹配给上和下,第二个值被匹配给左和右。
- 三个值时,第一个值被匹配给上, 第二个值被匹配给左和右,第三个值被匹配给下。
- 四个值时,会依次按上、右、下、左的顺序匹配 (即顺时针顺序)。
margin-[left|top|right|bottom] <length> | <percentage>5+ 0 否 设置左、上、右、下外边距属性。
border-width <length> 0 否 使用简写属性设置元素的所有边框宽度。
border-color <color> black 否 使用简写属性设置元素的所有边框颜色。
border-radius <length> - 否 border-radius属性是设置元素的外边框圆角半径。
background-color <color> - 否 设置背景颜色。
opacity5+ number 1 否 元素的透明度,取值范围为0到1,1表示为不透明,0表示为完全透明。
display string flex 否 确定一个元素所产生的框的类型,可选值为:
- flex:弹性布局。
- none:不渲染此元素。
[left|top] <length> | <percentage>6+ - 否 left|top确定元素的偏移位置。
- left属性规定元素的左边缘。该属性定义了定位元素左外边距边界与其包含块左边界之间的偏移。
- top属性规定元素的顶部边缘。该属性定义了一个定位元素的上外边距边界与其包含块上边界之间的偏移。

方法

名称 参数 描述
rotation { focus: boolean } 控制swiper是否请求旋转表冠的焦点。设置focus参数为true,swiper将获取旋转表冠的焦点,允许用户通过旋转表冠来滚动选择器中的选项;设置为false将释放旋转表冠的焦点。

示例


<swiper class="container" index="{{index}}" ref="swiperObj">
    <div class="swiper-item primary-item">
        <text>1</text>
    </div>
    <div class="swiper-item warning-item">
        <text>2</text>
    </div>
    <div class="swiper-item success-item">
        <text>3</text>
    </div>
</swiper>
/* xxx.css */
.container {
  left: 0px;
  top: 0px;
  width: 454px;
  height: 454px;
}
.swiper-item {
  width: 454px;
  height: 454px;
  justify-content: center;
  align-items: center;
}
.primary-item {
  background-color: #007dff;
}
.warning-item {
  background-color: #ff7500;
}
.success-item {
  background-color: #41ba41;
}
/* xxx.js */
    data: {
        index: 1
    },
    onShow() {
        this.$refs.swiperObj.rotation({focus: true});
    },
    onHide() {
        this.$refs.swiperObj.rotation({focus: false})
    }
}

[图示请参阅官方原文]

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。