Slideshow2 是一款基於 **MooTools 1.2** 的簡易幻燈片庫,特點是**無導航條、無縮略圖、純粹的淡入淡出切換**,適合極簡場景。本文整理其引入方式、初始化配置、過渡效果擴展、核心參數表,並提供現代替代方案建議。
<link rel="stylesheet" type="text/css" href="css/slideshow.css" media="screen" />
<script type="text/javascript" src="js/mootools.js"></script>
<script type="text/javascript" src="js/slideshow.js"></script>
<div id="show" class="slideshow">
<img src="images/1.jpg" alt="首張圖片說明" />
</div>
<script type="text/javascript">
window.addEvent('domready', function() {
// 圖片資料映射:檔名 → { caption: "標題" }
var data = {
'1.jpg': { caption: '' },
'2.jpg': { caption: 'A Ceibu tree.' },
'3.jpg': { caption: 'The view from Volcano Maderas.' },
'4.jpg': { caption: 'Beer and ice cream.' }
};
var myShow = new Slideshow('show', data, {
controller: false, // 不顯示導航條
height: 300, // 容器高度
hu: 'images/', // 圖片基礎路徑
thumbnails: false, // 不顯示縮略圖
width: 400 // 容器寬度
});
});
</script>
| 參數 | 類型 | 預設值 | 說明 |
|---|---|---|---|
controller | Boolean | true | 是否顯示播放/暫停/上一張/下一張控制器 |
delay | Integer | 2000 | 每張圖片停留時間(毫秒) |
duration | Integer | 750 | 切換動畫持續時間(毫秒) |
loop | Boolean | true | 是否循環播放 |
random | Boolean | false | 是否隨機播放順序 |
titles | Boolean | true | 是否將 caption 設為圖片 title 屬性 |
transition | String/Class | Sine | 過渡效果:Sine、Flash、Kenburns、Push、Fold |
hu | String | '' | 圖片資源基礎 URL 路徑 |
thumbnails | Boolean | false | 是否顯示縮略圖導航 |
width/height | Integer | 容器尺寸 | 強制設定容器尺寸(響應式建議用 CSS) |
Slideshow2 採用**類擴展模式**:每種效果對應一個獨立 JS 檔,繼承自 Slideshow 基類。
slideshow.flash.js → Slideshow.Flash:閃爍切換slideshow.fold.js → Slideshow.Fold:摺疊效果slideshow.kenburns.js → Slideshow.Kenburns:肯伯恩斯效果(縮放+平移)slideshow.push.js → Slideshow.Push:推入效果<!-- 1. 引入基礎核心 -->
<script src="js/slideshow.js"></script>
<!-- 2. 引入想要的效果擴展(可多個) -->
<script src="js/slideshow.kenburns.js"></script>
<script>
window.addEvent('domready', function() {
var data = { ... };
// 3. 實例化時指定效果類名(大寫開頭)
var myShow = new Slideshow.Kenburns('show', data, {
controller: false,
height: 300,
hu: 'images/',
thumbnails: false,
width: 400
});
});
</script>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Slideshow2 Kenburns Demo</title>
<link rel="stylesheet" href="css/slideshow.css">
<style>
.slideshow { margin: 20px auto; border: 1px solid #ccc; }
</style>
</head>
<body>
<div id="show" class="slideshow">
<img src="images/1.jpg" alt="Volcano" />
</div>
<script src="js/mootools.js"></script>
<script src="js/slideshow.js"></script>
<script src="js/slideshow.kenburns.js"></script>
<script>
window.addEvent('domready', function() {
var data = {
'1.jpg': { caption: 'Volcano Asención' },
'2.jpg': { caption: 'Ceibu tree' },
'3.jpg': { caption: 'Volcano Maderas view' },
'4.jpg': { caption: 'Beer and ice cream' }
};
new Slideshow.Kenburns('show', data, {
controller: true,
delay: 3000,
duration: 1000,
hu: 'images/',
width: 600,
height: 400
});
});
</script>
</body>
</html>
| 痛點 | 現代替代方案 |
|---|---|
| 依賴 MooTools(已停止維護、體積大、與 jQuery/Vue/React 衝突) | Swiper (原生/React/Vue/Svelte)、Splide、Glide.js、Embla Carousel |
| 無觸控/滑動支援 | 現代庫原生支援觸控、拖拽、鍵盤導航 |
| 無響應式斷點配置 | Swiper/Splide 內建 breakpoints 響應式 |
| 無無障礙 (a11y) 支援 | 現代庫符合 ARIA 標準 |
| 無懶加載、預載入、虛擬滑塊 | 大型輪播必備效能優化 |
<!-- 1. 引入 Swiper (CDN) -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.css">
<script src="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.js"></script>
<div class="swiper">
<div class="swiper-wrapper">
<div class="swiper-slide"><img src="images/1.jpg"></div>
<div class="swiper-slide"><img src="images/2.jpg"></div>
<div class="swiper-slide"><img src="images/3.jpg"></div>
</div>
<div class="swiper-pagination"></div>
<div class="swiper-button-prev"></div>
<div class="swiper-button-next"></div>
</div>
<script>
new Swiper('.swiper', {
loop: true,
autoplay: { delay: 3000 },
pagination: { el: '.swiper-pagination' },
navigation: { nextEl: '.swiper-button-next', prevEl: '.swiper-button-prev' },
effect: 'fade', // 或 'slide', 'cube', 'coverflow', 'flip'
fadeEffect: { crossFade: true }
});
</script>
Slideshow2 曾是 MooTools 時代的輕量之選,但隨著生態演進,**MooTools 已成為歷史**。維護舊專案時可參考本文配置;新專務請直接選擇 **Swiper、Splide、Embla Carousel** 等現代、無依賴、Tree-shakable、TypeScript 友好的輪播庫,獲得更好的效能、體驗與維護性。