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) | Задает цвет темы кнопки |
| Чтобы объединить несколько кнопок, используйте контейнер с `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) | Задает цвет темы флажка |
| Чтобы объединить несколько флажков, используйте контейнер с `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 | Задает положение значка. |
| Панели навигации наследуют образец темы от родительского контейнера. Невозможно установить атрибут 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) | Указывает цвет темы радиокнопки. |
| Чтобы сгруппировать несколько радиокнопок, используйте контейнер с атрибутом 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. |
| Чтобы объединить несколько элементов 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) | Указывает цвет темы поля ввода |
Другие расширения