萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Slideshow2:基於 MooTools 的輕量級 JavaScript 幻燈片插件使用指南

前言

Slideshow2 是一款基於 **MooTools 1.2** 的簡易幻燈片庫,特點是**無導航條、無縮略圖、純粹的淡入淡出切換**,適合極簡場景。本文整理其引入方式、初始化配置、過渡效果擴展、核心參數表,並提供現代替代方案建議。

一、快速開始

1. 引入必要資源

<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>

2. HTML 結構

<div id="show" class="slideshow">
    <img src="images/1.jpg" alt="首張圖片說明" />
</div>

3. JavaScript 初始化

<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>

二、核心配置參數詳解

參數類型預設值說明
controllerBooleantrue是否顯示播放/暫停/上一張/下一張控制器
delayInteger2000每張圖片停留時間(毫秒)
durationInteger750切換動畫持續時間(毫秒)
loopBooleantrue是否循環播放
randomBooleanfalse是否隨機播放順序
titlesBooleantrue是否將 caption 設為圖片 title 屬性
transitionString/ClassSine過渡效果:Sine、Flash、Kenburns、Push、Fold
huString''圖片資源基礎 URL 路徑
thumbnailsBooleanfalse是否顯示縮略圖導航
width/heightInteger容器尺寸強制設定容器尺寸(響應式建議用 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>

四、完整工作示例(含 Kenburns 效果)

<!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>

五、遷移建議:為什麼 2024 年不再推薦 Slideshow2?

痛點現代替代方案
依賴 MooTools(已停止維護、體積大、與 jQuery/Vue/React 衝突)Swiper (原生/React/Vue/Svelte)、Splide、Glide.js、Embla Carousel
無觸控/滑動支援現代庫原生支援觸控、拖拽、鍵盤導航
無響應式斷點配置Swiper/Splide 內建 breakpoints 響應式
無無障礙 (a11y) 支援現代庫符合 ARIA 標準
無懶加載、預載入、虛擬滑塊大型輪播必備效能優化

現代替代:Swiper 3 分鐘上手

<!-- 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 友好的輪播庫,獲得更好的效能、體驗與維護性。

copyright © 萬盛學電腦網 all rights reserved