Viewer.js 使用手冊詳解

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。