vue-splide是一款基于vuejs3的轻量级、灵活的、利于SEO的轮播图组件。它的特点有:
- 使用TypeScript编写
- 没有任何依赖
- 轻量级,仅29KB
- 灵活可扩展
- 支持响应式短点(breakpoints)
- 支持鼠标和触摸手势滑动
- 支持懒加载
- 支持显示缩略图
使用方法
安装
如果您想使用vue-splide轮播图插件,首先您需要安装它,命令如下:
npm install @splidejs/vue-splide
使用
导入VueSplide并将其注册到您的Vue项目中。全局引用:
// main.js import { createApp } from 'vue'; import App from './App.vue'; import VueSplide from '@splidejs/vue-splide'; const app = createApp( App ); app.use( VueSplide ); app.mount( '#app' );
局部引用
// App.vue import { Splide, SplideSlide } from '@splidejs/vue-splide'; export default defineComponent( { components: { Splide, SplideSlide, }, } );
另外需要导入相应的样式文件
// Default theme import '@splidejs/vue-splide/css'; // or other themes import '@splidejs/vue-splide/css/skyblue'; import '@splidejs/vue-splide/css/sea-green'; // or only core styles import '@splidejs/vue-splide/css/core';
HTML结构
<template> <Splide :options="{ rewind: true }" aria-label="My Favorite Images"> <SplideSlide> <img src="image1.jpg" alt="Sample 1"> </SplideSlide> <SplideSlide> <img src="image2.jpg" alt="Sample 2"> </SplideSlide> </Splide> </template>
一个完整的示例代码
<template> <Splide :options="options" aria-label="My Favorite Images"> <SplideSlide> <img src="image1.jpg" alt="Sample 1"> </SplideSlide> <SplideSlide> <img src="image2.jpg" alt="Sample 2"> </SplideSlide> </Splide> </template> import { Splide, SplideSlide } from '@splidejs/vue-splide'; import { defineComponent } from 'vue'; export default defineComponent( { components: { Splide, SplideSlide, }, setup() { const options = { rewind: true, gap : '1rem', }; return { options }; } });
配置参数 options
- options: 轮播图的配置参数,是一个对象,具体内容参考这里
- tag:指定轮播图的根元素,可以是'div', 'section', 'header', 'footer' 或 'nav'中的一个。
- extensions:注册扩展插件。
- transition:自定义过渡动画。
- hasTrack:是否显示track。
github网址:https://github.com/Splidejs/splide