jQuery UI-Widgets Methodenaufruf

Widget (Widget) von Mitgliedsbibliotheken (Widget Factory) unter Verwendung des Verfahrens , ihren Status zu ändern und Aktionen nach der Initialisierung erstellt wird. Es gibt zwei Möglichkeiten, Widgets Methode aufrufen - durch Mitgliedsbibliotheken (Widget Factory) Plug-Ins oder durch das Verfahren des Elements Instanz eines Objekts auf den Anruf zu erstellen.

Plug-in-Anrufe

Widgets Plug-Call-Methode, die Methodennamen als String übergeben. Zum Beispiel, klicken Sie hier , um zu sehen, wie aufruf Dialog (Dialog) Widget close() Methode .

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

Wenn die Verfahrensparameter erfordert, übergeben an das Plug-In als zusätzlicher Parameter. Klicken Sie hier , um zu sehen, wie aufruf Dialog (Dialog) der option() Methode .

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

Dies gibt den Dialog (Dialog) in height Option Werte.

Beispiel für einen Anruf

Jede Instanz jedes Widget verwendet jQuery.data() ist in dem Element gespeichert. Um eine Instanz eines Objekts abzurufen, verwenden Sie den vollständigen Namen des Widgets als Schlüssel zu nennen jQuery.data() . Als spezifische Beispiele weiter unten.

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

Nachdem Sie eine Instanz eines Objekts verweisen, können Sie die obige Methode direkt aufrufen.

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

In jQuery UI 1.11, die neue instance() wird Verfahren dieser Prozess zu erleichtern.

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

Rückgabetyp

Die meisten der durch das Widget Plugin namens Methoden wird eine Rückkehr jQuery - Objekt, so Methoden können durch zusätzliche jQuery Methoden Link aufgerufen werden. Wenn auf der Instanz aufgerufen wird , gibt es undefined . Als spezifische Beispiele weiter unten.

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" );

diese Methoden geben Informationen über das Widget Ausnahmsweise. Zum Beispiel Dialog (Dialog) von isOpen() Methode .

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

Daraus ergibt sich eine TypeError - Fehler , weil isOpen() einen Booleschen Wert zurückgibt, nicht ein jQuery - Objekt.