簡要教程

magnificent.js是一款響應式jQuery圖片放大鏡插件。該圖片放大鏡插件提供2種圖片縮放模式：圖片內部縮放和圖片外部縮放。并且可以在圖片上使用鼠標滾輪來對圖片進行局部縮放。

安裝

可以通過npm或bower來安裝magnificent.js圖片放大鏡插件。

bower install magnificent --save
npm i magnificent --save

使用方法

該插件下載后有幾個可選的外部依賴庫，用于完成特定的功能：

• jquery.mousewheel.js：用于鼠標滾動局部縮放或移動touchpad-pinch縮放。

• jquery.event.drag.js：用于拖放交互。

• screenfull.js：用于全屏顯示。

• hammer.js：用于移動觸摸交互（平移或pinch）。

• PreventGhostClick.js：用于移動觸摸交互（平移或pinch）。

<script src="bower_components/jquery/dist/jquery.js"></script>
<script src="bower_components/jquery-bridget/jquery.bridget.js"></script>
<script src="bower_components/jquery-mousewheel/jquery.mousewheel.js"></script>
<script src="bower_components/jquery.threedubmedia/event.drag/jquery.event.drag.js"></script>
<script src="bower_components/screenfull/dist/screenfull.js"></script>
<script src="bower_components/hammerjs/hammer.js"></script>
<script src="bower_components/prevent-ghost-click/PreventGhostClick.js"></script>

然后需要調用插件本身需要的文件：

<script src="bower_components/magnificent/src/js/mag-analytics.js"></script>
<script src="bower_components/magnificent/src/js/mag.js"></script>
<script src="bower_components/magnificent/src/js/mag-jquery.js"></script>
<script src="bower_components/magnificent/src/js/mag-control.js"></script>
<link rel="stylesheet" href="bower_components/magnificent/src/css/mag.css" />
<link rel="stylesheet" href="bower_components/magnificent/src/theme/default.css" />

HTML結構

圖片內部放大鏡的HTML結構為：

<div mag-thumb="inner">
  <img src="img/alley/500x300.jpg" />
</div>
<div mag-zoom="inner">
  <img src="img/alley/1000x600.jpg" />
</div>

圖片外部放大鏡的HTML結構為：

<div mag-thumb="outer">
  <img src="img/alley/500x300.jpg" />
</div>
<div style="width: 300px; height: 300px;">
  <div mag-zoom="outer">
    <img src="img/alley/1000x600.jpg" />
  </div>
</div>

初始化插件

初始化圖片內部放大鏡：

$host = $('[mag-thumb="inner"]');
$host.mag();

初始化圖片外部放大鏡：

$host = $('[mag-thumb="outer"]');
$host.mag({
  mode: 'outer',
  ratio: 1 / 1.6
});

配置參數

• mode：放大鏡的模式。可選值有："inner"和"outer"。

• position：指定縮放交互區域的位置。

• "mirror"：默認值。縮放區域跟隨鼠標位置。

• "drag"：拖動移動。

• "joystick"：Weird joystick交互。

• false：No mouse/touch。

• positionEvent：定位的事件。

• "move"：默認值。鼠標移動。

• "hold"：按住鼠標。

• theme：主題。默認值為"default"。

• initialShow：是否顯示縮略圖，如“inner”模式。默認值為"thumb"。

• zoomRate：是否的比例，值從0到∞，默認值為0.2。

• zoomMin：允許的最小縮放等級。值從0到∞，默認值為2。

• zoomMax：允許的最大縮放等級。值從0到∞，默認值為10。

• ratio：外部容器和內部容器的比例，默認值為1。

• constrainLens：是否約束放大鏡的位置。默認值為true。

• constrainZoomed：是否約束縮放區域。默認值為false。

• toggle：Whether toggle display of zoomed vs. thumbnail upon interaction.Default = true.

• smooth：縮放區域是否逐漸接近目標，而不是立刻（平滑過渡）。默認為true。

• cssMode：縮放和轉換的CSS模式，是3D還是2D，默認為3D。

• initial：初始化模式-focus, lens, zoom等。