jQuery UI widgets de llamada al método

Widget (Widget) por las bibliotecas miembro (Widget Factory) utilizando el método para cambiar su estado y realizar acciones después de que se creó la inicialización. Hay dos formas de llamar método de widgets - a través de las bibliotecas miembros (Widget Factory) para crear plug-ins, o por el método de la instancia de elemento de un objeto en la llamada.

Plug-in de llamadas

Reproductores método plug-llamada, el nombre del método como una cadena pasada. Por ejemplo, haga clic aquí para ver, cómo llamar diálogo (diálogo) widget de close() método .

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

Si el método requiere parámetros, se pasa al plug-in como un parámetro adicional. Haga clic aquí para ver, cómo llamar diálogo (diálogo) de la option() método .

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

Esto devuelve el diálogo (diálogo) en height opción de valores.

ejemplo de llamada

Cada instancia de cada widget está utilizando jQuery.data() se almacena en el elemento. Con el fin de recuperar una instancia de un objeto, utilice el nombre completo del widget para llamar como una clave jQuery.data() . Como ejemplos específicos se muestra a continuación.

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

Después se hace referencia a una instancia de un objeto, se puede llamar al método directamente encima.

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

En jQuery UI 1.11, la nueva instance() método hará que este proceso sea más fácil.

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

Tipo de retorno

La mayoría de los métodos llamados por el plugin Widget devolver un jQuery objeto, por lo que los métodos pueden ser invocados a través de jQuery adicional enlace de métodos. Cuando se invoca en la instancia, devuelve undefined . Como ejemplos específicos se muestra a continuación.

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

Excepcionalmente, estos métodos devuelven información sobre el widget. Por ejemplo de diálogo (diálogo) de isOpen() método .

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

Esto se traduce en un TypeError error porque isOpen() devuelve un valor booleano, no un objeto jQuery.