DIV CSS 佈局教程網

自己動手寫 jQuery 星級評分插件(含半星功能)
編輯:JQuery特效代碼     

先看運行結果:

互動很直覺:滑鼠移到某顆星上,它與它左邊的所有星會一起亮起來;點擊之後就記下這個星數並固定顯示。

一、原理:靠寬度裁切同一張精靈圖

這個插件完全不需要多張圖片,只用「寬度」變化製造明暗差異:

  • 最外層一個 ul,背景鋪的是灰色星星。它的寬度決定顯示幾顆星。例如單顆星寬 23px,要顯示 10 顆就把 ul 設為 230px。
  • 內部 n 個 li(n 為星數),寬度依序為 23px、46px……230px,背景鋪的是藍色星星。寬度越大的疊在上面,露出的藍星就越多。
  • 額外再放一個 li 記錄滑鼠點擊的結果或初始設定值。

這些標籤彼此重疊,透過切換 z-index 就能顯示不同的星數;點擊時把當前星數寫入那個記錄用的標籤,即完成選取值。

二、原始碼

$.fn.studyplay_star = function (options, callback) {
    // 預設設定
    var settings = {
        MaxStar: 20,        // 星星總數
        StarWidth: 23,      // 單顆星寬度(px)
        CurrentStar: 5,     // 初始星數
        Enabled: true       // false 表示只顯示評分結果,不可點擊
    };
    if (options) { jQuery.extend(settings, options); }

    var container = jQuery(this);
    container.css({ "position": "relative" })
        .html('<ul class="studyplay_starBg"></ul>')
        .find('.studyplay_starBg')
        .width(settings.MaxStar * settings.StarWidth)
        .html('<li class="studyplay_starovering" style="width:'
            + settings.CurrentStar * settings.StarWidth
            + 'px; z-index:0;" id="studyplay_current"></li>');

    if (settings.Enabled) {
        var ListArray = "";
        for (k = 1; k < settings.MaxStar + 1; k++) {
            // z-index 越大越上層,因此星數越多者疊得越高
            ListArray += '<li class="studyplay_starON" style="width:'
                + settings.StarWidth * k + 'px;z-index:'
                + (settings.MaxStar - k + 1) + ';"></li>';
        }

        container.find('.studyplay_starBg').append(ListArray)
            .find('.studyplay_starON')
            .hover(function () {
                $("#studyplay_current").hide();     // 移入時藏起記錄層
                $(this).removeClass('studyplay_starON')
                       .addClass("studyplay_starovering");
            }, function () {
                $(this).removeClass('studyplay_starovering')
                       .addClass("studyplay_starON");
                $("#studyplay_current").show();     // 移出時還原
            })
            .click(function () {
                var studyplay_count = settings.MaxStar - $(this).css("z-index") + 1;
                $("#studyplay_current").width(studyplay_count * settings.StarWidth);

                // 回呼函式
                if (typeof callback == 'function') { callback(studyplay_count); return; }
            });
    }
};

插件接受兩個參數:options 是基本設定,callback 是回呼函式,它唯一的參數代表使用者選中的星數。

三、使用範例

在 id 為 z 的元素上顯示 5 顆星、預設選中 2 顆,並在點擊後跳出星數:

<div id="z"></div>
<script type="text/javascript">
$(document).ready(function () {
    $("#z").studyplay_star({ MaxStar: 5, CurrentStar: 2 }, function (value) {
        alert(value);
    });
});
</script>

若只想單純展示評分結果,把 Enabled 設為 false 即可。

四、修正記錄

FireFox 顯示異常:網友回報在 FireFox 下樣式跑掉,追查後發現是 li 沒有明確定義高度,導致背景圖裁切失效。已在樣式中補上高度修正(star2.rar)。

新增半星功能:加上 Half 參數,0 表示整分遞增,1 表示以 0.5 分遞增。

$("#z").studyplay_star(
    { MaxStar: 12, CurrentStar: 2, Enabled: true, Half: 1 },
    function (value) { alert(value); }
);

原始碼與修正版打包(star2.rar、halfstar2.rar)請見原頁面。

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