Button — jQuery Mobile

Виджет кнопкиверсия добавлена: 1.0

Описание: Создаёт виджет кнопки

Быстрый доступ

Параметры

Методы

События

Виджет кнопки jQuery UI включен в jQuery Mobile с некоторыми изменениями. Таким образом, его документация API полностью описывает его функциональность.

Параметры

углы

Тип: Булево

По умолчанию: true

Применяет радиус границ темы кнопки, если установлено в true.

Этот параметр также доступен как атрибут данных: data-corners="false".

Примечание: параметр button устарел в версии 1.5 и будет удалён в версии 1.6

Примеры кода:

Инициализировать кнопку с параметром corners:

$( ".selector" ).button({
  corners: false
});

Получить или установить параметр corners после инициализации:

// Getter
var corners = $( ".selector" ).button( "option", "corners" );
 
// Setter
$( ".selector" ).button( "option", "corners", false );

расширенный

Тип: Булево

По умолчанию: false

Указывает, что разметка, необходимая для виджета кнопки, была предоставлена в составе исходной разметки.

Этот параметр также доступен как атрибут данных: data-enhanced="true".

Примеры кода:

Инициализировать кнопку с параметром enhanced:

$( ".selector" ).button({
  enhanced: true
});

Получить или установить параметр enhanced после инициализации:

// Getter
var enhanced = $( ".selector" ).button( "option", "enhanced" );
 
// Setter
$( ".selector" ).button( "option", "enhanced", true );

иконка

Тип: Строка

По умолчанию: null

Применяет иконку из набора иконок.

Документация .buttonMarkup() содержит справочник всех доступных иконок в теме по умолчанию.

Этот параметр также доступен как атрибут данных: data-icon="star".

Примеры кода:

Инициализировать кнопку с параметром icon:

$( ".selector" ).button({
  icon: "star"
});

Получить или установить параметр icon после инициализации:

// Getter
var icon = $( ".selector" ).button( "option", "icon" );
 
// Setter
$( ".selector" ).button( "option", "icon", "star" );

позиция иконки

Тип: Строка

По умолчанию: "left"

Устанавливает позицию иконки на кнопке. Возможные значения: left, right, top, bottom, none, notext. Значение notext отобразит кнопку только с иконкой без текстовой информации.

Этот параметр также доступен как атрибут данных: data-iconpos="right".

Примечание: параметр button устарел в версии 1.5 и будет удалён в версии 1.6

initSelector

Тип: Селектор

По умолчанию: See below

Значение initSelector по умолчанию для виджета кнопки:

"input[type='button'], input[type='submit'], input[type='reset']"

Примечание: Этот параметр устарел в версии 1.4.0 и будет удалён в версии 1.5.0.
Начиная с jQuery Mobile 1.4.0, initSelector больше не является параметром виджета. Вместо этого он объявлен непосредственно в прототипе виджета. Таким образом, вы можете указать пользовательское значение, обработав событие mobileinit и перезаписав initSelector в прототипе:

$( document ).on( "mobileinit", function() {
  $.mobile.button.prototype.initSelector = "div.custom";
});

Примечание: Не забудьте подключить обработчик mobileinit после загрузки jQuery, но перед загрузкой jQuery Mobile, поскольку событие срабатывает в рамках процесса загрузки jQuery Mobile.

Значение этого параметра — строка селектора jQuery. Фреймворк выбирает элементы на основе значения этого параметра и инициализирует виджеты кнопок на каждом из полученного списка элементов.

(версия устарела: 1.4.0)

в одну строку

Тип: Булево

По умолчанию: null (false)

Если установлено true, это заставит кнопку работать как кнопку в одну строку, поэтому ширина определяется текстом кнопки. По умолчанию это null (false), поэтому кнопка имеет полную ширину независимо от содержимого. Возможные значения: true, false.

Этот параметр также доступен как атрибут данных: data-inline="true".

Примечание: параметр button устарел в версии 1.5 и будет удалён в версии 1.6

миниатюрный

Тип: Булево

По умолчанию: null (false)

Если установлено true, это отобразит более компактную версию кнопки, которая использует меньшую высоту, применяя класс ui-mini к самому внешнему элементу виджета кнопки.

Примечание: параметр mini устарел в версии 1.5 и будет удалён в версии 1.6

Этот параметр также доступен как атрибут данных: data-mini="true".

тень

Тип: Булево

По умолчанию: true

Применяет стиль тени к кнопке, если установлено в true.

Этот параметр также доступен как атрибут данных: data-shadow="false".

Примечание: параметр button устарел в версии 1.5 и будет удалён в версии 1.6

тема

Тип: Строка

По умолчанию: null, inherited from parent

Устанавливает цветовую схему (палитру) для виджета кнопки. Принимает одиночную букву от a до z, которая сопоставляется с палитрами, включёнными в вашу тему.

Возможные значения: буква палитры (a-z).

Этот параметр также доступен как атрибут данных: data-theme="b".

Примеры кода:

Инициализировать кнопку с параметром theme:

$( ".selector" ).button({
  theme: "b"
});

Получить или установить параметр theme после инициализации:

// Getter
var theme = $( ".selector" ).button( "option", "theme" );
 
// Setter
$( ".selector" ).button( "option", "theme", "b" );

класс обёртки

Тип: Строка

По умолчанию: null

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

Этот параметр также доступен как атрибут данных: data-wrapper-class="custom-class".

Примечание: параметр button устарел в версии 1.5 и будет удалён в версии 1.6