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.