zebra-swiper

# 基础使用

zebraSwiper 组件主要由 z-swiper，z-swiper-item 组成。

其中，z-swiper-item 组件只可放置在 z-swiper 组件中。

# 基础用法

<z-swiper v-model="list">
  <z-swiper-item v-for="(item,index) in list" :key="index">
    <image class="image" :src="item" mode="aspectFill"> </image>
  </z-swiper-item>
</z-swiper>

data() {
	return {
		list: [
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe1.jpg',
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe2.jpg',
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe3.jpg',
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe4.jpg',
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe5.jpg',
		]
	}
},

.image {
  height: 300rpx;
  width: 100%;
}

# 监听事件

通过@slideChange事件即可监听swiper的变化。当 swiper 通过滑动发生变化，自动播放发生变化，手动切换发生变化时，都会触发该事件。 该事件返回一个 swiper 实例，可以获取 swiper 中的任意参数。

<z-swiper v-model="list" ref="zSwiper" @slideChange="onChange">
  <z-swiper-item v-for="(item,index) in list" :key="index">
    <image class="image" :src="item" mode="aspectFill"> </image>
  </z-swiper-item>
</z-swiper>

onChange(swiper) {
	uni.showToast({
		title: '当前 swiper 索引：' + swiper.activeIndex,
		icon: 'none'
	})
}

# 纵向滑动

通过在options中添加direction: 'vertical'即可设置 swiper 为纵向，这个配置在所有切换效果中都可支持。

注意

在设置为纵向后，必须为 swiper 指定一个高度。可以通过custom-style设置组件的高度。

<z-swiper v-model="list" :custom-style="{height:'300rpx'}" :options="options">
  <z-swiper-item v-for="(item,index) in list" :key="index">
    <image class="image" :src="item" mode="aspectFill"> </image>
  </z-swiper-item>
</z-swiper>

data() {
	return {
		options: {
			direction: 'vertical'
		},
		list: [
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe1.jpg',
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe2.jpg',
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe3.jpg',
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe4.jpg',
			'https://cdn.zebraui.com/zebra-ui/images/swipe-demo/swipe5.jpg',
		]
	}
},

# 切换速度

通过在options中添加speed属性即可设置 swiper 的切换速度。这个配置的单位是ms。

<z-swiper v-model="list" :options="{speed:2000}">
  <z-swiper-item v-for="(item,index) in list" :key="index">
    <image class="image" :src="item" mode="aspectFill"> </image>
  </z-swiper-item>
</z-swiper>

# 禁用

通过在options中添加enabled属性并设置为false即可设置 swiper 为禁用状态。

<z-swiper v-model="list" :options="{enabled:false}">
  <z-swiper-item v-for="(item,index) in list" :key="index">
    <image class="image" :src="item" mode="aspectFill"> </image>
  </z-swiper-item>
</z-swiper>

← 轮播块 →