DIV CSS 佈局教程網

AjaxControlToolkit Rating 評分控制項完整用法
編輯:AJAX基礎知識     

AjaxControlToolkit 中的 Rating 控制項,是微軟 Ajax 控制項庫裡專門處理網頁評分、投票場景的成員。它自帶無刷新能力,因此完全不必再套一層 UpdatePanel,只要把 AutoPostBack 設為 False 即可。用法簡單,效果可自訂,還支援客戶端回調,做評論打分、商品好評度都很合適。

一、常用屬性速查

ID:伺服器端控制項標識,與其他控制項無異。

BehaviorID:在 Ajax 客戶端取得控制項對象時使用的 ID,設定回調函數時會透過 $Find 方法查找它。

MaxRating:最大評分,直接決定 UI 上「星形」圖標的個數。

CurrentRating:當前評分,也就是被點亮的星數,取值範圍必須落在 0 到 MaxRating 之間(含兩端)。

runat:宣告為伺服器端控制項,必填。

StarCssClass:星形圖標的樣式,必填。

WaitingStarCssClass:與伺服器交互、等待響應期間的星形樣式,必填。

FilledStarCssClass:星形被點亮時的樣式,必填。

EmptyStarCssClass:星形未點亮時的樣式,必填。

CssClass:整個 Rating 控制項的外層樣式,按需指定。

OnChanged:使用者點擊星形後觸發的服務端事件。

AutoPostBack:是否自動回傳,一般設為 False。

ReadOnly:唯讀狀態。唯讀時使用者無法點擊,也可以為唯讀態單獨配置樣式。

二、動手前的準備

1. 確認工程已正確引用 AjaxControlToolkit.dll。Visual Studio 2005 時代它是 beta 版,需要自行到微軟官網下載安裝;Visual Studio 2008 已隨 IDE 附帶,可直接使用。

2. VS2008 中 Rating 不會自動出現在工具箱,需要手動加入:打開工具箱浮動面板,選一個空白頁籤(如 General),右鍵選擇「選擇項…」,在對話框中找到對應控制項。

3. 若上述對話框裡找不到 AjaxControlToolkit 的項目,就要手動指定 dll 的路徑。

4. 加入完成後,Rating 就能像標準 ASP.NET 控制項一樣拖進頁面使用了。

三、頁面代碼

新建一個 Web 頁面。切記:所有 Ajax 控制項都依賴 ScriptManager 在客戶端註冊腳本,所以要先確保頁面上有且僅有一個 ScriptManager。

 <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="WebForm1.aspx.cs" Inherits="iFrameUpload.WebForm1" %> <%@ Register Assembly="AjaxControlToolkit, Version=3.0.20820.0, Culture=neutral, PublicKeyToken=28f01b0e84b6d53e" Namespace="AjaxControlToolkit" TagPrefix="ajaxToolkit" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="https://www.w3.org/1999/xhtml"> <head runat="server"> <title>Untitled Page</title> <link href="css/style.css" rel="stylesheet" type="text/css" /> </head> <body> <form id="form1" runat="server"> <div> <asp:ScriptManager ID="ScriptManager1" runat="server"> </asp:ScriptManager> <ajaxToolkit:Rating ID="RatingRate" BehaviorID="RatingRate1" MaxRating="5" CurrentRating="3" runat="server" StarCssClass="ratingStar" WaitingStarCssClass="waitingRatingStar" FilledStarCssClass="filledRatingStar" EmptyStarCssClass="emptyRatingStar" OnChanged="RatingRate_Changed" AutoPostBack="false"> </ajaxToolkit:Rating> <script type="text/javascript"> Sys.Application.add_load( function() { $find("RatingRate1").add_EndClientCallback( function(sender, e) { var result = e.get_CallbackResult(); alert(result); } ); } ); </script> </div> </form> </body> </html> 

腳本部分的含義:透過 Sys.Application.add_load 在頁面完全載入後,用 $find("RatingRate1").add_EndClientCallback 註冊一個回調,用來接收服務端傳回的數值。這些都是 Ajax 框架的標準做法,細節可查 MSDN。

四、後端事件處理

 protected void RatingRate_Changed(object sender, AjaxControlToolkit.RatingEventArgs e) { System.Threading.Thread.Sleep(300); //TODO: Save e.Value to database. e.CallbackResult = "success"; }

邏輯很輕:先讓線程停 300 毫秒,目的是讓我們有機會肉眼看到「等待中」的星形樣式;接著處理真正的業務,例如把分數寫入資料庫——使用者所選的分數從 e.Value 取得,型別是字串;最後透過 e.CallbackResult 把結果回傳客戶端做後續處理。

五、樣式與幾個實戰提醒

 .ratingStar { font-size: 0pt; width: 13px; height: 12px; margin: 0px; padding: 0px; cursor: pointer; display: block; background-repeat: no-repeat; } .waitingRatingStar /*normal mode empty style*/ { background-image: url(Rating_default.gif); } .filledRatingStar /*normal mode filled style*/ { background-image: url(Rating_normal.gif); } .emptyRatingStar /*readonly mode empty style*/ { background-image: url(Rating_empty.gif); } 

實測時要注意兩點。第一,當前值本身是不可點擊的:若初始化 CurrentRating 為 3,使用者再點第三顆星不會觸發事件。第二,Rating 允許被反覆點擊,如果業務上不希望使用者改分,就在服務端收到事件後把控制項設為唯讀。

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