支持移动设备的响应式js lightbox插件_jQuery之家-自由分享jQuery、html5、css3的插件库

简要教程

baguetteBox.js是一款支持移动设备的响应式lightbox插件。baguetteBox.js有纯javascript编写，支持响应式图片和CSS3动画过渡效果，支持移动手机，压缩后的版本仅2.7K。baguetteBox.js插件的特点还有：

同一个页面支持多个lightbox实例，互不影响。
支持移动触摸设备。
支持全屏模式。
支持显示图片标题。
支持响应式图片。
支持CSS3过渡动画。
按钮使用SVG，不需要额外的图片。
压缩后的版本仅2.7K。

安装

可以通过npm、yarn或bower来安装baguetteBox.js插件。

npm install baguettebox.js --save
yarn add baguettebox.js
bower install baguettebox.js --save

使用方法

在页面中引入baguetteBox.js和baguetteBox.css文件。

<link rel="stylesheet" href="path/to/baguetteBox.css">
<script src="path/to/baguetteBox.js"></script>

HTML结构

baguetteBox.js lightbox图片画廊的基本HTML结构如下：

<div class="gallery">
    <a href="img/2-1.jpg" data-caption="Image caption">
        <img src="img/thumbs/2-1.jpg" alt="First image">
    </a>
    <a href="img/2-2.jpg">
        <img src="img/thumbs/2-2.jpg" alt="Second image">
    </a>
    ...
</div>

如果要使用图片标题，可以在a标签上添加title或data-caption属性。

初始化插件

在页面DOM元素加载完毕，可以通过run()方法来初始化该lightbox插件。其中传入的参数为图片画廊的父容器选择器名称。

baguetteBox.run('.gallery');

配置参数

你可以在初始化时，在第二个参数中以对象的方式传入配置参数：

baguetteBox.run('.gallery', {
    // 配置参数
});

参数	类型	默认值	描述
captions	Boolean \| function(element)	true	是否显示图片标题。如果传入的是一个函数，必须返回一个字符串。
buttons	Boolean \| 'auto'	'auto'	是否显示导航按钮。设置为auto表示在移动设备或仅有一张图片时隐藏导航按钮。
fullScreen	Boolean	false	是否允许全屏模式。
noScrollbars	Boolean	false	是否在画廊显示时隐藏滚动条。
titleTag	Boolean	false	是否使用图片上的title属性作为图片标题。
async	Boolean	false	是否异步加载文件。
preload	Number	2	预加载多少个文件。
animation	'slideIn' \| 'fadeIn' \| false	'slideIn'	过渡动画的类型。
afterShow	function	null	显示遮罩层之后的回调函数。
afterHide	function	null	隐藏遮罩层之后的回调函数。
onChange	function(currentIndex, imagesCount)	null	图片改变时的回调函数。
overlayBackgroundColor	String	'rgba(0,0,0,0.8)'	lightbox遮罩层的背景颜色。
filter	RegExp	`/.+.(gif	jpe?g

方法API

baguetteBox.js插件有4个可用的方法：

run：初始化baguetteBox.js插件。
showNext：切换到下一张图片。
showPrevious：切换到前一张图片。
destroy：销毁插件和绑定的事件。

响应式图片

要使用响应式图片特性，只需要在a标签上设置data-at-{width}属性。其中{width}指的是最大屏幕宽度。例如：

<a href="img/2-1.jpg"
  data-at-450="img/thumbs/2-1.jpg"
  data-at-800="img/small/2-1.jpg"
  data-at-1366="img/medium/2-1.jpg"
  data-at-1920="img/big/2-1.jpg">
    <img src="img/thumbs/2-1.jpg">
</a>

如果你的屏幕分辨率是1366x768，那么baguetteBox.js插件就会选择"img/medium/2-1.jpg"这张图片来显示。二如果屏幕分辨率是1440x900，插件会选择"img/big/2-1.jpg"这张图片。href属性中指定的图片是为了兼容旧的浏览器二设置的一张通用图片。

baguetteBox.js响应式lightbox插件的github地址为：https://github.com/feimosi/baguetteBox.js