jQuery UI Pourquoi utiliser la fabrique de widgets
Écrire un plugin jQuery est aussi simple que d'ajouter une méthode àjQuery.prototype(généralement représenté par$.fn) ajouter une méthode est tout aussi simplethis. Alors pourquoi la fabrique de widgets existe-t-elle ?
Dans ce chapitre, nous expliquerons les avantages de la fabrique de widgets et apprendrons quand et pourquoi l'utiliser.
Plugins sans état vs. plugins avec état
La plupart des plugins jQuery sont sans état ; ils effectuent une action et cela termine leur tâche. Par exemple, si vous utilisez.text( "hello" )pour définir le texte d'un élément, il n'y a pas de phase d'installation, et le résultat est toujours le même. Pour ce type de plugin, il étend simplement le prototype de jQuery.
Cependant, certains plugins sont avec état ; ils ont un cycle de vie complet, maintiennent un état et réagissent aux changements. Ces plugins nécessitent une quantité importante de code spécialisé pour l'initialisation et la gestion de l'état (et parfois la destruction). Cela a conduit à des modèles pour créer des plugins avec état. Pire, chaque auteur de plugin gère le cycle de vie et l'état du plugin différemment, ce qui conduit à différents styles d'API selon les plugins. La fabrique de widgets vise à résoudre ces problèmes en supprimant le modèle et en créant une API cohérente pour les plugins.
API cohérente
La Widget Factory définit comment créer et détruire des widgets, obtenir et définir des options, appeler des méthodes et écouter les événements déclenchés par les widgets. En utilisant la Widget Factory pour créer des plugins avec état, vous vous conformez automatiquement aux normes définies, ce qui facilite l'utilisation de votre plugin par de nouveaux utilisateurs. De plus, la Widget Factory peut également implémenter des interfaces définies. Si vous n'êtes pas familier avec l'API fournie par la Widget Factory, veuillez consulterComment utiliser la Widget Factory。
Définition des options à l'initialisation
Lorsque vous créez un plugin qui accepte des options, vous devez définir des valeurs par défaut pour autant d'options que possible. Ensuite, à l'initialisation, fusionnez les options fournies par l'utilisateur avec les valeurs par défaut. Vous pouvez également exposer les valeurs par défaut afin que les utilisateurs puissent modifier les valeurs par défaut. Un modèle courant dans les plugins jQuery est le suivant :
$.fn.plugin = function( options ) {
options = $.extend( {}, $.fn.plugin.defaults, options );
// Plugin logic goes here.
};
$.fn.plugin.defaults = {
param1: "foo",
param2: "bar",
param3: "baz"
};
La Widget Factory fournit également cette fonctionnalité et l'améliore. Après avoir utilisé la Widget Factory, cela ressemblerait à ceci :
$.widget( "ns.plugin", {
// Default options.
options: {
param1: "foo",
param2: "bar",
param3: "baz"
},
_create: function() {
// Options are already merged and stored in this.options
// Plugin logic goes here.
}
});
Autres extensions