MPreview.js
移动端图片预览组件，支持手势缩放，双击放大，缩小
Demo 预览 (扫一扫)
插件说明
- 插件依赖 QuoJS，一款移动端的手势库。
- 兼容性 Android 4.4+, iOS 8.0+ 下的自带浏览器测试能过。
- 组件只适合
移动端PC版请移步 MPreview.PC
如何使用
<!-- Load MPreview CSS && JS -->
<link rel="stylesheet" type="text/css" href="css/MPreview.mobile.css"/>
<script type="text/javascript" src="js/quo.js"></script>
<script type="text/javascript" src="js/MPreview.mobile.js"></script>
<!-- 用于显示组件的容器 -->
<div class="overlay" id="overlay"></div>
<!-- 初始化 -->
<script type="text/javascript">
MPreview({
data: ['xxxx/1.jpg', 'xxxx/2.jpg', 'xxxx/3.jpg'],
wrap: '#overlay',
});
</script>
PS: 如果引用的是 `MPreview.mobile.min.js`，则无需在引用 QuoJS 手势库，因为 `MPreview.mobile.min.js` 打包时一并把 `QuoJS` 打包进来了。API
MPreview({options});options 说明
| 参数名 | 默认值 | 类型 | 参数说明 |
|---|---|---|---|
| url | null |
{String} | 初始化插件时，用于Ajax获取图片数据的地址，如果参数 data 存在，则不发送Ajax请求，Ajax发送的为GET请求，Ajax需返回JSON格式。 |
| data | null |
{Array} | 存放需要展示的图片数据，如果填写了此参数，Ajax请求则不会发送。data: ['111.jpg', '2222.jpg', '3333.jpg'] |
| title | 【浏览】 |
{String} | 显示于组件头部的标题内容 |
| params | {} |
{Object} | Ajax发送到服务器的数据。将自动转换为请求字符串格式。 |
| wrap | body |
{String} | 指定在哪个容器下显示，支持 document.querySelector 的选择器。如：.class, element, #id, ul > li; |
| direction | top |
{String} | 指定图片按哪个方向切换，top 上下切换，left 左右切换。 |
| placeholder | images/placeholder.gif |
{String} | 透明图片占位符的地址 |
| init | null |
{Function} | 组件在初始化之前所调用的方法 |
| close | null |
{Function} | 关闭组件时的回调方法 |
//Ajax 须返回如下JSON格式
{
code: 1,
imgs: [
'xxxx.jpg',
'xxxx.jpg',
'xxxx.jpg'
]
}销毁组件
var MP = MPreview({
data: ['xxxx/1.jpg', 'xxxx/2.jpg', 'xxxx/3.jpg'],
wrap: '#overlay',
});
//销毁
MP.destroy();目录说明
MPreview/
├── css/
│ ├── normalize.css (重置样式)
│ └── MPreview.mobile.css (插件所需样式)
├── images/
│ ├── MPreview.mobile.loading.gif (加载图片等待动画)
│ └── placeholder.gif (图片占位符)
├── js/
│ ├── quo.js (QuoJS 手势库)
│ ├── MPreview.mobile.js (组件未压缩源码)
│ └── MPreview.mobile.min.js (组件压缩源码 已包含QuoJS))
├── gulpfile.js (gulp 打包文件)
└── index.html (Demo展示)
PS: 在次强掉 MPreview.mobile.min.js 中已包含 QuoJS 手势库，由打包时候一起打包。如使用压缩版，则不需要在次引用 QuoJS 。
联系作者
Blog：http://webjyh.com
Weibo：http://weibo.com/webjyh/