前端插件swiper基础使用详解含部分常用API
swiper插件
swiper是一款功能强大、开源、免费的的前端轮播图插件。而且面向手机平板等移动终端(更多介绍可以去官网进行查看)。
最近做项目时用到了这个插件,官网的文档看的我很难受!
使用方法
导入文件
首先这个插件和其他的插件一样要引入文件,不同Swiper版本用到的文件名略有不同。我下载的版本是swiper-6.4.15版本里面有一堆奇奇怪怪的文件包含了在里面。我们在package文件夹下找到下面这四个文件放入你的项目里就可以了,
最后我们导入这两个文件就可以使用了
<link rel="stylesheet" href="css/swiper-bundle.min.css">
<script src="./js/swiper-bundle.min.js"></script>
添加html部分
1.swiper-container最外层的div是一个容器
2.swiper-wrapper是一个按照一定顺序排列的所有轮播图的集合,在默认情况下是从左到右排列
3.swiper-slide:你的每一张轮播图。
4.swiper-pagination是分页器导航,也就是下图所显示的原点
5.swiper-button-prev swiper-button-next 插件默认的按钮左右箭头
6.swiper-scrollbar滚动条
这段代码是官网上的可以直接复制使用,
<div class="swiper-container"><div class="swiper-wrapper"><div class="swiper-slide"><img src="./image/轮播/202104011128519006001.jpg" alt=""></div><div class="swiper-slide"><img src="./image/轮播/202104011133182944010.jpg" alt=""></div><div class="swiper-slide"><img src="./image/轮播/202104121130451705637.png" alt=""></div></div><!-- 如果需要分页器 --><div class="swiper-pagination"></div><!-- 如果需要导航按钮 --><div class="swiper-button-prev"></div><div class="swiper-button-next"></div><!-- 如果需要滚动条 --><div class="swiper-scrollbar"></div></div>
在写完html代码后我们还需要对这个轮播图进行初始化
<script>var swiper = new Swiper('.swiper-container', {pagination: {el: '.swiper-pagination',dynamicBullets: true,},});
</script>
这个初始化有两个参数
第一个参数:Swiper容器的css选择器,当然你也可以把.swiper-container换成任何你自定义的名字。
第二个参数:Swiper的个性化配置。(是以一个对象的形式传参的)
在完成上面几步后轮播图主体就完成了。
下面我介绍几种常用的API
常用的API
其实我觉得你可以理解为给第二个参数(这个对象)设置属性值。属性名默认给你了
pagination(分页器)
pagination是一个对象这个对象也有属性
el: '.swiper-pagination'
el: 分页器容器的css选择器或HTML标签。分页器等组件可以置于container之外,(也就是说你的分页器可以放在轮播图容器的外面)
type: 'bullets'
type: 分页器的样式
可选类型:
‘bullets’ 圆点(默认)
‘fraction’ 分式
‘progressbar’ 进度条
‘custom’ 自定义
dynamicBullets: true
dynamicBullets: 动态分页器,当你的slide很多时,开启后,分页器小点的数量会部分隐藏。
hideOnClick :true
hideOnClick : 点击轮播图时隐藏分页器
clickable :true
clickable : 设置后你可以通过点击来使轮播图片切换
renderBullet: function (index, className) {return '<span class="' + className + '">' + (index + 1) + '</span>';}
**renderBullet: ** 设置了这个属性你就可以设置自己的分页器样式,该属性是一个函数类型,参数是下标索引和类名
(类名默认是swiper-pagination-bullet你不用管他)
这个函数的返回值会添加在swiper-pagination中你也可以 在返回值中拼接img标签完成用图片切换轮播图
navigation(前进后退按钮)
var mySwiper = new Swiper('.swiper-container', {navigation: {nextEl: '.swiper-button-next',prevEl: '.swiper-button-prev',},});
nextEl: '.swiper-button-next'prevEl: '.swiper-button-prev'
不多说默认的左箭头和右箭头
记住.swiper-button-next找 nextEl 下一张
.swiper-button-prev找 prevEl 上一张
你要是搞反了,会出现点击左箭头跑到下一张的情况
autoplay(自动轮播)
delay: 2000//2秒切换一次
delay: 自动轮播的时间,延时多少秒切换下一张图片
disableOnInteraction: false
**disableOnInteraction: ** 在设置false时,你对轮博图操作不会停止循环,而true,在你对轮博图操作时会停止自动轮播
//鼠标覆盖停止自动切换
mySwiper.el.onmouseover = function(){mySwiper.autoplay.stop();
}//鼠标离开开始自动切换
mySwiper.el.onmouseout = function(){mySwiper.autoplay.start();
}
**mySwiper.autoplay.stop() mySwiper.autoplay.start()**一个开始轮播,一个暂停轮播,不多说,那个mySwiper应该是可以修改的,名字是你初始化的swiper名字。
methods(swiper方法)
这些方法一般用在外部的元素操控轮播图的切换
mySwiper.slideTo(0, 1000, false);//切换到第一个slide,速度为1秒
mySwiper.slideTo 这个就是根据下标来切换指定的图片(还挺有用的,我这个项目正好用到这个方法了)第三个值:设置为false时不会触发transition回调函数
$('#btn1').click(function(){mySwiper.slidePrev();})$('#btn2').click(function(){mySwiper.slideNext();})
mySwiper.slidePrev() mySwiper.slideNext()
看到这个next和prev就知道这个控制切换上一张和下一张的方法
properties(swiper方法)
mySwiper.realIndex
mySwiper.realIndex 获取当前轮播图的索引(感觉这个用到的地方会很多)从0开始
mySwiper.isEnd
mySwiper.isEnd 判断是不是最后一张轮播图。
(如果这篇文章有什么问题请及时联系我!)
前端插件swiper基础使用详解含部分常用API相关推荐
- 详解介绍Selenium常用API的使用--Java语言(史无前例的完整)
一共分为二十个部分:环境安装之Java.环境安装之IntelliJ IDEA.环境安装之selenium.selenium3浏览器驱动.selenium元素定位.控制浏览器操作.WebDriver常用 ...
- python+selenium——详解介绍Selenium常用API的使用--python语言(完整版)
参考:http://www.51testing.com/html/03/n-3725703-2.html from selenium import webdriver driver = webdriv ...
- [转帖]前端-chromeF12 谷歌开发者工具详解 Sources篇
前端-chromeF12 谷歌开发者工具详解 Sources篇 原贴地址:https://blog.csdn.net/qq_39892932/article/details/82498748 cons ...
- vue-cli脚手架配置基础文件详解/新手入门必看
vue-cli 脚手架中webpack 配置基础文件详解 需要Word版本 的小伙伴可以发我邮件2445478193@qq.com 一.前言 vue-cli是构建vue单页应用的脚手架,输入一串指定的 ...
- ES6 — Promise基础用法详解(resolve、reject、then、catch,all,)
ES6 - Promise基础用法详解 Promise 是一个构造函数,它自身拥有all.reject.resolve这几个眼熟的方法, 原型上有then.catch等同样熟悉的方法. 所以,在开始一 ...
- Henry前端笔记之 Date对象详解
Henry前端笔记之 Date对象详解 Date 对象 1 时间格式简介 2 Date.now 与 new Date().getTime() 的区别 3 Date对象详解 普通函数的用法 构造函数的用 ...
- java写mapstate算子,vuex state及mapState的基础用法详解
vuex state及mapState的基础用法详解 2019-01-07 编程之家收集整理的这篇文章主要介绍了vuex state及mapState的基础用法详解,编程之家小编觉得挺不错的,现在分享 ...
- java基础(十三)-----详解内部类——Java高级开发必须懂的
java基础(十三)-----详解内部类--Java高级开发必须懂的 目录 为什么要使用内部类 内部类基础 静态内部类 成员内部类 成员内部类的对象创建 继承成员内部类 局部内部类 推荐博客 匿名内部 ...
- Nmap扫描教程之基础扫描详解
Nmap扫描教程之基础扫描详解 Nmap扫描基础扫描 当用户对Nmap工具了解后,即可使用该工具实施扫描.通过上一章的介绍,用户可知Nmap工具可以分别对主机.端口.版本.操作系统等实施扫描.但是,在 ...
最新文章
- Java脚本学习-笔记二
- 生命银行怎么样_银行双职工的家庭现状...
- TortoiseSVN搭载
- 请说明一下Spring中BeanFactory和ApplicationContext的区别是什么?
- MFC Radio Button 使用 分组 RadioButton 用法
- 04_类与对象_课程动手动脑问题以及课后实验性问题及解答集锦
- 区块链跟银行有什么关系?
- javascript实现较全功能注册表单
- CDN > 域名管理 > 访问控制 > URL鉴权配置 > URL鉴权
- c 语言表达式求值中缀变后缀,表达式求值关于中缀式转后缀式的问题!
- javascript基础知识系列:eval()
- 蚂蚁链发布BTN,有什么用?
- Maxscript-通用事件反馈
- 计算机提示pdf不能加载,打开电脑中的PDF文档无法显示内容提示Please wait怎么解决...
- amd cpu 安卓模拟器_Android 模拟器现已支持 AMD 处理器和 Hyper-V
- ImportError: DLL load failed while importing ie_api
- 关于.length与.length()的问题
- 物质模拟器4.0版 改了bug,爆炸时也可移动
- java让一个方法等待_如何写一个“等待”的方法?
- 机器学习之ID3算法(小白入门级别)
热门文章
- 冯山C语言第六章作业答案,冯山《山路梅花》阅读答案及翻译赏析
- 戴尔台式机win7系统u盘插上去没反应
- 差分曼彻斯特第一位判断方法
- MacBook笔记本打不开github解决方案
- Riak学习(1):Linux Centos 下安装 Riak 服务
- 关于unicode编码
- 老笔记本安装CENTOS和FTP调试
- 南京林业计算机技术883,2018年南京林业大学信息科学技术学院883电工及电子技术之电工学-电工技术考研核心题库...
- android APP隐藏NavigationBar,通过修改framework隐藏/显示 navigation bar
- 时间轴_字节跳动大事件