jQuery EasyUI Plugins
jQuery EasyUI fournit un ensemble complet de composants pour créer des pages web multi-navigateurs, notamment la puissante datagrid (grille de données), treegrid (tableau arborescent), panel, combo (combo déroulant), etc. Les utilisateurs peuvent utiliser ces composants en combinaison ou en utiliser un individuellement.
Liste des plugins
Base
Layout
Menu et bouton
Form
- Form
- Validatebox
- Combo
- Combobox
- Combotree
- Combogrid
- Numberbox
- Datebox
- Datetimebox
- Calendrier
- Spinner
- Numberspinner
- Timespinner
- Slider
Fenêtre
DataGrid et Tree
Plugins
Chaque composant easyui possède des propriétés, des méthodes et des événements. Les utilisateurs peuvent facilement étendre ces composants.
Propriétés
Les propriétés sont définies dans jQuery.fn.{plugin}.defaults. Par exemple, les propriétés de la boîte de dialogue sont définies dans jQuery.fn.dialog.defaults.
Événements
Les événements (fonctions de rappel) sont également définis dans jQuery.fn.{plugin}.defaults.
Méthodes
La syntaxe pour appeler une méthode : $('selector').plugin('method', parameter);
Où :
- selector est le sélecteur d'objet jQuery.
- plugin est le nom du plugin.
- method est une méthode existante qui correspond au plugin.
- parameter est l'objet paramètre, qui peut être un objet, une chaîne, ...
Les méthodes sont définies dans jQuery.fn.{plugin}.methods. Chaque méthode a deux paramètres : jq et param. Le premier paramètre 'jq' est requis et fait référence à l'objet jQuery. Le second paramètre 'param' fait référence aux paramètres réels passés à la méthode. Par exemple, pour étendre le composant dialog avec une méthode nommée 'mymove', le code est le suivant :
$.extend($.fn.dialog.methods, {
mymove: function(jq, newposition){
return jq.each(function(){
$(this).dialog('move', newposition);
});
}
});
Vous pouvez maintenant appeler la méthode 'mymove' pour déplacer la boîte de dialogue vers une position spécifiée :
$('#dd').dialog('mymove', {
left: 200,
top: 100
});
Premiers pas avec jQuery EasyUI
Téléchargez la bibliothèque et incluez les fichiers CSS et JavaScript EasyUI dans votre page.
<link rel="stylesheet" type="text/css" href="easyui/themes/default/easyui.css.html"> <link rel="stylesheet" type="text/css" href="easyui/themes/icon.css.html"> <script type="text/javascript" src="easyui/jquery-1.7.2.min.js.html"></script> <script type="text/javascript" src="easyui/jquery.easyui.min.js.html"></script>
Une fois que vous avez inclus les fichiers EasyUI nécessaires, vous pouvez définir un composant EasyUI via le balisage ou en utilisant JavaScript. Par exemple, pour définir un panneau avec une fonctionnalité repliable, vous devez écrire le code HTML suivant :
<div id="p" class="easyui-panel" style="width:500px;height:200px;padding:10px;"
title="My Panel" iconCls="icon-save" collapsible="true">
The panel content
</div>
Lors de la création de composants via le balisage, l'attribut 'data-options' est utilisé pour prendre en charge les noms d'attributs compatibles HTML5 depuis la version 1.3. Vous pouvez donc réécrire le code ci-dessus comme suit :
<div id="p" class="easyui-panel" style="width:500px;height:200px;padding:10px;"
title="My Panel" data-options="iconCls:'icon-save',collapsible:true">
The panel content
</div>
Le code suivant montre comment créer une combobox liée à l'événement 'onSelect'.
<input class="easyui-combobox" name="language"
data-options="
url:'combobox_data.json',
valueField:'id',
textField:'text',
panelHeight:'auto',
onSelect:function(record){
alert(record.text)
}">
Autres extensions