jQuery Mobile Атрибуты данных


Атрибуты данных jQuery

Использование jQuery Mobileатрибутов HTML5 data-*для создания более удобного для сенсорного управления и привлекательного внешнего вида на мобильных устройствах.

В приведенном ниже справочном спискезначения, выделенные жирным шрифтом,являются значениями по умолчанию.


Кнопки

Устарело после версии 1.4. ИспользуйтеCSS-классывместо этого.Гиперссылки сdata-role="button"`data-role="button"`. Элементы button, ссылки на панелях инструментов и поля ввода автоматически отображаются как кнопки без необходимости добавлять `data-role="button"`.

Атрибуты данных Значение Описание
data-corners true | false Указывает, имеет ли кнопка закруглённые углы
data-icon Справочник по значкам Задает значок для кнопки. По умолчанию значок отсутствует.
data-iconpos left | right | top | bottom | notext Задает положение значка
data-iconshadow true | false Указывает, есть ли у значка кнопки тень
data-inline true | false Указывает, является ли кнопка встроенной
data-mini true | false Указывает, является ли кнопка маленькой или обычного размера
data-shadow true | false Указывает, есть ли у кнопки тень
data-theme Буквы (a-z) Задает цвет темы кнопки

lamp Чтобы объединить несколько кнопок, используйте контейнер с `data-role="controlgroup"` и `data-type="horizontal|vertical"`, чтобы указать, следует ли группировать кнопки горизонтально или вертикально.


Флажки

сtype="checkbox"парами label и input. Они автоматически отображаются как кнопки; data-role не требуется.

Атрибуты данных Значение Описание
data-mini true | false Указывает, будет ли флажок маленького или обычного размера
data-role none Не позволяет jQuery Mobile отображать флажок как кнопку
data-theme Буквы (a-z) Задает цвет темы флажка

lamp Чтобы объединить несколько флажков, используйте контейнер с `data-role="controlgroup"` и `data-type="horizontal|vertical"`, чтобы указать, следует ли группировать флажки горизонтально или вертикально.


Сворачиваемые блоки

В контейнере сdata-role="collapsible"`data-role="collapsible"`, элемент заголовка, за которым следует любая HTML-разметка.

Атрибуты данных Значение Описание
data-collapsed true | false Указывает, свернуто содержимое или развернуто
data-collapsed-icon Справочник по значкам Задает значок для кнопки сворачиваемого блока. По умолчанию "plus".
data-content-theme Буквы (a-z) Задает цвет темы содержимого сворачиваемого блока. Определяет, добавлять ли скругленные углы к содержимому сворачиваемого блока.
data-expanded-icon Справочник по значкам Задает значок для кнопки сворачиваемого блока, когда содержимое развернуто. По умолчанию "minus".
data-iconpos left | right | top | bottom Задает положение значка
data-inset true | false Указывает, отображается ли кнопка сворачиваемого блока со скругленными углами и отступами
data-mini true | false Указывает, будет ли кнопка сворачиваемого блока маленького или обычного размера
data-theme Буквы (a-z) Задает цвет темы для кнопки сворачиваемого блока


Наборы сворачиваемых блоков

В контейнере сdata-role="collapsible-set"`data-role="collapsible-set"`, сворачиваемые блоки содержимого.

Атрибуты данных Значение Описание
data-collapsed-icon Справочник по значкам Задает значок для кнопки сворачиваемого блока. По умолчанию "plus".
data-content-theme Буквы (a-z) Задает цвет темы для кнопки сворачиваемого блока
data-expanded-icon Справочник по значкам Задает значок для кнопки сворачиваемого блока, когда содержимое развернуто. По умолчанию "minus".
data-iconpos left | right | top | bottom | notext Задает положение значка
data-inset true | false Определяет, отображаются ли сворачиваемые блоки со скруглёнными углами и внешними отступами
data-mini true | false Указывает, будет ли кнопка сворачиваемого блока маленького или обычного размера
data-theme Буквы (a-z) Определяет цвет темы набора сворачиваемых блоков


Содержание

Устарело в версии 1.4, больше не поддерживается после версии 1.5.Используйтеdata-role="content"контейнер с `data-role="content"`.

Атрибуты данных Значение Описание
data-theme Буквы (a-z) Определяет цвет темы содержимого.


Группы элементов управления

сdata-role="controlgroup"`data-role="controlgroup"` контейнером `<div>` или `<fieldset>`. Группирует несколько элементов ввода одного типа, оформленных как кнопки (кнопки на основе ссылок, радиокнопки, флажки, элементы select). Для группировки флажков и радиокнопок формы рекомендуется использовать контейнер `<fieldset>` внутри `<div>` с `data-role="fieldcontain"`, чтобы улучшить оформление меток.

Атрибуты данных Значение Описание
data-mini true | false Определяет, имеет ли группа элементов управления маленький или обычный размер
data-type horizontal | vertical Определяет, отображается ли группа элементов управления горизонтально или вертикально


Диалоговые окна

сdata-role="dialog"`data-role="dialog"` контейнером, или сdata-rel="dialog"`data-rel="dialog"` ссылкой.

Атрибуты данных Значение Описание
data-close-btn-text некоторый текст Задает текст для кнопки закрытия диалогового окна
data-dom-cache true | false Задает, следует ли очищать кэш DOM jQuery для отдельных страниц (если задано значение true, вы должны самостоятельно управлять DOM и тестировать на всех мобильных устройствах)
data-overlay-theme Буквы (a-z) Задает цвет маски (фона) страницы диалогового окна
data-theme Буквы (a-z) Задает цвет темы страницы диалогового окна
data-title некоторый текст Задает заголовок страницы диалогового окна


Улучшение

сdata-enhance="false"илиdata-ajax="false"`data-enhance="false"` контейнером.

Атрибуты данных Значение Описание
data-enhance true | false Если задано значение "true" (по умолчанию), jQuery Mobile автоматически улучшит страницу, чтобы сделать ее более подходящей для мобильных устройств. Если задано значение "false", фреймворк не будет улучшать страницу.
data-ajax true | false Указывает, загружается ли страница через AJAX

Примечание:`data-enhance="false"` должен использоваться вместе с `$.mobile.ignoreContentEnabled=true`, чтобы предотвратить автоматическое улучшение страницы jQuery Mobile.

Когда `$.mobile.ignoreContentEnabled` установлен в true, любые ссылки или элементы формы внутри контейнера `data-ajax="false"` будут игнорироваться функциональностью навигации фреймворка.


Контейнеры полей

Устарело после версии 1.4, больше не поддерживается после версии 1.5. Используйте `class="ui-fieldcontain"` вместо этого.Оборачивает пары элементов label/form, сdata-role="fieldcontain"`data-role="fieldcontain"` контейнер.


Фиксированные панели инструментов

сdata-role="header"илиdata-role="footer", и сdata-position="fixed"`data-position="fixed"` контейнер атрибута.

Атрибуты данных Значение Описание
data-disable-page-zoom true | false Указывает, может ли пользователь масштабировать страницу
data-fullscreen true | false Указывает, всегда ли панель инструментов зафиксирована вверху или внизу
data-tap-toggle true | false Указывает, может ли пользователь переключать видимость панели инструментов щелчком
data-transition slide | fade | none Указывает эффект переключения при щелчке
data-update-page-padding true | false Указывает, обновляются ли верхний и нижний отступы страницы при изменении размера, переходе и событиях "updatelayout" (jQuery Mobile всегда обновляет отступы при событии "pageshow")
data-visible-on-page-show true | false Указывает видимость панели инструментов, когда отображается родительская страница


Перекидные переключатели

Один сdata-role="slider": элемент `<select>` и два элемента `<option>`.

Атрибуты данных Значение Описание
data-mini true | false Указывает, является ли переключатель маленьким или обычного размера
data-role none Запрещает jQuery Mobile отображать переключатель как кнопку
data-theme Буквы (a-z) Задает цвет темы переключателя
data-track-theme Буквы (a-z) Задает цвет темы дорожки


Нижняя панель

сdata-role="footer"контейнером.

Атрибут данных Значение Описание
data-id некоторый текст Задает уникальный ID. Обязателен для постоянных нижних колонтитулов.
data-position inline | fixed Указывает, встроен ли нижний колонтитул в содержимое страницы или остается фиксированным внизу.
data-fullscreen true | false Указывает, фиксируется ли нижний колонтитул внизу или накладывается поверх содержимого страницы (для увеличения области просмотра).
data-theme Буква (a-z) Указывает цвет темы нижнего колонтитула. По умолчанию "a".

Примечание:Чтобы включить полноэкранное позиционирование, используйте data-position="fixed", а затем добавьте атрибут data-fullscreen к элементу.


Панель заголовка

сdata-role="header"контейнером.

Атрибут данных Значение Описание
data-id некоторый текст Указывает уникальный идентификатор. Требуется для постоянных заголовков.
data-position inline | fixed Указывает, встроен ли заголовок в содержимое страницы или остается фиксированным вверху.
data-fullscreen true | false Указывает, фиксируется ли заголовок вверху или накладывается поверх содержимого страницы (для увеличения области просмотра).
data-theme Буква (a-z) Указывает цвет темы заголовка. По умолчанию "a".

Примечание:Чтобы включить полноэкранное позиционирование, используйте data-position="fixed", а затем добавьте атрибут data-fullscreen к элементу.


Ссылки

Все ссылки, включая ссылки с data-role="button", и кнопки отправки форм.

Атрибут данных Значение Описание
data-ajax true | false Указывает, загружать ли страницы через ajax для улучшения пользовательского опыта и взаимодействия. Если установлено значение false, jQuery Mobile выполнит обычный запрос страницы.
data-direction reverse Обратная анимация перехода (только для страниц и диалоговых окон)
data-dom-cache true | false Определяет, очищать ли кэш DOM jQuery для каждой страницы (если установлено true, вы должны сами управлять DOM и тестировать на всех мобильных устройствах).
data-prefetch true | false Определяет, предварительно ли загружать страницы в DOM, чтобы они были доступны, когда пользователь их посещает.
data-rel back | dialog | external | popup Задает параметры поведения ссылки. Back — возвращает на предыдущую страницу в истории. Dialog — открывает ссылку как диалоговое окно, не сохраняется в истории. External — используется для ссылки на другой домен. Popup — открывает всплывающее окно.
data-transition fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none Задает эффект при переходе с одной страницы на следующую. Ознакомьтесь с нашим разделомПереходы страниц jQuery Mobile.
data-position-to origin | jQuery selector | window Задает положение всплывающего окна. Origin — по умолчанию. Размещает всплывающее окно на ссылке, которая его открывает. jQuery selector — размещает всплывающее окно на указанном элементе. Window — размещает всплывающее окно в центре экрана.


Списки

сdata-role="listview"для <ol> или <ul>.

Атрибут данных Значение Описание
data-autodividers true | false Указывает, следует ли автоматически разделять элементы списка.
data-count-theme Буква (a-z) Задает цвет темы пузырька с количеством.
data-divider-theme Буква (a-z) Задает цвет темы разделителей списка.
data-filter true | false Указывает, добавлять ли поле поиска в список.
data-filter-placeholder некоторый текст Устарело после версии 1.4. Вместо этого используйте HTML-атрибут placeholder.Задает текст внутри поля поиска. По умолчанию — "Filter items..."
data-filter-theme Буква (a-z) Задает цвет темы фильтра поиска.
data-icon Справочник иконок Задает иконку списка.
data-inset true | false Задает, отображается ли список со скругленными углами и отступами.
data-split-icon Справочник иконок Задает иконку кнопки разделения. По умолчанию — "arrow-r".
data-split-theme Буква (a-z) Задает цвет темы кнопки разделения.
data-theme Буква (a-z) Задает цвет темы списка.


Элементы списка

с атрибутомdata-role="listview"элемент <li> внутри <ol> или <ul>.

Атрибут данных Значение Описание
data-filtertext некоторый текст Задает текст для поиска при фильтрации элементов. Этот текст будет фильтроваться вместо фактического текста элемента списка.
data-icon Справочник иконок Задает значок элемента списка.
data-role list-divider Задает разделитель элемента списка.
data-theme Буква (a-z) Задает цвет темы элемента списка.

Примечание:Атрибут data-icon работает только для элементов списка со ссылками.


Панели навигации

сdata-role="navbar"элементы <li> внутри контейнера.

Атрибут данных Значение Описание
data-icon Справочник иконок Задает значок для элемента списка.
data-iconpos left | right | top | bottom | notext Задает положение значка.

lamp Панели навигации наследуют образец темы от родительского контейнера. Невозможно установить атрибут data-theme для панели навигации. Вы можете установить атрибут data-theme отдельно для каждой ссылки в панели навигации.


Страницы

контейнер сdata-role="page".

Атрибут данных Значение Описание
data-add-back-btn true | false Автоматически добавлять кнопку возврата, только в панелях заголовка.
data-back-btn-text некоторый текст Задает текст для кнопки возврата.
data-back-btn-theme Буква (a-z) Задает цвет темы кнопки возврата.
data-close-btn-text Буква (a-z) Задает текст для кнопки закрытия в диалогах.
data-dom-cache true | false Определяет, очищать ли кэш DOM jQuery для каждой страницы (если установлено true, вы должны сами управлять DOM и тестировать на всех мобильных устройствах).
data-overlay-theme Буква (a-z) Задает цвет оверлея (фона) страницы диалога.
data-theme Буква (a-z) Задает цвет темы страницы.
data-title некоторый текст Задает заголовок страницы.
data-url url Обновляет значение URL, а не URL, используемый для запроса страницы.


Всплывающие окна

сdata-role="popup"контейнером.

Атрибут данных Значение Описание
data-corners true | false Указывает, имеет ли всплывающее окно закругленные углы.
data-overlay-theme Буква (a-z) Задает цвет оверлея (фона) всплывающего окна. По умолчанию — прозрачный фон (none).
data-shadow true | false Указывает, есть ли у всплывающего окна тень.
data-theme Буква (a-z) Задает цвет темы всплывающего окна. По умолчанию наследуется, "none" делает всплывающее окно прозрачным.
data-tolerance 30, 15, 30, 15 Задает расстояние от краев окна (сверху, справа, снизу, слева).

сdata-rel="popup"якорем:

Атрибут данных Значение Описание
data-position-to origin | jQuery selector | window >Задает положение всплывающего окна. Origin — по умолчанию. Позиционирует всплывающее окно на ссылке, которая его открывает. Селектор jQuery — позиционирует всплывающее окно на указанном элементе. Window — позиционирует всплывающее окно в центре экрана окна.
data-rel всплывающее окно Используется для открытия всплывающего окна.
data-transition fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none Задает эффект при переходе с одной страницы на следующую. Ознакомьтесь с нашим разделомПереходы страниц jQuery Mobile.


Радиокнопки

сtype="radio"парой label и input. Они автоматически отображаются как стили кнопок, data-role не требуется.

Атрибут данных Значение Описание
data-mini true | false Указывает, имеет ли кнопка маленький или обычный размер.
data-role none Запрещает jQuery Mobile отображать радиокнопку как улучшенную кнопку, в результате чего элемент отображается в своем исходном HTML-состоянии.
data-theme Буква (a-z) Указывает цвет темы радиокнопки.

lamp Чтобы сгруппировать несколько радиокнопок, используйте контейнер с атрибутом data-role="controlgroup" и data-type="horizontal|vertical", чтобы указать, группировать радиокнопки по горизонтали или по вертикали.


Выбор

Все<select>элементы. Они автоматически отображаются как стили кнопок, data-role не требуется.

Атрибут данных Значение Описание
data-icon Справочник иконок Указывает значок для элемента select. По умолчанию — "arrow-d".
data-iconpos left | right | top | bottom | notext Задает положение значка.
data-inline true | false Указывает, является ли элемент select встроенным.
data-mini true | false Указывает, имеет ли элемент select маленький или обычный размер.
data-native-menu true | false Если установлено значение false, используется встроенное пользовательское меню выбора jQuery (рекомендуется, если вы хотите, чтобы меню выбора выглядело одинаково на всех мобильных устройствах).
data-overlay-theme Буква (a-z) Указывает цвет темы встроенного пользовательского меню выбора jQuery (используется с data-native-menu="false").
data-placeholder true | false Можно задать для элемента <option> нестандартного меню выбора.
data-role none Запрещает jQuery Mobile отображать элемент select в стиле кнопки.
data-theme Буква (a-z) Указывает цвет темы элемента select.

lamp Чтобы объединить несколько элементов select, используйте контейнер с атрибутом data-role="controlgroup" и data-type="horizontal|vertical", чтобы указать, группировать ли элементы select по горизонтали или по вертикали.


Slider

сtype="range"полями ввода. Они автоматически отображаются в стиле кнопок, date-role не требуется.

Атрибут данных Значение Описание
data-highlight true | false Указывает, подсвечена ли дорожка слайдера.
data-mini true | false Указывает, имеет ли слайдер маленький или обычный размер
data-role none Не позволяет jQuery Mobile отображать элемент управления слайдером в стиле кнопки
data-theme Буква (a-z) Указывает цвет темы элемента управления слайдером (input, ползунок и дорожка)
data-track-theme Буква (a-z) Указывает цвет темы дорожки слайдера


Текстовые поля ввода и текстовые области

сtype="text|search|etc."input илиэлемент textarea. Они автоматически отображаются в стиле кнопок, date-role указывать не требуется.

Атрибут данных Значение Описание
data-mini true | false Указывает, имеет ли поле ввода маленький или обычный размер
data-role none Не позволяет jQuery Mobile отображать поля ввода/текстовые области в стиле кнопок
data-theme Буква (a-z) Указывает цвет темы поля ввода


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