jQuery UI widgets de chamada de método

Widget (Widget) por bibliotecas membros (Widget Factory) usando o método para alterar o seu estatuto e realizar ações após a inicialização é criado. Há duas maneiras de chamar método de widgets - através de bibliotecas membros (Widget Factory) para criar plug-ins, ou pelo método da instância elemento de um objeto na chamada.

Plug-in chamadas

Widgets método plug-chamada, o nome do método como uma string passada. Por exemplo, clique aqui para ver, como chamar de diálogo (de diálogo) Widget close() método .

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

Se o método requer parâmetros, passado para o plug-in como um parâmetro adicional. Clique aqui para ver, como chamar de diálogo (de diálogo) da option() método .

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

Isso retorna o diálogo (de diálogo) na height de opção de valores.

exemplo Chamada

Cada exemplo de cada elemento está usando jQuery.data() é armazenado no elemento. A fim de recuperar uma instância de um objeto, use o nome completo do widget para chamar como uma chave jQuery.data() . Como exemplos específicos apresentados abaixo.

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

Depois de fazer referência a uma instância de um objeto, você pode chamar o método diretamente acima.

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

Em jQuery UI 1.11, a nova instance() método irá tornar esse processo mais fácil.

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

Tipo de retorno

A maioria dos métodos chamados pelo plugin widget irá retornar um jQuery objeto, de modo métodos podem ser chamados através do link adicional métodos jQuery. Quando chamado na instância, ele retorna undefined . Como exemplos específicos apresentados abaixo.

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, esses métodos retornam informações sobre o widget. Por exemplo de diálogo (de diálogo) do isOpen() método .

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

Isso resulta em um TypeError erro porque isOpen() retorna um valor booleano, não um objeto jQuery.