jQuery Raty星級評分插件使用方法實例分析

更新時間：2019年11月25日 11:38:30 作者：在線瘋狂

這篇文章主要介紹了jQuery Raty星級評分插件使用方法,結(jié)合實例形式分析了jquery Raty星級評分插件的下載、調(diào)用、基本屬性及相關(guān)使用技巧,需要的朋友可以參考下

本文實例講述了jQuery Raty星級評分插件使用方法。分享給大家供大家參考，具體如下：

使用jQuery Raty，可以很方便的在頁面上嵌入一個評分組件，如下所示：

使用方法很簡單，首先從https://github.com/wbotelhos/raty下載raty的源代碼（依賴于jquery）

然后在頁面中引入相應(yīng)的js文件、css文件、圖片資源，在需要添加評分組件的元素上（比如span標簽）添加下面的jquery代碼即可：

$('span').raty();

以上為jQuery Raty的缺省使用方法，此外，該組件還支持豐富的傳入?yún)?shù)和回調(diào)函數(shù)，例如：

設(shè)置jQuery Raty的初始評分：

評分回調(diào)函數(shù)

如果需要根據(jù)后臺動態(tài)設(shè)置初始評分，可以使用回調(diào)函數(shù)實現(xiàn)。例如使用div中的data-attribute屬性：

<div data-score="1"></div>

$('div').raty({
 score: function() {
  return $(this).attr('data-score');
 }
});

還可以改變星星的個數(shù)：

$('div').raty({ number: 10 });

只讀模式：

$('div').raty({ readOnly: true, score: 3 });

點擊事件：

$('div').raty({
 click: function(score, evt) {
  alert('ID: ' + this.id + "\nscore: " + score + "\nevent: " + evt);
 }
});

路徑：

變更圖標保存的位置，所有圖標需要位于同一目錄下，路徑結(jié)尾的/不添加也可以

<div data-path="assets/images"></div>

$('div').raty({
 path: function() {
  return this.getAttribute('data-path');
 }
});

取消評分：

$('div').raty({ cancel: true });

全局改變設(shè)置：

你可以全局更改上述提到的所有設(shè)置 $.fn.raty.defaults.OPTION = VALUE;. 該語句必須添加在插件綁定之前。

$.fn.raty.defaults.path = assets;
$.fn.raty.defaults.cancel = true;

參數(shù)列表：

cancel : false // Creates a cancel button to cancel the rating.
cancelClass : 'raty-cancel' // Name of cancel's class.
cancelHint : 'Cancel this rating!' // The cancel's button hint.
cancelOff : 'cancel-off.png' // Icon used on active cancel.
cancelOn : 'cancel-on.png' // Icon used inactive cancel.
cancelPlace : 'left' // Cancel's button position.
click : undefined // Callback executed on rating click.
half : false // Enables half star selection.
halfShow : true // Enables half star display.
hints : ['bad', 'poor', 'regular', 'good', 'gorgeous'] // Hints used on each star.
iconRange : undefined // Object list with position and icon on and off to do a mixed icons.
mouseout : undefined // Callback executed on mouseout.
mouseover : undefined // Callback executed on mouseover.
noRatedMsg : 'Not rated yet!' // Hint for no rated elements when it's readOnly.
number : 5 // Number of stars that will be presented.
numberMax : 20 // Max of star the option number can creates.
path : undefined // A global locate where the icon will be looked.
precision : false // Enables the selection of a precision score.
readOnly : false // Turns the rating read-only.
round : { down: .25, full: .6, up: .76 } // Included values attributes to do the score round math.
score : undefined // Initial rating.
scoreName : 'score' // Name of the hidden field that holds the score value.
single : false // Enables just a single star selection.
space : true // Puts space between the icons.
starHalf : 'star-half.png' // The name of the half star image.
starOff : 'star-off.png' // Name of the star image off.
starOn : 'star-on.png' // Name of the star image on.
target : undefined // Element selector where the score will be displayed.
targetFormat: '{score}' // Template to interpolate the score in.
targetKeep : false // If the last rating value will be keeped after mouseout.
targetScore : undefined // Element selector where the score will be filled, instead of creating a new hidden field (scoreName option).
targetText : '' // Default text setted on target.
targetType : 'hint' // Option to choose if target will receive hint o 'score' type.
starType : 'img' // Element used to represent a star.

回調(diào)函數(shù)列表：

$('div').raty('score');         // Get the current score.
$('div').raty('score', number);     // Set the score.
$('div').raty('click', number);     // Click on some star.
$('div').raty('readOnly', boolean);   // Change the read-only state.
$('div').raty('cancel', boolean);    // Cancel the rating. The last param force the click callback.
$('div').raty('reload');         // Reload the rating with the current configuration.
$('div').raty('set', { option: value }); // Reset the rating with new configurations.
$('div').raty('destroy');        // Destroy the bind and give you the raw element.
$('div').raty('move', number);      // Move the mouse to the given score point position.

更多關(guān)于jQuery相關(guān)內(nèi)容感興趣的讀者可查看本站專題：《jQuery擴展技巧總結(jié)》、《jQuery常用插件及用法總結(jié)》、《jQuery切換特效與技巧總結(jié)》、《jQuery遍歷算法與技巧總結(jié)》、《jQuery常見經(jīng)典特效匯總》、《jQuery動畫與特效用法總結(jié)》及《jquery選擇器用法總結(jié)》

希望本文所述對大家jQuery程序設(shè)計有所幫助。

您可能感興趣的文章: