Viewer.js 是一个功能强大的 JavaScript 图片查看插件,它支持预览图片、缩放、旋转、翻转、裁剪、以及滤镜和水印等多种操作。本文将从以下几个方面对 Viewer.js 的使用手册进行详细的阐述。
一、安装及使用
1、下载 Viewer.js
<script src="js/viewer.js"></script>
2、安装 Viewer.js
var viewer = new Viewer(document.getElementById('myImage'));
3、使用 Viewer.js
<img src="image.jpg" id="myImage">
二、配置选项
1、设置默认选项
Viewer.setDefaults({
url: 'data-original'
});
2、指定单个选项
var viewer = new Viewer(document.getElementById('myImage'), {
viewed() {
console.log('触发 viewed');
}
});
3、指定多个选项
var viewer = new Viewer(document.getElementById('myImage'), {
url: 'data-original',
title: true
});
三、回调事件
1、viewed
var viewer = new Viewer(document.getElementById('myImage'), {
viewed() {
console.log('触发 viewed');
}
});
2、viewing
var viewer = new Viewer(document.getElementById('myImage'), {
viewing(event) {
console.log(event.detail);
}
});
3、viewed
var viewer = new Viewer(document.getElementById('myImage'), {
viewed(event) {
console.log(event.detail);
}
});
四、API 方法
1、show
var viewer = new Viewer(document.getElementById('myImage'));
viewer.show();
2、hide
var viewer = new Viewer(document.getElementById('myImage'));
viewer.hide();
3、view
var viewer = new Viewer(document.getElementById('myImage'));
viewer.view();
五、插件扩展
1、滤镜插件
Viewer.filter('grayscale', function(event) {
event.canvas.canvas.getContext('2d').globalCompositeOperation = 'color';
event.canvas.drawImage(event.image, 0, 0, event.canvas.width, event.canvas.height);
});
2、水印插件
Viewer.watermark.create({
el: '#myImage',
text: 'watermark'
});
六、常见问题
1、无法加载图片
答:请检查图片路径是否正确,以及服务器是否支持跨域访问。
2、图片缩放不流畅
答:请尝试使用 CSS3 加速(GPU 加速)方式,即在 CSS 中添加以下代码:
-webkit-transform: translateZ(0);
-moz-transform: translateZ(0);
-ms-transform: translateZ(0);
-o-transform: translateZ(0);
transform: translateZ(0);
3、图片旋转不生效
答:请先检查旋转角度是否正确,旋转角度应为 -180° 到 180° 的整数倍数。如果问题仍未解决,请检查图片是否加载完整。
七、总结
以上就是 Viewer.js 的使用手册详解,包括了安装及使用、配置选项、回调事件、API 方法、插件扩展、常见问题等多个方面。希望本文能够帮助大家更好地使用 Viewer.js。