DIV CSS 佈局教程網

原生 JS 時間軸效果:依資料筆數自動均分時間點
編輯:關於JavaScript     

建議在 Chrome、Firefox、Opera、Safari 等標準瀏覽器中檢視;IE 下會缺少陰影與圓角效果。

功能描述

這個元件會依據來源資料(範例中是一組 JSON)的總筆數,自動把時間點均分分佈在時間軸上,並以平滑的向右動畫方式依序出現。滑鼠移到某個時間點時,顯示對應的日期與標題。

滑鼠移入事件的處理特別講究:當使用者快速、無意識地從時間點上劃過時,不會觸發對應事件,必須停留超過一段時間才算數。

核心程式碼

var JSONData = [{...}, {...}, ...];   // 資料源

function iTimePoint(iTimeSlideId, dateId, timeLineId, titleTop, titleId, defaultShow) {
    /* 參數說明:
     * iTimeSlideId: 外圍容器 ID(範例為 #itimeslide)
     * dateId      : 日期元素 ID(#date)
     * timeLineId  : 時間點分佈容器 ID(#timeline)
     * titleTop    : 標題上方小三角 ID(#titletop)
     * titleId     : 標題容器 ID(#title)
     * defaultShow : 初始顯示的時間點索引,預設 0,可不傳
     */
    if (arguments.length < 5 || arguments.length > 6) {
        alert('參數傳入錯誤,請傳入 5 或 6 個值!');
        return false;
    }

    // 通用工具
    var iBase = {
        Id: function (name) { return document.getElementById(name); },

        // 時間點平滑移動動畫
        PointSlide: function (elem, val) {
            // 可透過修改 i += 5 中的 5 來控制滑動速度
            for (var i = 0; i <= 100; i += 5) {
                (function () {
                    // 這個 pos 定義很重要,否則閉包取到的會是最後的 i
                    var pos = i;
                    setTimeout(function () {
                        elem.style.left = pos * val / 100 + 'px';
                    }, (pos + 1) * 10);
                })();
            }
        },

        AddClass: function (elem, val) {
            if (!elem.className) {
                elem.className = val;
            } else {
                elem.className = elem.className + ' ' + val;
            }
        },

        Index: function (cur, obj) {
            for (var i = 0; i < obj.length; i++) {
                if (obj[i] == cur) { return i; }
            }
        }
    };

依資料筆數產生時間點

    var dataLen       = JSONData.length;
    var iTimeSilde    = iBase.Id(iTimeSlideId);
    var date          = iBase.Id(dateId);
    var timeLine      = iBase.Id(timeLineId);
    var titletop      = iBase.Id(titleTop);
    var title         = iBase.Id(titleId);
    var iTimeSildeW   = iTimeSilde.offsetWidth;   // 幻燈區實際寬度
    var timePoint     = document.createElement('ul');
    var timePointLeftCur = null;   // 兩時間點間距
    var defaultShow   = defaultShow || 0;
    var clearFun      = null;      // 無意識劃過時中止執行
    var that          = null;

    for (var i = 0; i < dataLen; i++) {
        timePoint.innerHTML += '<li></li>';
    }
    timeLine.appendChild(timePoint);
    var timePoints = timeLine.getElementsByTagName('li');

定位與事件綁定

    for (var i = 0; i < timePoints.length; i++) {
        timePointLeftCur = parseInt(iTimeSildeW / (dataLen + 1));  // 均分間距
        var timePointLeft = (i + 1) * timePointLeftCur;

        iBase.PointSlide(timePoints[i], timePointLeft);   // 動畫進場

        setTimeout(function () { timePoints[defaultShow].onmouseover(); }, 1200);

        timePoints[i].oldClassName = timePoints[i].className;

        timePoints[i].onmouseover = function () {
            that = this;   // 確保 clearFun 中的 this 是當前元素
            // 停留超過 200ms 才執行,避免無意識劃過
            clearFun = setTimeout(function () {
                var pointIndex = iBase.Index(that, timePoints);

                for (var m = 0; m < timePoints.length; m++) {
                    if (m != pointIndex) {
                        timePoints[m].className = timePoints[m].oldClassName;
                    }
                }
                iBase.AddClass(that, 'hover');

                date.innerHTML = '<span>' + (JSONData[pointIndex]['date'] || '') + '</span><EM></EM>';
                title.innerHTML = '<a href="' + (JSONData[pointIndex]['href'] || '') + '">' +
                                  (JSONData[pointIndex]['title'] || '') + '</a>';

                date.style.left     = ((pointIndex + 1) * timePointLeftCur - 25) + 'px';
                titletop.style.left = ((pointIndex + 1) * timePointLeftCur + 6) + 'px';

                // 標題框超出右邊界時,改以右側為基準對齊
                if ((title.offsetWidth + (pointIndex + 1) * timePointLeftCur) < iTimeSildeW) {
                    title.style.left = ((pointIndex + 1) * timePointLeftCur - timePointLeftCur) + 'px';
                } else {
                    title.style.left = (iTimeSildeW - title.offsetWidth) + 'px';
                }

                date.style.display     = 'block';
                titletop.style.display = 'block';
                title.style.display    = 'block';
            }, 200);
        };

        timePoints[i].onmouseout = function () {
            clearTimeout(clearFun);   // 停留不足即中止
        };
    }
}

幾個值得注意的細節

  • IIFE 是必要的。PointSlide 裡若直接用迴圈變數 i,閉包會取到迴圈結束後的最終值,所有 setTimeout 都拿到同一個數,動畫就會爛掉。用立即執行函式包一層把當前值固定下來,是經典解法。
  • 間距公式 width / (dataLen + 1)。多留一格是為了讓首尾兩側都有邊距,時間點不會貼齊容器邊緣。
  • 200ms 的門檻值可調。這是用來判定「無意識劃過」的時間,可依實際使用情境調整。
  • modern 寫法:如今用 let 就不需要 IIFE 了,事件也可以用 addEventListener 取代直接指派 onmouseover,避免覆蓋他人綁定的處理器。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved