jQuery UI Вызов методов виджета

Виджеты создаются черезфабрику виджетовс помощью методов для изменения их состояния после инициализации и выполнения действий. Существует два способа вызова методов виджета — через плагин, созданный фабрикой виджетов, или путём вызова методов у объекта экземпляра элемента.

Вызов через плагин

Чтобы вызвать методы с помощью плагина виджета, передайте имя метода в виде строки. Например, нажмите здесь, чтобы посмотреть, как вызватьвиджета dialogclose()method。

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

Если метод требует параметров, передайте их как дополнительные аргументы в плагин. Нажмите здесь, чтобы посмотреть, как вызватьдиалогаoption()method。

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

Это вернётдиалогаheightoptionvalue.

Вызов экземпляра

Каждый экземпляр каждого виджетаjQuery.data()хранится на элементе. Для объекта экземпляра используйте полное имя виджета в качестве имени ключа для вызоваjQuery.data(). Как показано в примере ниже.

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

После того как вы обратитесь к объекту экземпляра, вы можете вызывать методы напрямую на нём.

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

В jQuery UI 1.11 новыйinstance()метод делает этот процесс проще.

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

Тип возвращаемого значения

Большинство методов, вызываемых через плагин виджета, возвращаютjQueryобъект, поэтому вызовы методов можно объединять в цепочки с дополнительными методами jQuery. При вызове на экземпляре он вернётundefined. Как показано в примере ниже.

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

Исключением являются те методы, которые возвращают информацию о виджете. Напримеру диалогового окнаisOpen()method。

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

Это вызоветTypeErrorошибку, потому чтоisOpen()он возвращает логическое значение, а не объект jQuery.

Другие расширения