Composed UI

Appearance

触摸滑动 Swiper
11.2.10
​

触摸滑动组件

何时使用 ​

  • 创建触摸滑块和可滑动内容的区域

参考文档 ​

基本使用 ​

Show Code
vue
<script setup lang="ts">
import { ref, onBeforeMount } from 'vue'
import type { SwiperImage } from 'composed-ui'
const images = ref<SwiperImage[]>([])
function loadImages() {
  for (let i = 1; i <= 6; i++) {
    images.value.push({
      name: `image-${i}`,
      src: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`,
      link: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`
    })
  }
}
onBeforeMount(() => {
  // 组件已完成响应式状态设置，但未创建DOM节点
  loadImages()
})
function onChange(swiper: any) {
  console.log('slider change', swiper)
}
</script>
<template>
  <Swiper
    :images="images"
    :height="450"
    :speed="800"
    :pagination="{
      dynamicBullets: true,
      clickable: true
    }"
    @change="onChange"
  />
</template>

各种切换动画 ​

slide
fade
cube
flip
coverflow
cards
Show Code
vue
<script setup lang="ts">
import { ref, onBeforeMount } from 'vue'
import type { SwiperImage } from 'composed-ui'
const images = ref<SwiperImage[]>([])
function loadImages() {
  for (let i = 1; i <= 6; i++) {
    images.value.push({
      name: `image-${i}`,
      link: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`,
      src: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`
    })
  }
}
onBeforeMount(() => {
  // 组件已完成响应式状态设置，但未创建DOM节点
  loadImages()
})
const effects = ['slide', 'fade', 'cube', 'flip', 'coverflow', 'cards']
</script>
<template>
  <Flex :gap="36" wrap="wrap">
    <Badge style="width: 30%" :value="effect" color="volcano" v-for="(effect, index) in effects" :key="index">
      <Swiper
        style="display: inline-block"
        :images="images"
        :height="160"
        :speed="600"
        :pagination="{
          dynamicBullets: true,
          clickable: true
        }"
        :effect="effect"
      />
    </Badge>
  </Flex>
</template>

自定义切换动画 ​

creative
creative
creative
creative
creative
creative
Show Code
vue
<script setup lang="ts">
import { ref, onBeforeMount } from 'vue'
import type { SwiperImage } from 'composed-ui'
const images = ref<SwiperImage[]>([])
function loadImages() {
  for (let i = 1; i <= 6; i++) {
    images.value.push({
      name: `image-${i}`,
      link: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`,
      src: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`
    })
  }
}
onBeforeMount(() => {
  // 组件已完成响应式状态设置，但未创建DOM节点
  loadImages()
})
const creativeEffects = [
  {
    prev: {
      shadow: true,
      translate: [0, 0, -400]
    },
    next: {
      translate: ['100%', 0, 0]
    }
  },
  {
    prev: {
      shadow: true,
      translate: ['-120%', 0, -500]
    },
    next: {
      shadow: true,
      translate: ['120%', 0, -500]
    }
  },
  {
    prev: {
      shadow: true,
      translate: ['-20%', 0, -1]
    },
    next: {
      translate: ['100%', 0, 0]
    }
  },
  {
    prev: {
      shadow: true,
      translate: [0, 0, -800],
      rotate: [180, 0, 0]
    },
    next: {
      shadow: true,
      translate: [0, 0, -800],
      rotate: [-180, 0, 0]
    }
  },
  {
    prev: {
      shadow: true,
      translate: ['-125%', 0, -800],
      rotate: [0, 0, -90]
    },
    next: {
      shadow: true,
      translate: ['125%', 0, -800],
      rotate: [0, 0, 90]
    }
  },
  {
    prev: {
      shadow: true,
      origin: 'left center',
      translate: ['-5%', 0, -200],
      rotate: [0, 100, 0]
    },
    next: {
      origin: 'right center',
      translate: ['5%', 0, -200],
      rotate: [0, -100, 0]
    }
  }
]
</script>
<template>
  <Flex :gap="36" wrap="wrap">
    <Badge
      style="width: 30%"
      value="creative"
      color="cyan"
      v-for="(creativeEffect, index) in creativeEffects"
      :key="index"
    >
      <Swiper
        style="display: inline-block"
        :images="images"
        :height="160"
        :speed="600"
        :pagination="{
          dynamicBullets: true,
          clickable: true
        }"
        effect="creative"
        :creativeEffect="creativeEffect"
      />
    </Badge>
  </Flex>
</template>

走马灯 ​

Show Code
vue
<script setup lang="ts">
import { ref, onBeforeMount } from 'vue'
import type { SwiperImage } from 'composed-ui'
const images = ref<SwiperImage[]>([])
function loadImages() {
  for (let i = 1; i <= 6; i++) {
    images.value.push({
      name: `image-${i}`,
      src: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`,
      link: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`
    })
  }
}
onBeforeMount(() => {
  // 组件已完成响应式状态设置，但未创建DOM节点
  loadImages()
})
</script>
<template>
  <Swiper :images="images" mode="carousel" :height="200" :slides-per-view="3" :space-between="20" :speed="2500" />
</template>

信息展播 ​

Prev
Next
Show Code
vue
<script setup lang="ts">
import { ref, shallowReactive, onBeforeMount } from 'vue'
import type { SwiperImage } from 'composed-ui'
const images = ref<SwiperImage[]>([])
function loadImages() {
  for (let i = 1; i <= 6; i++) {
    images.value.push({
      name: `image-${i}`,
      src: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`,
      link: `https://cdn.jsdelivr.net/gh/Kitesource/resources@0.0.1/${i}.jpg`
    })
  }
}
onBeforeMount(() => {
  // 组件已完成响应式状态设置，但未创建DOM节点
  loadImages()
})
const navigation = shallowReactive<{ [key: string]: any }>({})
function onBroadcastSwiper(swiper: any) {
  navigation.prevEl = swiper.navigation.prevEl
  navigation.prevEl.style.display = 'none'
  navigation.nextEl = swiper.navigation.nextEl
  navigation.nextEl.style.display = 'none'
}
function onPrev() {
  navigation.prevEl.click()
}
function onNext() {
  navigation.nextEl.click()
}
</script>
<template>
  <Flex vertical gap="middle">
    <Space>
      <Button type="primary" @click="onPrev">Prev</Button>
      <Button type="primary" @click="onNext">Next</Button>
    </Space>
    <Swiper
      :images="images"
      mode="broadcast"
      :height="200"
      :speed="600"
      :pagination="{
        dynamicBullets: true,
        clickable: true
      }"
      :slides-per-view="3"
      :space-between="30"
      navigation
      mousewheel
      @swiper="onBroadcastSwiper"
    />
  </Flex>
</template>

APIs ​

Swiper ​

参数说明类型默认值
images轮播图片数组Image[][]
width轮播区域宽度，单位 pxnumber | string'100%'
height轮播区域高度，单位 pxnumber | string'100%'
modebanner: 轮播图模式; carousel: 走马灯模式; broadcast: 信息展播模式'banner' | 'carousel' | 'broadcast''banner'
navigation是否显示导航booleanfalse
effect切换动画效果'slide' | 'fade' | 'cube' | 'flip' | 'coverflow' | 'cards' | 'creative''slide'
delay自动切换的时间间隔，仅当 mode: 'banner' 时生效，单位 msnumber3000
speed切换过渡的动画持续时间，单位 msnumber300
loop是否循环切换booleantrue
pauseOnMouseEnter当鼠标移入走马灯时，是否暂停自动轮播，仅当 mode: 'banner' 或 mode: 'carousel' 时生效booleanfalse
swipe是否可以鼠标拖动booleantrue
preloaderColor预加载时的 loading 颜色'theme' | 'white' | 'black''theme'

Image Type ​

名称说明类型默认值
name?图片名称stringundefined
src图片地址stringundefined
link?图片跳转链接stringundefined
target?如何打开跳转链接'_self' | '_blank'undefined

Events ​

名称说明类型
swiperSwiper 初始化后的回调(swiper: any) => void
change轮播图片变化时的回调(swiper: any) => void

Released under the MIT License.

Copyright © 2023-present the Composed UI Team