jQuery UI Llamadas a métodos de widgets (Widget)

Los widgets se crean mediantela fábrica de widgets (Widget Factory)y usan métodos para cambiar su estado después de la inicialización y realizar acciones. Hay dos formas de llamar a los métodos de un widget: mediante el plugin creado por la fábrica de widgets (Widget Factory), o llamando a los métodos del objeto de instancia del elemento.

Llamada de plugin

Para llamar a un método mediante el plugin del widget, pase el nombre del método como una cadena. Por ejemplo, haga clic aquí para ver cómo llamar almétodo del widget dialog (diálogo)close()método。

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

Si el método requiere parámetros, páselos como argumentos adicionales al plugin. Haga clic aquí para ver cómo llamar almétodo del dialog (diálogo)option()método。

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

Esto devuelvedel dialog (diálogo) el valor de laheightopción.

Llamada de instancia

Cada instancia de cada widget se almacena en el elemento mediantejQuery.data(). Para recuperar el objeto de instancia, use el nombre completo del widget como clave llamando ajQuery.data(). Como se muestra en el siguiente ejemplo.

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

Después de hacer referencia al objeto de instancia, puede llamar a los métodos directamente sobre él.

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

En jQuery UI 1.11, el nuevoinstance()método hace que este proceso sea más sencillo.

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

Tipo de retorno

La mayoría de los métodos llamados a través del plugin del widget devolverán un objetojQuery, por lo que las llamadas a métodos pueden encadenarse con métodos jQuery adicionales. Cuando se llama sobre una instancia, devolveráundefined. Como se muestra en el siguiente ejemplo.

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

La excepción son los métodos que devuelven información relacionada con el widget. Por ejemplo, el métododel dialog (diálogo)isOpen()método。

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

Esto producirá unTypeErrorerror, porqueisOpen()devuelve un valor booleano, no un objeto jQuery.

Otras extensiones