簡要教程
Wallop 是一款移動優先的純 JavaScript 幻燈片插件。它體積僅約 4k,原理只是為 HTML 元素加上或移除適當的 class 來控制顯示與隱藏,而這些 class 的樣式完全由你自訂。它的特色包括:
移動優先
動畫與過渡效果皆以 CSS 生成
輕量級,僅約 4k
高度靈活且易於擴展
可自訂事件與 API
沒有任何外部相依
使用方法
使用這款幻燈片插件,首先需要引入 wallop.css 與 Wallop.min.js 兩個檔案。
<link rel="stylesheet" href="path/to/wallop.css"> <script src="path/to/Wallop.min.js"></script>
HTML 結構
這個幻燈片的基本 HTML 結構如下,你可以為第一張 slide 加上 .Wallop-item--current class。
<div class="Wallop"> <div class="Wallop-list"> <div class="Wallop-item">…</div> <div class="Wallop-item">…</div> <div class="Wallop-item">…</div> <div class="Wallop-item">…</div> <div class="Wallop-item">…</div> </div> <button class="Wallop-buttonPrevious">Previous</button> <button class="Wallop-buttonNext">Next</button> </div>
初始化插件
<script> var wallopEl = document.querySelector('.Wallop'); var slider = new Wallop(wallopEl); </script>
添加動畫效果
這個幻燈片插件預設沒有動畫過渡效果。若想加上動畫,需引入對應的 wallop-animation.css 檔,並為元素加上 Wallop--xxxx class。例如要加上淡入淡出效果:
<head> <link rel="stylesheet" href="path/to/wallop.css"> <link rel="stylesheet" href="path/to/wallop-fade.css"> </head> <div class="Wallop Wallop--fade"> ... </div>
可用動畫類型
這款幻燈片可用的過渡動畫類型有:
Wallop--slide
Wallop--fade
Wallop--scale
Wallop--rotate
Wallop--fold
Wallop--vertical-slide
以上是內建的過渡動畫類型,你也可以自訂屬於自己的過渡動畫。
配置參數
以下是一些可用的配置參數:
buttonPreviousClass: 'Wallop-buttonPrevious'
buttonNextClass: 'Wallop-buttonNext'
itemClass: 'Wallop-item'
currentItemClass: 'Wallop-item--current'
showPreviousClass: 'Wallop-item--showPrevious'
showNextClass: 'Wallop-item--showNext'
hidePreviousClass: 'Wallop-item--hidePrevious'
hideNextClass: 'Wallop-item--hideNext'
carousel: true
方法
Wallop 幻燈片插件提供一些基本方法,供按鈕控制使用:
goTo
允許跳轉到指定 index 的幻燈片上。
var slider = document.querySelector('.Wallop'); var Wallop = new Wallop(slider); // 跳轉到第二個slide(index從0開始) Wallop.goTo(1);
next
跳轉到下一張幻燈片 slide。
var slider = document.querySelector('.Wallop'); var Wallop = new Wallop(slider); // 跳轉到下一個slide Wallop.next();
previous
跳轉到前一張幻燈片 slide。
var slider = document.querySelector('.Wallop'); var Wallop = new Wallop(slider); // 跳轉到前一個slide Wallop.previous();
事件
Wallop 在每次 slide 改變時都會發出一個事件,它回傳一個 detail 物件,其中包含目前 slide 的 index 與 Wallop 物件本身。
var slider = document.querySelector('.Wallop'); var Wallop = new Wallop(slider); Wallop.on('change', function(event) { // event.detail.wallopEl // => <div class="Wallop">…</div> // event.detail.currentItemIndex // => number });
以上就是為大家分享的純 JavaScript 移動優先幻燈片效果的制作過程,希望能幫助大家打造更精美的幻燈片。