jQuery UI Invocation des méthodes de widget
Les widgets sont créés viala Widget Factoryen utilisant des méthodes pour modifier leur état après l'initialisation et effectuer des actions. Il existe deux façons d'appeler les méthodes de widget : via le plugin créé par la Widget Factory, ou en appelant des méthodes sur l'objet d'instance de l'élément.
Invocation via le plugin
Pour appeler des méthodes à l'aide du plugin du widget, passez le nom de la méthode sous forme de chaîne. Par exemple, cliquez ici pour voir comment appelercelle du widget dialogclose()method。
$( ".selector" ).dialog( "close" );
Si la méthode nécessite des paramètres, passez-les comme arguments supplémentaires au plugin. Cliquez ici pour voir comment appelercelle du dialogoption()method。
$( ".selector" ).dialog( "option", "height" );
Cela renverracelle du dialogheightoptionvaleur.
Invocation d'instance
Chaque instance de chaque widget estjQuery.data()stockée sur l'élément. Pour récupérer l'objet d'instance, utilisez le nom complet du widget comme nom de clé pour appelerjQuery.data(). Comme montré dans l'exemple ci-dessous.
var dialog = $( ".selector" ).data( "ui-dialog" );
Après avoir référencé l'objet d'instance, vous pouvez appeler des méthodes directement sur celui-ci.
var dialog = $( ".selector" ).data( "ui-dialog" ); dialog.close();
Dans jQuery UI 1.11, la nouvelleinstance()méthode simplifie ce processus.
$( ".selector" ).dialog( "instance" ).close();
Type de retour
La plupart des méthodes appelées via le plugin du widget retournent unjQueryobjet, de sorte que les appels de méthode peuvent être chaînés avec d'autres méthodes jQuery. Lorsqu'on appelle sur une instance, il retourneraundefined. Comme montré dans l'exemple 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" );
L'exception concerne les méthodes qui renvoient des informations sur le widget. Par exempledu dialogueisOpen()method。
$( ".selector" )
.dialog( "isOpen" )
// This will throw a TypeError
.css( "color", "red" );
Cela produira uneTypeErrorerreur, carisOpen()il retourne une valeur booléenne, et non un objet jQuery.