產生星星(對應 1、3):用迴圈依星星數量動態組出 <a> 標籤,class 決定樣式、title 決定懸停提示,最後用 append 一次插入目標容器。
懸停效果(對應 2):靠 addClass/removeClass 切換樣式。特別注意:滑鼠移到第 N 顆星時,前面所有星都該亮起來,這可以用 prevAll() 取得目前位置之前的元素,再 add($(this)) 把當前這顆一起加進來。
計算分數與展示結果(對應 4):用 children().index($(this)) 取得被點星星的位置再加一,即為分數;透過 ajax 送出後,清空容器,改插入一個背景為星星圖、水平重複的 <span>,再用 animate 把它的寬度撐到「星星寬度 × 平均分」,就變成傳統的評分條。
三種狀態的實際外觀:
打分之前:
打分之中:
打分之後:
(function ($) {
$.fn.Rate = function (options) {
options = options || {};
var StarTip = options.StarTip || ['不值一看', '平平無奇', '信息靠譜', '對我很有幫助', '極品信息'];
var ItemAmount = options.ItemAmount || 5;
var UnRateClassName = options.UnRateClassName || 'star';
var RateClassName = options.RateClassName || 'star_on';
var originalStateClassName = options.originalStateClassName || 'OriginalState';
var PostURL = options.PostURL || '';
var DoAfterPost = options.DoAfterPost || function () { };
var userID = options.userID || '';
var messageID = options.messageID || '';
var content = $(this);
var starList = '';
for (var i = 0; i < ItemAmount; i++) {
starList += ['<a href="#" class="', UnRateClassName, '" title="', StarTip[i], '"></a>'].join('');
}
content.empty().append(starList).find('a')
.hover(function () {
$(this).prevAll().add($(this)).addClass(RateClassName);
}, function () {
$(this).prevAll().add($(this)).removeClass(RateClassName);
})
.one('click', function () {
var score = parseInt(content.children().index($(this))) + 1;
$.ajax({
type: "POST",
url: PostURL,
data: "{messageID:" + messageID + ",userID:" + userID + ",Score:" + score + "}",
contentType: "application/json; charset=utf-8",
dataType: "json",
success: function (msg) {
var result = (jQuery.parseJSON(msg.d)).SuccessFlag;
DoAfterPost(result);
content.empty().removeClass();
$('<span></span>').addClass(originalStateClassName)
.prependTo(content)
.animate({ 'width': 16 * result + 'px', 'opacity': 1 }, 'slow');
}
});
});
};
})(jQuery);
這裡用 .one('click') 而非 .click(),綁定一次後自動解除,是防止重複投票最簡潔的寫法。
| 參數名稱 | 描述 | 預設值 | 型別 |
|---|---|---|---|
| StarTip | 滑鼠移到星星上的文字提示 | ['不值一看','平平無奇','信息靠譜','對我很有幫助','極品信息'] | 陣列,元素個數須與星星數一致 |
| ItemAmount | 星星數量 | 5 | 數字 |
| UnRateClassName | 未投票時星星樣式 | star | 字串 |
| RateClassName | 投票中(懸停)星星樣式 | star_on | 字串 |
| originalStateClassName | 結果展示時的樣式 | OriginalState | 字串 |
| PostURL | ajax 互動的網址 | '' | 字串 |
| DoAfterPost | 投票後於頁面執行的自訂方法 | 空函數 | 函數 |
| userID | 使用者 ID,用於防止重複投票 | '' | 數字 |
| messageID | 文章 ID | '' | 數字 |
$('#left table tr:eq(1) td:eq(0) #StarRate').Rate({
PostURL: 'https://www.cnblogs.com/ServiceProvider/MessageInfoService.asmx/VoteMessage',
userID: UserID,
messageID: messageID,
DoAfterPost: function (data) {
if (data > 0) {
$(voteResultContext).html(data);
} else {
ProcessNoticeShow('您已經投過票了');
}
}
});
.star{
height:16px; width:16px; float:left;
background:url(../images/star.gif) no-repeat 0 0;
}
.star_on{
background:url(../images/star.gif) no-repeat 0 -32px !important;
}
.OriginalState{
width:0px;
background:url(../images/star.gif) repeat-x 0 -16px !important;
opacity:0; height:16px; display:block;
}
同一張 star.gif 透過 background-position 切出三種狀態:上方是空心星、中間是實心星、下方則是可水平重複的漸層帶——這正是結果動畫要用的那條。
/// <summary>
/// 對資訊進行投票,回傳值大於 0 代表成功
/// </summary>
[WebMethod]
public string VoteMessage(int messageID, int userID, int Score)
{
SQLCMD = new SqlCommand("MessageInfo_Add_VoteUsefull_MessageIDUserID", SQLConnect);
SQLCMD.CommandType = CommandType.StoredProcedure;
SQLCMD.Parameters.Add(new SqlParameter("@messageID", SqlDbType.Int));
SQLCMD.Parameters["@messageID"].Value = messageID;
SQLCMD.Parameters.Add(new SqlParameter("@userID", SqlDbType.Int));
SQLCMD.Parameters["@userID"].Value = userID;
SQLCMD.Parameters.Add(new SqlParameter("@Score", SqlDbType.Int));
SQLCMD.Parameters["@Score"].Value = Score;
float SuccessFlag = basicSQLAccess.ExeScalarReturnValueFloat(SQLCMD);
Hashtable HTFlag = new Hashtable();
HTFlag.Add("SuccessFlag", SuccessFlag);
return JsonConvert.SerializeObject(HTFlag);
}
整個方案的關鍵在「用 background-position 一張圖搞定三態」與「用 span 寬度動畫呈現平均分」這兩個技巧,讓視覺與邏輯都相當輕巧。防守重複投票則是雙保險:前端用 one() 只綁一次,後端用 userID + messageID 的 stored procedure 判斷是否已投過,回傳 0 讓前端提示。
要留意的是,前端攔截终究只是體驗層面,真正的防重複必須在資料庫端以唯一約束或交易來保證。另外範例中的 ajax data 是字串拼接,實務上建議改用物件並交由 jQuery 序列化,可以避免資料中包含引號時把 JSON 弄壞。