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

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