DIV CSS 佈局教程網

從零打造 jQuery 焦點輪播插件:完整實作筆記
編輯:JQuery特效代碼     

首頁幾乎一定要有一組焦點輪播。做專案時在網上找到一個半成品插件,改掉不合用的部分後整理成這份筆記,順便記錄一個 jQuery 插件的標準骨架該長什麼樣子。

js 資料夾下有兩個檔案:jquery.jslide.js 是改寫後的版本,jquery.jslides.js 保留原作者的版本以備對照。

一、靜態結構與樣式

<div class="slide_wrap">
  <ul id="slides2" class="slide">
    <li style="background:url('images/01.jpg') no-repeat center top">
      <a href="https://www.cnblogs.com/" target="_blank">pwstrick1</a></li>
    <li style="background:url('images/02.jpg') no-repeat center top">
      <a href="https://www.cnblogs.com/" target="_blank">pwstrick2</a></li>
    <li style="background:url('images/03.jpg') no-repeat center top">
      <a href="https://www.cnblogs.com/" target="_blank">pwstrick3</a></li>
    <li style="background:url('images/04.jpg') no-repeat center top">
      <a href="https://www.cnblogs.com/" target="_blank">pwstrick4</a></li>
  </ul>
</div>

幾個設計決定值得說明:

1. 用 background 而非 img 呈現圖片。現在流行寬幅焦點圖,用背景圖就不會因為圖片寬度超出視窗而產生橫向捲軸。

2. 外層 slide_wrap 作為定位錨點。裡面的 li 全都是絕對定位疊在一起,需要一個 relative 的父層來對齊。

3. class 預先寫在 HTML 裡。原本是在插件初始化時才加上去,改成先寫好,顯示效果比較穩定——因為少了「先以無樣式狀態渲染、再套上樣式」的閃爍。

.slide_wrap { width: 100%; height: 400px; position: relative; }
.slide_wrap .slide {
    display: block; width: 100%; height: 400px;
    list-style: none; padding: 0; margin: 0; position: relative;
}
.slide_wrap .slide li {
    display: block; width: 100%; height: 100%;
    list-style: none; padding: 0; margin: 0; position: absolute;
}
.slide_wrap .slide li a {
    display: block; width: 100%; height: 100%; text-indent: -9999px;
}
.slide_wrap .pagination {
    display: block; list-style: none;
    position: absolute; left: 50%; top: 340px;
    z-index: 9900; padding: 5px 15px 5px 0; margin: 0;
}
.slide_wrap .pagination li {
    display: block; list-style: none;
    width: 10px; height: 10px; float: left;
    margin-left: 15px; border-radius: 5px; background: #FFF;
}
.slide_wrap .pagination li a {
    display: block; width: 100%; height: 100%;
    padding: 0; margin: 0; text-indent: -9999px; outline: 0;
}
.slide_wrap .pagination li.current { background: #0092CE; }

slide_wrap 與 slide 的高度可依實際版面調整;pagination 是下方的小圓點,left 與 top 決定它的位置;各項顏色都能依主題替換。

二、呼叫方式

<script type="text/javascript">
$('#slides2').jslide();
</script>

把 ul 交給插件,之後所有操作都圍繞這個 ul 進行。

三、jQuery 插件的通用骨架

;(function (factory) {
    'use strict';
    // 支援 AMD 模組載入器(如 RequireJS)
    if (typeof define === 'function' && define.amd) {
        define(['jquery'], factory);
    } else {
        factory(jQuery);
    }
}(function ($, undefined) {
    'use strict';

    $.fn.jslide = function (method) {
        return _init.apply(this, arguments);
    };
}));

這個骨架裡每個看似奇怪的細節都有理由:

開頭的分號是為了防止插件被壓縮合併成一行時,與前一段程式碼黏在一起造成語法錯誤,例如 var i=0(function(factory){...}(..));。

'use strict' 開啟嚴格模式,讓 JS 引擎以更嚴格的規則解析,能提早發現例如未宣告變數、刪除不可刪除的屬性等問題。

define 那段讓插件相容於 AMD 規範,使用 RequireJS 的專案才能正確載入。

function ($, undefined) 裡的 undefined 參數,是為了避免其他腳本把全域的 undefined 重新賦值,導致插件內部的 undefined 判斷失效。

四、初始化

var defaults = {
    speed: 3000,
    pageCss: 'pagination',
    auto: true          // 是否自動切換
};
var nowImage = 0;       // 目前顯示第幾張
var pause = false;      // 是否暫停
var autoMethod;         // 定時器編號

function _init(opts) {
    opts = $.extend({}, defaults, opts || {});
    var $items = $(this);
    for (var i = 0, count = $items.length; i < count; i++) {
        _build($items.eq(i), opts);
    }
    return $items;
}

defaults 是對外開放的三個參數;三個全域變數分別記錄目前索引、暫停狀態與定時器編號;_init 合併自訂參數後逐個建置。

五、建立各項操作

function _getSlides($node) {
    return $node.children('li');
}

function _build($node, opts) {
    var $slides = _getSlides($node);
    $slides.eq(0).siblings('li').css({ 'display': 'none' });

    var numpic = $slides.size() - 1;

    $node.delegate('li', 'mouseenter', function () {
        pause = true;
        clearInterval(autoMethod);
    }).delegate('li', 'mouseleave', function () {
        pause = false;
        autoMethod = setInterval(function () { _auto($slides, $pages, opts); }, opts.speed);
    });

    var $pages = _pagination($node, opts, numpic);

    if (opts.auto) {
        autoMethod = setInterval(function () { _auto($slides, $pages, opts); }, opts.speed);
    }
}

先隱藏除第一張以外的所有 li;把滑鼠移入與移出綁成暫停與恢復輪播;初始化分頁按鈕;最後依 auto 參數決定要不要啟動自動播放。

六、產生分頁按鈕

function _pagination($node, opts, size) {
    var $ul = $('<ul>', { 'class': opts.pageCss });

    for (var i = 0; i <= size; i++) {
        $ul.append('<li><a href="javascript:void(0)">' + (i + 1) + '</a></li>');
    }
    $ul.children(':first').addClass('current');

    var $pages = $ul.children('li');

    $ul.delegate('li', 'click', function () {
        _changePage($pages, $node, $(this).index());
    }).delegate('li', 'mouseenter', function () {
        pause = true;
    }).delegate('li', 'mouseleave', function () {
        pause = false;
    });

    $node.after($ul);
    return $pages;
}

七、切換的視覺處理

function _fadeinout($slides, $pages, next) {
    $slides.eq(nowImage).css('z-index', '2');
    $slides.eq(next).css({ 'z-index': '1' }).show();
    $pages.eq(next).addClass('current').siblings().removeClass('current');

    $slides.eq(nowImage).fadeOut(400, function () {
        $slides.eq(next).fadeIn(500);
    });
}

同時拉高兩張圖的 z-index,先讓下一張顯示出來,再讓舊圖淡出——這樣做出的是柔和的交疊漸變;若不處理層級,切換會非常生硬。

八、自動輪播

function _auto($slides, $pages, opts) {
    var next = nowImage + 1;
    var size = $slides.size() - 1;

    if (!pause) {
        if (nowImage >= size) { next = 0; }
        _fadeinout($slides, $pages, next);

        if (nowImage < size) { nowImage += 1; } else { nowImage = 0; }
    } else {
        clearInterval(autoMethod);
    }
}

還有哪些問題

這個版本仍有明顯限制:同一頁面無法同時初始化兩組不同設定的輪播,因為 nowImage、pause、autoMethod 都是閉包外的全域變數。要修正就得把狀態收進以每個元素為單位的資料物件裡,例如用 $node.data('jslide', {...}) 保存,並把 methods 改成 $.fn.jslide = function(method){...} 的 dispatch 形式。

另外 .size() 已在 jQuery 3 中移除,應改用 .length;.delegate() 也已廢棄,建議改寫成 $node.on('mouseenter', 'li', handler)。

整體走過一遍之後,最大的收穫是擁有了自己的輪播插件——雖然不完美,但知道每一行在做什麼,之後要加自動播放的進度條、手勢滑動、無限循環,都改得動。

Demo:https://demo.cnblogs.com/js/2014/jsilde/

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved