Swiper 轮播

数据驱动的轮播组件,统一适配小程序、Web、App

演示

9:41

代码示例

<!-- 基础用法 -->
  <re-swiper class="demo-swiper" :items="basicItems" height="320rpx"></re-swiper>

<!-- 图片 Banner -->
  <re-swiper class="demo-swiper" :items="imageBannerItems" :navigation="dotsBarNavigation" height="360rpx"></re-swiper>

<!-- 电商商品 Banner -->
  <re-swiper class="demo-swiper" :items="productBannerItems" :navigation="fractionNavButton" height="360rpx"></re-swiper>

<!-- 点状指示器 -->
  <re-swiper class="demo-swiper" :items="promoItems" :navigation="dotsNavigation" height="300rpx"></re-swiper>

<!-- 点条状指示器 -->
  <re-swiper class="demo-swiper" :items="promoItems" :navigation="dotsBarNavigation" height="300rpx"></re-swiper>

<!-- 默认第二页 + 不显示指示器 -->
  <re-swiper class="demo-swiper" :items="featureItems" :current="1" :indicator="false" :autoplay="false" :circular="false" height="280rpx"></re-swiper>

<!-- 分式指示器 + 左右按钮 -->
  <re-swiper class="demo-swiper" :items="basicItems" :navigation="fractionNavButton" height="320rpx"></re-swiper>

<!-- 自动播放 -->
  <re-swiper class="demo-swiper" :items="noticeItems" :navigation="fractionNavigation" :autoplay="true" :interval="2800" height="260rpx"></re-swiper>

<!-- 公告通知轮播 -->
  <re-swiper class="demo-swiper" :items="noticeTickerItems" direction="vertical" :autoplay="true" :interval="2400" :duration="350" :circular="true" :navigation="fractionNavigation" height="220rpx"></re-swiper>

<!-- 点击事件 -->
  <re-swiper class="demo-swiper" :items="actionItems" :navigation="dotsNavigation" :autoplay="false" height="300rpx" @click="onSwiperItemClick"></re-swiper>

<!-- 单项内容 -->
  <re-swiper class="demo-swiper" :items="singleItem" :autoplay="false" height="220rpx"></re-swiper>

<!-- 多图海报轮播 -->
  <re-swiper class="demo-swiper" :items="posterItems" :navigation="dotsBarNavigation" height="420rpx"></re-swiper>

<!-- 带跳转行为的运营位 -->
  <re-swiper class="demo-swiper" :items="operationItems" :navigation="fractionNavButton" :autoplay="false" height="320rpx" @click="onOperationClick"></re-swiper>

<!-- 自定义高度 / 不同图片比例 -->
  <re-swiper class="demo-swiper" :items="ratioWideItems" :navigation="dotsNavigation" height="220rpx"></re-swiper>
  <re-swiper class="demo-swiper" :items="ratioTallItems" :navigation="dotsNavigation" height="420rpx"></re-swiper>

<!-- 垂直方向 -->
  <re-swiper class="demo-swiper" :items="verticalItems" direction="vertical" :circular="false" :navigation="dotsBarNavigation" height="240rpx"></re-swiper>

引入

推荐使用 easycom 模式,配置后无需手动 import 即可直接使用 <re-swiper />。

API

Swiper Props

名称类型默认值描述必传
itemsArray<any> as Array<any>-N
currentnumber0-N
directionstring'horizontal'-N
intervalnumber5000-N
durationnumber500-N
circularbooleantrue-N
autoplaybooleantrue-N
indicatorbooleantrue-N
indicatorTypestring'dots'-N
navigationany{} as any-N
customStylestring''自定义样式N
heightstring'300rpx'-N

Swiper Events

名称参数描述
changecurrent: number, source: string值变化时触发
clickindex: number, item: any点击时触发
animationfinishcurrent: number动画结束时触发

Swiper Slots

名称描述
--