Skip to content
On this page

swiper

轮播容器,其中只可放置 swiper-item 组件。

Props

参数类型默认值必填说明
indicator-dotsbooleanfalse是否显示面板指示器
indicator-colorcolor
rgba(0, 0, 0, .3)
指示器颜色
indicator-active-colorcolor
#000
当前选中的指示器颜色
autoplaybooleanfalse是否自动切换
currentnumber0当前所在滑块的 index
intervalnumber5000自动切换时间间隔
durationnumber500滑动动画时长
circularbooleanfalse是否采用衔接滑动
verticalbooleanfalse滑动方向是否为纵向
previous-marginstring"0px"前边距,可用于露出前一项的一小部分,接受 px
next-marginstring"0px"后边距,可用于露出后一项的一小部分,接受 px
display-multiple-itemsnumber1同时显示的滑块数量
easing-functionstringdefault指定 swiper 切换缓动动画类型
合法值说明
default默认
linear线性
easeInCubic缓入
easeOutCubic缓出
easeInOutCubic缓入缓出

Events

事件名说明回调参数
change每一页轮播结束后触发{ current: number, source: 'autoplay' | 'touch' | '' }

Example

vue
<template>
  <swiper class="w-full h-40 text-white" autoplay indicator-dots indicator-active-color="white">
    <swiper-item v-for="item of items" :key="item" :style="{ 'background-color': item }">
      {{ item }}</swiper-item>
  </swiper>
</template>

<script setup lang="ts">
import { ref } from 'vue'

const items = ['blue', 'red', 'yellow', 'green']
</script>