jQuery UI widgets appel de méthode

Widget (Widget) par les bibliothèques membres (Widget Factory) en utilisant la méthode de changer leur statut et effectuer des actions après l' initialisation est créé. Il existe deux façons d'appeler la méthode des widgets - par le biais de bibliothèques membres (Widget Factory) pour créer des plug-ins, ou par la méthode de l'instance d'élément d'un objet sur l'appel.

Plug-in appels

Widgets méthode plug-appel, le nom de la méthode comme une chaîne passée. Par exemple, cliquez ici pour voir, comment appeler dialogue (dialogue) un widget close() méthode .

$( ".selector" ).dialog( "close" );

Si la méthode nécessite des paramètres, transmis au plug-in comme un paramètre supplémentaire. Cliquez ici pour voir, comment appeler dialogue (dialogue) de l' option () méthode .

$( ".selector" ).dialog( "option", "height" );

Ceci renvoie la boîte de dialogue (dialogue) en height options valeurs.

Exemple d'appel

Chaque instance de chaque élément graphique utilise jQuery.data() est stockée dans l'élément. Afin de récupérer une instance d'un objet, utilisez le nom complet du widget pour appeler comme une clé jQuery.data() . A titre d'exemples spécifiques présentés ci-dessous.

var dialog = $( ".selector" ).data( "ui-dialog" );

Une fois que vous faites référence à une instance d'un objet, vous pouvez appeler la méthode directement au-dessus.

var dialog = $( ".selector" ).data( "ui-dialog" );
dialog.close();

Dans jQuery UI 1.11, la nouvelle instance() méthode rendre ce processus plus facile.

$( ".selector" ).dialog( "instance" ).close();

Type de retour

La plupart des méthodes appelées par le widget plug - in sera de retour un jQuery objet, donc les méthodes peuvent être invoquées par le biais supplémentaire jQuery méthodes lien. Lorsqu'elle est appelée sur l'instance, elle renvoie undefined . A titre d'exemples spécifiques présentés ci-dessous.

var dialog = $( ".selector" ).dialog();
 
// Instance invocation - returns undefined
dialog.data( "ui-dialog" ).close();
 
// Plugin invocation - returns a jQuery object
dialog.dialog( "close" );
 
// Therefore, plugin method invocation makes it possible to
// chain method calls with other jQuery functions
dialog.dialog( "close" )
    .css( "color", "red" );

Exceptionnellement, ces méthodes renvoient des informations sur le widget. Par exemple de dialogue (dialogue) de isOpen() méthode .

$( ".selector" )
    .dialog( "isOpen" )
    // This will throw a TypeError
    .css( "color", "red" );

Il en résulte une TypeError erreur car isOpen() retourne une valeur booléenne, et non pas un objet jQuery.