jQuery UI Aufruf von Widget-Methoden
Widgets werden durchdie Widget Factory erstellt,unter Verwendung von Methoden, um ihren Zustand nach der Initialisierung zu ändern und Aktionen auszuführen. Es gibt zwei Möglichkeiten, Widget-Methoden aufzurufen – über das von der Widget Factory erstellte Plugin oder durch Aufrufen von Methoden auf dem Instanzobjekt des Elements.
Plugin-Aufruf
Um Methoden über das Plugin des Widgets aufzurufen, übergeben Sie den Methodennamen als String. Klicken Sie zum Beispiel hier, um zu sehen, wie mandie Methode des Dialog-Widgets aufruftclose()method。
$( ".selector" ).dialog( "close" );
Wenn die Methode Parameter erfordert, übergeben Sie sie als zusätzliche Argumente an das Plugin. Klicken Sie hier, um zu sehen, wie mandie Methode des Dialogs aufruftoption()method。
$( ".selector" ).dialog( "option", "height" );
Dies gibtdie des Dialogs zurückheightOptionswert.
Instanzaufruf
Jede Instanz jedes Widgets istjQuery.data()auf dem Element gespeichert. Um das Instanzobjekt abzurufen, verwenden Sie den vollständigen Namen des Widgets als Schlüsselnamen zum Aufruf vonjQuery.data(). Wie im folgenden Beispiel gezeigt.
var dialog = $( ".selector" ).data( "ui-dialog" );
Nachdem Sie das Instanzobjekt referenziert haben, können Sie Methoden direkt darauf aufrufen.
var dialog = $( ".selector" ).data( "ui-dialog" ); dialog.close();
In jQuery UI 1.11, die neueinstance()Methode macht diesen Vorgang einfacher.
$( ".selector" ).dialog( "instance" ).close();
Rückgabetyp
Die meisten Methoden, die über das Plugin des Widgets aufgerufen werden, geben einjQueryObjekt zurück, sodass Methodenaufrufe mit zusätzlichen jQuery-Methoden verkettet werden können. Beim Aufruf auf einer Instanz wird es zurückgebenundefined. Wie im folgenden Beispiel gezeigt.
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" );
Die Ausnahme bilden diejenigen Methoden, die Informationen über das Widget zurückgeben. Zum Beispieldie des DialogsisOpen()method。
$( ".selector" )
.dialog( "isOpen" )
// This will throw a TypeError
.css( "color", "red" );
Dies erzeugt einenTypeErrorFehler, weilisOpen()sie einen booleschen Wert zurückgibt, kein jQuery-Objekt.