openharmony 鸿蒙 js-service-widget-container-swiper

2025-06-12 浏览 (1)

swiper

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

说明:

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

属性

除支持通用属性外,还支持如下属性:

名称类型默认值必填描述
indexnumber0当前在容器中显示的子组件的索引值。
indicatorbooleantrue是否启用导航点指示器,默认true。true为启用导航点指示器,false为不启用。
digitalbooleanfalse是否启用数字导航点,默认为false。true为启用数字导航点,false为不启用。
必须设置indicator时才能生效数字导航点。
loopbooleantrue是否开启循环滑动。true为开启循环,false为关闭循环。
durationnumber0子组件切换的动画时长。
单位:毫秒
取值范围:[0, +∞)
verticalbooleanfalse是否为纵向滑动。true为纵向滑动,false为水平滑动。纵向滑动时采用纵向的指示器。

样式

除支持通用样式外,还支持如下样式:

名称类型默认值必填描述
indicator-color<color>-导航点指示器的填充颜色。
indicator-selected-color<color>-导航点指示器选中的颜色。
indicator-size<length>4px导航点指示器的直径大小。
indicator-top|left|right|bottom<length> | <percentage>-导航点指示器在swiper中的相对位置。

事件

支持通用事件

示例

<!-- xxx.hml -->
<swiper class="container" index="{{index}}">
  <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;
}
{
  "data": {
    "index": 1
  }
}

4*4卡片

卡片swiper

你可能感兴趣的鸿蒙文章

harmony 鸿蒙JS服务卡片UI组件

harmony 鸿蒙数据类型说明

harmony 鸿蒙button

harmony 鸿蒙calendar

harmony 鸿蒙chart

harmony 鸿蒙clock

harmony 鸿蒙divider

harmony 鸿蒙image

harmony 鸿蒙input

harmony 鸿蒙progress

  • 所属分类: 后端技术
  • 本文标签: 鸿蒙 软件
  • 版权声明: 本文链接 https://seaxiang.com/blog/yW7S6h