jQuery UI Как это работает
jQuery UI содержит множество виджетов с состоянием (Widget), поэтому он немного отличается от типичного шаблона использования плагинов jQuery. Его установка похожа на установку большинства плагинов jQuery. Виджеты jQuery UI основаны наWidget Factoryсозданы, а Widget Factory предоставляет общий API. Поэтому, как только вы научитесь использовать один из них, вы узнаете, как использовать другие виджеты. В этом руководстве будут использоватьсяprogressbarпримеры кода виджета, чтобы продемонстрировать общие возможности.
Установка
Чтобы отслеживать состояние виджета, сначала представим полный жизненный цикл виджета. Жизненный цикл начинается, когда виджет устанавливается. Чтобы установить виджет, нам нужно всего лишь вызвать плагин для одного или нескольких элементов.
$( "#elem" ).progressbar();
Это инициализирует каждый элемент в объекте jQuery. В этом примере id элемента — "elem". Поскольку мы вызываем не имеющий аргументов.progressbar()метод, виджет будет инициализирован в соответствии со своими опциями по умолчанию. Мы можем передать набор опций во время установки, чтобы переопределить опции по умолчанию.
$( "#elem" ).progressbar({ value: 20 });
Количество опций, передаваемых во время установки, может определяться нашими потребностями. Любые опции, которые мы не передаём, будут использовать свои значения по умолчанию.
Опции являются частью состояния виджета, поэтому мы также можем задавать опции после установки. Мы расскажем об этом вoptionразделе «Методы».
Методы
Теперь, когда виджет инициализирован, мы можем запросить его состояние или выполнить действия с ним. Все действия после инициализации выполняются в виде вызовов методов. Чтобы вызвать метод у виджета, мы можем передать имя метода в плагин jQuery. Например, чтобы вызвать у виджета progressbarvalueметод, следует использовать:
$( "#elem" ).progressbar( "value" );
Если метод принимает параметры, мы можем передать параметры после имени метода. Например, чтобы передать параметры для40даетvalueметода, можно использовать:
$( "#elem" ).progressbar( "value", 40 );
Как и другие методы в jQuery, большинство методов виджета возвращают объекты jQuery для создания цепочек вызовов.
$( "#elem" )
.progressbar( "value", 90 )
.addClass( "almost-done" );
Публичные методы
Каждый виджет имеет свой собственный набор методов, основанный на функциональности, которую предоставляет виджет. Однако некоторые методы являются общими для всех виджетов.
option
Как мы упоминали ранее, мы можем изменять опции после инициализации с помощьюoptionметода. Например, мы можем вызватьoptionметод, чтобы изменить значение progressbar на 30.
$( "#elem" ).progressbar( "option", "value", 30 );
Обратите внимание, что это отличается от предыдущего случая, когда мы вызывалиvalueметод. В этом случае мы вызываемoptionметод, изменяя опцию value на 30.
Мы также можем получить текущее значение опции.
$( "#elem" ).progressbar( "option", "value" );
Кроме того, мы можем передатьoptionметоду объект, чтобы обновить несколько опций сразу.
$( "#elem" ).progressbar( "option", {
value: 100,
disabled: true
});
Возможно, вы заметили, чтоoptionметод имеет ту же сигнатуру, что и геттер и сеттер в коде jQuery, так же как.css()и.attr(). Единственное отличие состоит в том, что вы должны передать строку "option" в качестве первого параметра.
disable
disableметод отключает виджет. В случае с progressbar это изменяет стиль, чтобы отображать индикатор выполнения как отключённый.
$( "#elem" ).progressbar( "disable" );
Вызовdisableметод эквивалентен установкеdisabledопцию вtrue。
enable
enableМетод являетсяdisableпротивоположность метода.
$( "#elem" ).progressbar( "enable" );
Вызовenableметод эквивалентен установкеdisabledопцию вfalse。
destroy
Если виджет больше не нужен, вы можете уничтожить его и вернуться к исходной разметке. Это означает конец жизненного цикла виджета.
$( "#elem" ).progressbar( "destroy" );
После уничтожения виджета вы не можете вызывать на нём никакие методы, если не инициализируете этот виджет заново. Если вы хотите удалить элемент, вы можете напрямую использовать.remove(), или вы можете использовать.html()или.empty()чтобы добиться этого, и виджет будет уничтожен автоматически.
widget
Некоторые виджеты создают элементы-обёртки или элементы, отсоединённые от исходного элемента. В приведённом ниже примере,widgetвернёт сгенерированный элемент. В случае с progressbar сгенерированной обёртки нет,widgetметод возвращает исходный элемент.
$( "#elem" ).progressbar( "widget" );
Events
Все виджеты имеют события, связанные с различными аспектами их поведения, используемые для уведомления вас при изменении состояния. Для большинства виджетов при срабатывании события его имя получает префикс с именем виджета. Например, мы можем привязать событие change у progressbar, которое срабатывает всякий раз при изменении значения.
$( "#elem" ).bind( "progressbarchange", function() {
alert( "The value has changed!" );
});
Каждое событие имеет соответствующий callback, представленный в виде опции. Мы можем использовать для progressbarchangecallback, который эквивалентен привязкеprogressbarchangeсобытие.
$( "#elem" ).progressbar({
change: function() {
alert( "The value has changed!" );
}
});
Публичные события
Большинство событий специфичны для конкретных виджетов; все виджеты имеют общееcreateсобытие. Это событие срабатывает при создании виджета.