Tu-view

在有限空间内，循环播放同一类型的图片、文字等内容

# 基础用法

适用广泛的基础用法

默认 Hover 指示器触发

Click 指示器触发

结合使用tu-carousel和tu-carousel-item标签就得到了一个走马灯。幻灯片的内容是任意的，需要放在tu-carousel-item标签中。默认情况下，在鼠标 hover 底部的指示器时就会触发切换。通过设置trigger属性为click，可以达到点击触发的效果。

<template>
	<tu-row
		:gutter="20"
		class="demo-carousel"
	>
		<tu-col :span="12">
			<p>默认 Hover 指示器触发</p>
			<tu-carousel>
				<tu-carousel-item
					v-for="image in images"
					:key="image"
				>
					<img :src="image" />
				</tu-carousel-item>
			</tu-carousel>
		</tu-col>
		<tu-col :span="12">
			<p>Click 指示器触发</p>
			<tu-carousel trigger="click">
				<tu-carousel-item
					v-for="image in images"
					:key="image"
				>
					<img :src="image" />
				</tu-carousel-item>
			</tu-carousel>
		</tu-col>
	</tu-row>
</template>

<script>
	export default {
		data() {
			return {
				images: [
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/cd7a1aaea8e1c5e3d26fe2591e561798.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/6480dbc69be1b5de95010289787d64f1.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/0265a04fddbd77a19602a15d9d55d797.png~tplv-uwbnlip3yd-webp.webp",
				],
			};
		},
	};
</script>
<style>
	.demo-carousel .tu-carousel__container,
	.demo-carousel .tu-carousel,
	.demo-carousel img {
		width: 100%;
		height: 180px;
	}
</style>
Expand Copy

# 指示器

可以将指示器的显示位置设置在容器外部

indicator-position属性定义了指示器的位置。默认情况下，它会显示在走马灯内部，设置为outside则会显示在外部；设置为none则不会显示指示器。

<template>
	<tu-carousel
		indicator-position="outside"
		style="width: 800px;"
	>
		<tu-carousel-item
			v-for="image in images"
			:key="image"
		>
			<img :src="image" />
		</tu-carousel-item>
	</tu-carousel>
</template>

<script>
	export default {
		data() {
			return {
				images: [
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/cd7a1aaea8e1c5e3d26fe2591e561798.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/6480dbc69be1b5de95010289787d64f1.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/0265a04fddbd77a19602a15d9d55d797.png~tplv-uwbnlip3yd-webp.webp",
				],
			};
		},
	};
</script>
Expand Copy

# 切换箭头

可以设置切换箭头的显示时机

arrow属性定义了切换箭头的显示时机。默认情况下，切换箭头只有在鼠标 hover 到走马灯上时才会显示；若将arrow设置为always，则会一直显示；设置为never，则会一直隐藏。

<template>
	<tu-carousel
		:interval="5000"
		arrow="always"
		style="width: 800px;"
	>
		<tu-carousel-item
			v-for="image in images"
			:key="image"
		>
			<img :src="image" />
		</tu-carousel-item>
	</tu-carousel>
</template>

<script>
	export default {
		data() {
			return {
				images: [
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/cd7a1aaea8e1c5e3d26fe2591e561798.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/6480dbc69be1b5de95010289787d64f1.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/0265a04fddbd77a19602a15d9d55d797.png~tplv-uwbnlip3yd-webp.webp",
				],
			};
		},
	};
</script>
Expand Copy

# 卡片化

当页面宽度方向空间空余，但高度方向空间匮乏时，可使用卡片风格

将type属性设置为card即可启用卡片模式。从交互上来说，卡片模式和一般模式的最大区别在于，可以通过直接点击两侧的幻灯片进行切换。

<template>
	<tu-carousel
		class="demo-carousel-card"
		:interval="4000"
		type="card"
	>
		<tu-carousel-item
			v-for="image in images"
			:key="image"
		>
			<img :src="image" />
		</tu-carousel-item>
	</tu-carousel>
</template>

<script>
	export default {
		data() {
			return {
				images: [
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/cd7a1aaea8e1c5e3d26fe2591e561798.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/6480dbc69be1b5de95010289787d64f1.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/0265a04fddbd77a19602a15d9d55d797.png~tplv-uwbnlip3yd-webp.webp",
				],
			};
		},
	};
</script>
<style>
	.demo-carousel-card .tu-carousel__container {
		height: 170px;
	}
</style>
Expand Copy

# 方向

默认情况下，direction 为 horizontal。通过设置 direction 为 vertical 来让走马灯在垂直方向上显示。

<template>
	<tu-carousel
		style="width: 800px;"
		direction="vertical"
		:autoplay="false"
	>
		<tu-carousel-item
			v-for="image in images"
			:key="image"
		>
			<img :src="image" />
		</tu-carousel-item>
	</tu-carousel>
</template>

<script>
	export default {
		data() {
			return {
				images: [
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/cd7a1aaea8e1c5e3d26fe2591e561798.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/6480dbc69be1b5de95010289787d64f1.png~tplv-uwbnlip3yd-webp.webp",
					"https://p1-arco.byteimg.com/tos-cn-i-uwbnlip3yd/0265a04fddbd77a19602a15d9d55d797.png~tplv-uwbnlip3yd-webp.webp",
				],
			};
		},
	};
</script>
Expand Copy
参数 说明 类型 可选值 默认值
height 走马灯的高度 string — —
initial-index 初始状态激活的幻灯片的索引，从 0 开始 number — 0
trigger 指示器的触发方式 string click —
autoplay 是否自动切换 boolean — true
interval 自动切换的时间间隔，单位为毫秒 number — 3000
indicator-position 指示器的位置 string outside/none —
arrow 切换箭头的显示时机 string always/hover/never hover
type 走马灯的类型 string card —
loop 是否循环显示 boolean - true
direction 走马灯展示的方向 string horizontal/vertical horizontal
事件名称 说明 回调参数
change 幻灯片切换时触发 目前激活的幻灯片的索引，原幻灯片的索引
方法名 说明 参数
setActiveItem 手动切换幻灯片 需要切换的幻灯片的索引，从 0 开始；或相应 tu-carousel-item 的 name 属性值
prev 切换至上一张幻灯片 —
next 切换至下一张幻灯片 —
参数 说明 类型 可选值 默认值
name 幻灯片的名字，可用作 setActiveItem 的参数 string — —
label 该幻灯片所对应指示器的文本 string — —

← Collapse 折叠面板 →