Skip to content

jQuery Mobile Шпаргалка

Оптимизированный для сенсорных экранов HTML5 UI-фреймворк для мобильных веб-приложений.

01

Начало работы

Структура страницы

jQuery Mobile расширяет HTML через атрибуты data-role. Страница — это div с data-role=page, содержащий header, основную часть и footer. Метатег viewport важен для правильного масштабирования на мобильных. Подключайте ядро jQuery до jquery.mobile.js.

jquery-mobile
<!DOCTYPE html>
<html>
<head>
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <link rel="stylesheet" href="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">
  <script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
  <script src="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>
</head>
<body>
  <div data-role="page" id="home">
    <div data-role="header"><h1>Home</h1></div>
    <div data-role="main" class="ui-content">Content</div>
    <div data-role="footer"><h4>Footer</h4></div>
  </div>
</body>
</html>

Несколько страниц в одном документе

В одном HTML-файле можно разместить несколько div с data-role=page. Связывайте их якорными ссылками (#about). jQuery Mobile показывает одну страницу за раз и анимирует переходы. При первой загрузке видна только первая страница в порядке исходника.

jquery-mobile
<div data-role="page" id="home">
  <div data-role="header"><h1>Home</h1></div>
  <div data-role="main" class="ui-content">
    <a href="#about" class="ui-btn">Go to About</a>
  </div>
</div>

<div data-role="page" id="about" data-theme="b">
  <div data-role="header"><h1>About</h1></div>
  <div data-role="main" class="ui-content">
    <a href="#home" class="ui-btn" data-direction="reverse">Back</a>
  </div>
</div>

AJAX-навигация и ссылки

По умолчанию ссылки на внутренние (#id) и same-origin страницы загружаются через AJAX и подменяются с переходом. data-ajax=false принудительно включает обычную полную загрузку страницы (полезно для страниц без jQuery Mobile). data-prefetch предзагружает цель, чтобы переход был мгновенным.

jquery-mobile
<!-- Default: links load via AJAX and animate a transition -->
<a href="detail.html" class="ui-btn">Open detail (AJAX)</a>

<!-- Force a full page reload (no AJAX) -->
<a href="external.html" data-ajax="false">Full reload</a>

<!-- Open in new window/tab -->
<a href="https://example.com" rel="external">External site</a>

<!-- Prefetch a page when this page loads -->
<a href="next.html" data-prefetch="true" class="ui-btn">Prefetch next</a>

Предзагрузка и кеш DOM

Предзагрузка загружает связанные страницы в фоне, чтобы навигация казалась мгновенной. По умолчанию посещённые страницы удаляются из DOM, но domCache сохраняет их для более быстрого возврата ценой памяти. Включайте на странице через data-dom-cache или глобально через опцию прототипа page.

jquery-mobile
<!-- Prefetch several pages -->
<a href="page1.html" data-prefetch="true">Page 1</a>
<a href="page2.html" data-prefetch="true">Page 2</a>

<!-- Globally enable DOM caching of visited pages -->
<script>
$(document).on("mobileinit", function () {
  $.mobile.page.prototype.options.domCache = true;
});
</script>

<!-- Cache a single page -->
<div data-role="page" id="cached" data-dom-cache="true">...</div>

Страницы-диалоги

Добавьте data-rel=dialog к ссылке (или data-dialog=true к странице), чтобы открыть страницу как модальный диалог с кнопкой закрытия и переходом. data-rel=back на ссылке закрывает его и возвращает на предыдущую страницу.

jquery-mobile
<!-- Open a page as a dialog -->
<a href="#dialog" class="ui-btn" data-rel="dialog">Open dialog</a>

<div data-role="page" id="dialog" data-dialog="true">
  <div data-role="header"><h1>Dialog</h1></div>
  <div data-role="main" class="ui-content">
    <p>This page is styled as a dialog.</p>
    <a href="#" class="ui-btn" data-rel="back">Close</a>
  </div>
</div>

Глобальная настройка (mobileinit)

Событие mobileinit срабатывает после загрузки ядра jQuery, но до инициализации jQuery Mobile: привязывайте настройку здесь, до подключения jquery.mobile.js. Частые переопределения: переходы по умолчанию, настройки AJAX и текст сообщения загрузки. autoInitializePage=false позволяет управлять инициализацией первой страницы.

jquery-mobile
<script src="jquery-1.11.1.min.js"></script>
<script>
// Bind BEFORE loading jquery.mobile.js
$(document).on("mobileinit", function () {
  $.mobile.defaultPageTransition = "slide";
  $.mobile.defaultDialogTransition = "pop";
  $.mobile.loadingMessage = "Loading...";
  $.mobile.ajaxEnabled = true;
  $.mobile.linkBindingEnabled = true;
  $.mobile.autoInitializePage = true;
});
</script>
<script src="jquery.mobile-1.4.5.min.js"></script>
02

Переходы страниц

Базовые переходы

Добавьте data-transition к ссылке, чтобы выбрать анимацию при переходе. Переходы основаны на CSS (где возможно — с аппаратным ускорением). 'none' пропускает анимацию для мгновенного перехода. Тот же атрибут работает для диалогов и всплывающих окон.

jquery-mobile
<!-- Apply a transition to a link -->
<a href="#page2" data-transition="slide">Slide</a>
<a href="#page2" data-transition="fade">Fade</a>
<a href="#page2" data-transition="pop">Pop</a>
<a href="#page2" data-transition="flip">Flip</a>
<a href="#page2" data-transition="none">None (instant)</a>

Типы переходов

jQuery Mobile поставляется с набором 2D/3D CSS-переходов. 3D-переходы (turn, flow, flip) отлично выглядят на мощных устройствах, но корректно деградируют на старом железе. pop и fade самые производительные и рекомендуются для диалогов и всплывающих окон.

jquery-mobile
<!-- Available transitions in jQuery Mobile 1.4 -->
fade      <!-- default, fade in/out -->
pop       <!-- scale in from center (good for dialogs) -->
slide     <!-- slide left to right -->
slideup   <!-- slide up from bottom -->
slidedown <!-- slide down from top -->
slidfade  <!-- slide + fade -->
turn      <!-- 3D turn -->
flow      <!-- 3D flow -->
flip      <!-- 3D flip -->
none      <!-- no animation -->

Направление и обратный ход

data-direction=reverse проигрывает переход в обратную сторону — обычно на кнопках «Назад», чтобы анимация зеркалила прямой переход. Это сочетается с data-transition; если переход не задан, используется обратный переход по умолчанию.

jquery-mobile
<!-- Reverse a transition (e.g., for Back buttons) -->
<a href="#home" data-transition="slide" data-direction="reverse">Back</a>

<!-- Globally reverse the default -->
<a href="#home" data-direction="reverse">Back (uses default transition reversed)</a>

Переходы диалогов

Диалоги могут использовать любой переход, но pop и slidedown наиболее естественны для модальных окон. Глобальное значение по умолчанию задаётся через $.mobile.defaultDialogTransition во время mobileinit. Закрытие диалога автоматически проигрывает переход в обратную сторону.

jquery-mobile
<!-- Combine data-rel=dialog with a transition -->
<a href="#settings" data-rel="dialog" data-transition="pop">Settings</a>
<a href="#settings" data-rel="dialog" data-transition="slidedown">Settings (slide down)</a>

<!-- Set a global default dialog transition -->
<script>
$(document).on("mobileinit", function () {
  $.mobile.defaultDialogTransition = "pop";
});
</script>

Отключение и запасной вариант

Задайте data-transition=none или глобальное 'none', чтобы отключить анимации — полезно на слабых устройствах и для доступности. jQuery Mobile сам определяет поддержку 3D-трансформаций и заменяет 3D-переходы (flip, turn, flow) простым fade, если они не поддерживаются.

jquery-mobile
<!-- Disable transitions for a specific link -->
<a href="#page2" data-transition="none">No animation</a>

<!-- Globally disable (useful for older devices / testing) -->
<script>
$(document).on("mobileinit", function () {
  $.mobile.defaultPageTransition = "none";
  $.mobile.defaultDialogTransition = "none";
});
</script>

<!-- 3D transitions fall back to fade when not supported -->
03

Панели инструментов (header и footer)

Фиксированные header и footer

data-position=fixed закрепляет header или footer у верхнего/нижнего края viewport при прокрутке страницы. По умолчанию касание страницы переключает видимость панелей. Содержимому страницы добавляется отступ, чтобы оно не скрывалось за панелями.

jquery-mobile
<div data-role="page" id="home">
  <div data-role="header" data-position="fixed">
    <h1>Fixed Header</h1>
  </div>
  <div data-role="main" class="ui-content">
    <p>Scroll the page — the toolbars stay in place.</p>
  </div>
  <div data-role="footer" data-position="fixed">
    <h4>Fixed Footer</h4>
  </div>
</div>

Полноэкранные панели

data-fullscreen=true накладывает фиксированные панели поверх содержимого (полупрозрачно), а не резервирует место. Отлично для просмотра фото или карт, где содержимое должно занимать весь экран. Панели появляются и исчезают по касанию, как и фиксированные.

jquery-mobile
<div data-role="page" id="photo">
  <div data-role="header" data-position="fixed" data-fullscreen="true">
    <h1>Photos</h1>
  </div>
  <div data-role="main" class="ui-content">
    <img src="photo.jpg" style="width:100%">
  </div>
  <div data-role="footer" data-position="fixed" data-fullscreen="true">
    <h4>Footer over content</h4>
  </div>
</div>

Постоянные панели

Когда у двух страниц footers (или headers) имеют одинаковые data-id и data-position=fixed, панель сохраняется между переходами, а не анимируется вместе со страницей. Это стандартный паттерн для постоянной нижней навигации: на каждой странице меняется только активная ссылка.

jquery-mobile
<!-- Both pages use the SAME data-id so the footer persists -->
<div data-role="page" id="home">
  <div data-role="footer" data-id="main-nav" data-position="fixed">
    <div data-role="navbar">
      <ul><li><a href="#home" class="ui-btn-active">Home</a></li>
      <li><a href="#settings">Settings</a></li></ul>
    </div>
  </div>
</div>

<div data-role="page" id="settings">
  <div data-role="footer" data-id="main-nav" data-position="fixed">
    <div data-role="navbar">
      <ul><li><a href="#home">Home</a></li>
      <li><a href="#settings" class="ui-btn-active">Settings</a></li></ul>
    </div>
  </div>
</div>

Переключение по касанию

Фиксированные панели переключают видимость при касании страницы. data-tap-toggle=false держит панель всегда видимой. Связанные опции на элемент: data-hide-during-focus (скрывать при фокусе в полях) и data-update-page-padding (пересчитывать отступ страницы при ресайзе).

jquery-mobile
<!-- Disable tap-to-toggle on a fixed toolbar -->
<div data-role="header" data-position="fixed" data-tap-toggle="false">
  <h1>Always visible</h1>
</div>

<!-- Globally turn off tap toggle -->
<script>
$(document).on("mobileinit", function () {
  $.mobile.toolbar.prototype.options.tapToggle = false;
});
</script>

Тема и кнопки панели

В header можно размещать кнопки с классами ui-btn-left / ui-btn-right. data-theme задаёт цветовую схему панели. data-iconpos=notext показывает только иконку для компактности. Кнопки в header автоматически стилизуются как inline-кнопки.

jquery-mobile
<div data-role="header" data-theme="b">
  <a href="#" class="ui-btn-left" data-icon="home" data-iconpos="notext">Home</a>
  <h1>Title</h1>
  <a href="#" class="ui-btn-right" data-icon="gear" data-iconpos="notext">Settings</a>
</div>

Динамическое обновление панелей

После изменения разметки панели во время выполнения вызовите $(el).toolbar('refresh'), чтобы повторно применить стили и отступы. Виджет toolbar (появился в 1.4) управляет фиксированным позиционированием и переключением по касанию; инициализируйте его вручную через $().toolbar(), если добавляете панель после создания страницы.

jquery-mobile
<script>
// Update the header title and re-enhance after DOM change
$(function () {
  $("#my-header h1").text("New Title");
  $("#my-header").toolbar("refresh");
});
</script>

<div data-role="header" id="my-header" data-position="fixed">
  <h1>Old Title</h1>
</div>
05

Кнопки

Основы кнопок

Любой <a> с классом ui-btn (или data-role=button), а также <button> и <input type=button|submit|reset> автоматически превращаются в стилизованные кнопки. Класс ui-btn — современный способ пометить ссылку кнопкой, не полагаясь на data-role.

jquery-mobile
<!-- Anchor button -->
<a href="#" class="ui-btn">Link Button</a>

<!-- <button> and <input> auto-enhanced -->
<button class="ui-btn">Button Element</button>
<input type="button" value="Input Button">
<input type="submit" value="Submit">

<!-- Use data-role explicitly -->
<a href="#" data-role="button">Anchor via role</a>

Inline-кнопки

По умолчанию кнопки занимают всю ширину (block). Добавьте ui-btn-inline (или data-inline=true), чтобы кнопка была шириной по подписи, и несколько кнопок стояли рядом. Удобно для рядов действий вроде «Отмена | ОК».

jquery-mobile
<!-- Inline: only as wide as the content -->
<a href="#" class="ui-btn ui-btn-inline">A</a>
<a href="#" class="ui-btn ui-btn-inline">B</a>
<a href="#" class="ui-btn ui-btn-inline">C</a>

<!-- Default (block) buttons fill the width -->
<a href="#" class="ui-btn">Full-width button</a>

Иконки кнопок

Используйте ui-icon-{name}, чтобы добавить иконку, и ui-btn-icon-{pos}, чтобы задать её положение (left, right, top, bottom, notext). ui-btn-icon-notext скрывает текст и показывает только иконку — текст всё равно указывайте для доступности и скринридеров.

jquery-mobile
<a href="#" class="ui-btn ui-icon-home ui-btn-icon-left">Home</a>
<a href="#" class="ui-btn ui-icon-search ui-btn-icon-right">Search</a>
<a href="#" class="ui-btn ui-icon-gear ui-btn-icon-top">Settings</a>
<a href="#" class="ui-btn ui-icon-star ui-btn-icon-notext">Star (icon only)</a>
<a href="#" class="ui-btn ui-icon-delete ui-btn-icon-bottom">Delete</a>

Позиция иконки и inline

Атрибут data-iconpos — устаревший аналог классов ui-btn-icon-*. 'notext' показывает только иконку (всегда оставляйте видимый текст для скринридеров через текст элемента). Классы inline и иконки можно свободно сочетать на одной кнопке.

jquery-mobile
<!-- data-* equivalents -->
<a href="#" data-role="button" data-icon="home" data-iconpos="left">Home</a>
<a href="#" data-role="button" data-icon="home" data-iconpos="notext">Home</a>

<!-- Combine inline + icon -->
<a href="#" class="ui-btn ui-btn-inline ui-icon-plus ui-btn-icon-left">Add</a>
<a href="#" class="ui-btn ui-btn-inline ui-icon-minus ui-btn-icon-left">Remove</a>

Мини-кнопки и отключённые кнопки

Добавьте ui-mini (или data-mini=true) для меньшей, более компактной кнопки — полезно в плотных панелях. Отключайте кнопку через ui-state-disabled (или нативный атрибут disabled у <button>/<input>). Отключённые кнопки игнорируют касания.

jquery-mobile
<!-- Mini (smaller) button -->
<a href="#" class="ui-btn ui-mini">Mini</a>

<!-- Disabled button -->
<a href="#" class="ui-btn ui-state-disabled">Disabled</a>

<!-- Native disabled -->
<button disabled>Disabled button</button>
<input type="submit" value="Go" disabled>

Группы кнопок (controlgroup)

controlgroup визуально объединяет кнопки: соседние кнопки делят скруглённые углы и не имеют зазоров. data-type=horizontal выстраивает их в ряд (хорошо для сегментированных переключателей); по умолчанию вертикально. Так же группируются checkbox и radio в единый набор.

jquery-mobile
<div data-role="controlgroup" data-type="horizontal">
  <a href="#" class="ui-btn">Yes</a>
  <a href="#" class="ui-btn">No</a>
  <a href="#" class="ui-btn">Maybe</a>
</div>

<!-- Vertical group (default) -->
<div data-role="controlgroup">
  <a href="#" class="ui-btn">Option 1</a>
  <a href="#" class="ui-btn">Option 2</a>
</div>
06

Списки

Базовый список

Добавьте data-role=listview к <ul>, чтобы превратить его в удобный для касаний список с полноширинными строками. Каждый <li> с <a> становится строкой-ссылкой со стрелкой справа. data-inset=true делает список врезным: скруглённые углы и отступы вместо края до края.

jquery-mobile
<ul data-role="listview" data-inset="true">
  <li><a href="#">Apple</a></li>
  <li><a href="#">Banana</a></li>
  <li><a href="#">Cherry</a></li>
</ul>

Врезные списки

Списки от края до края занимают всю ширину (хорошо для полноэкранных меню); врезные имеют скруглённые углы и отступы (хорошо для секций содержимого). Используйте data-inset=true для врезных списков, которые выглядят как сгруппированные панели настроек.

jquery-mobile
<!-- Edge-to-edge (default) -->
<ul data-role="listview">
  <li><a href="#">Item 1</a></li>
</ul>

<!-- Inset: rounded, with margins -->
<ul data-role="listview" data-inset="true">
  <li><a href="#">Item 1</a></li>
  <li><a href="#">Item 2</a></li>
</ul>

Разделители списка

<li> с data-role=list-divider становится некликабельным заголовком секции. data-autodividers=true автоматически вставляет разделители по первой букве текста элемента — идеально для алфавитного списка контактов.

jquery-mobile
<ul data-role="listview" data-inset="true">
  <li data-role="list-divider">Fruits</li>
  <li><a href="#">Apple</a></li>
  <li><a href="#">Banana</a></li>
  <li data-role="list-divider">Vegetables</li>
  <li><a href="#">Carrot</a></li>
</ul>

<!-- Auto dividers from first letter -->
<ul data-role="listview" data-autodividers="true">
  <li><a href="#">Alice</a></li>
  <li><a href="#">Bob</a></li>
</ul>

Счётчики и миниатюры

Добавьте span с классом ui-li-count внутрь <li>, чтобы показать числовой счётчик справа. Используйте <img> с классом ui-li-thumb (обычно 80x80) для миниатюры слева. Сочетайте с <h3>/<p> для богатых строк в стиле приложения.

jquery-mobile
<ul data-role="listview" data-inset="true">
  <!-- Count bubble -->
  <li><a href="#">Inbox <span class="ui-li-count">12</span></a></li>
  <!-- Thumbnail on the left -->
  <li>
    <a href="#">
      <img src="thumb.jpg" class="ui-li-thumb">
      <h3>Title</h3>
      <p>Description</p>
      <span class="ui-li-count">3</span>
    </a>
  </li>
</ul>

Поиск с фильтром

data-filter=true добавляет над списком поле поиска, фильтрующее элементы по тексту в реальном времени. data-filter-placeholder настраивает подсказку. data-filter-reveal=true скрывает все элементы, пока пользователь не начнёт ввод, — удобно для поиска в стиле автодополнения.

jquery-mobile
<ul data-role="listview" data-filter="true"
    data-filter-placeholder="Search fruits...">
  <li><a href="#">Apple</a></li>
  <li><a href="#">Banana</a></li>
  <li><a href="#">Cherry</a></li>
</ul>

<!-- Filter reveals hidden items (collapsible search) -->
<ul data-role="listview" data-filter="true" data-filter-reveal="true">
  <li><a href="#">Hidden until searched</a></li>
</ul>

Split-кнопки и вложенные списки

Когда <li> содержит две ссылки <a>, jQuery Mobile рисует split-кнопку: основная строка ведёт по первой ссылке, а отдельная кнопка-иконка (задаётся через data-split-icon) справа открывает вторую. Вложенный <ul> внутри <li> автоматически становится подстраницей для углубления.

jquery-mobile
<!-- Split button: row link + icon link on the right -->
<ul data-role="listview" data-split-icon="gear" data-inset="true">
  <li>
    <a href="#detail">Go to detail</a>
    <a href="#edit">Edit</a>
  </li>
</ul>

<!-- Nested list (child <ul> becomes a sub-page) -->
<ul data-role="listview">
  <li>Fruits
    <ul>
      <li><a href="#">Apple</a></li>
      <li><a href="#">Banana</a></li>
    </ul>
  </li>
</ul>
07

Элементы форм

Структура формы и AJAX-отправка

jQuery Mobile автоматически улучшает поля форм и по умолчанию отправляет формы через AJAX, показывая индикатор загрузки и переходя на страницу результата. data-ajax=false включает традиционную полную отправку (нужно для загрузки файлов без современного API).

jquery-mobile
<form action="/submit" method="post" data-ajax="true">
  <label for="name">Name:</label>
  <input type="text" name="name" id="name" placeholder="Your name">

  <button type="submit" class="ui-btn">Submit</button>
</form>

<!-- Disable AJAX for this form (normal full submit) -->
<form action="/upload" method="post" data-ajax="false">...</form>

Текстовые поля и кнопка очистки

Все HTML5-типы input (text, email, tel, number, password, date и др.) стилизуются единообразно. data-clear-btn=true добавляет кнопку очистки (x) внутри поля. data-role=none оставляет элемент обычным нативным input без стилей jQuery Mobile.

jquery-mobile
<label for="email">Email</label>
<input type="email" id="email" data-clear-btn="true" placeholder="[email protected]">

<label for="phone">Phone</label>
<input type="tel" id="phone" data-clear-btn="true" data-clear-btn-text="Clear">

<!-- Non-enhanced native input -->
<input type="text" data-role="none">

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

Оборачивайте пару label + элемент управления в div с классом ui-field-contain. На широких экранах подпись и поле стоят рядом; на узких телефонах — друг под другом. Это адаптивное поведение заменяет устаревший атрибут data-role=fieldcontain.

jquery-mobile
<div class="ui-field-contain">
  <label for="user">Username</label>
  <input type="text" id="user">
</div>

<div class="ui-field-contain">
  <label for="pwd">Password</label>
  <input type="password" id="pwd">
</div>

Поле поиска

<input type=search> превращается в поле поиска с иконкой лупы. Свяжите его со списком, дав input id и задав data-input=#id в фильтре списка: так поле поиска можно разместить в любом месте страницы.

jquery-mobile
<label for="q">Search</label>
<input type="search" id="q" placeholder="Search...">

<!-- Search input feeding a listview filter -->
<input type="search" id="my-filter" data-type="search">
<ul data-role="listview" data-filter="true"
    data-input="#my-filter">
  <li><a href="#">Apple</a></li>
  <li><a href="#">Banana</a></li>
</ul>

Textarea и скрытые поля

Textarea стилизуется как остальные поля и по умолчанию автоматически растёт по мере ввода; data-autogrow=false фиксирует высоту с полосой прокрутки. Скрытые поля передаются без изменений. Как и все поля, оборачивайте их в ui-field-contain для адаптивных подписей.

jquery-mobile
<label for="bio">Bio</label>
<textarea id="bio" placeholder="Tell us about you"></textarea>

<!-- Auto-grow textarea -->
<textarea id="bio" data-autogrow="false"></textarea>

<!-- Hidden inputs are not styled -->
<input type="hidden" name="id" value="42">

Отключение автоулучшения

Добавьте data-role=none к любому элементу управления, чтобы пропустить улучшение jQuery Mobile и оставить его нативным. Для правила на весь проект задайте keepNative во время mobileinit как строку селектора элементов, которые никогда не улучшать, — полезно при смешивании своих стилизованных контролов со страницами jQM.

jquery-mobile
<!-- Keep a control native (no jQM styling) -->
<select data-role="none">...</select>
<input type="checkbox" data-role="none">

<!-- Globally disable enhancement for a tag -->
<script>
$(document).on("mobileinit", function () {
  $.mobile.page.prototype.options.keepNative = "select, input[type=checkbox]";
});
</script>
08

Слайдеры

Базовый ползунок

<input type=range> с min, max, value и step превращается в удобный для касаний слайдер с пузырьком значения. Атрибут value задаёт начальную позицию. Слайдер записывает значение обратно в input, поэтому оно отправляется с формой как обычно.

jquery-mobile
<label for="volume">Volume</label>
<input type="range" name="volume" id="volume"
       value="50" min="0" max="100" step="1">

Слайдер с подсветкой

data-highlight=true закрашивает дорожку слева от ползунка активным цветом темы, наглядно показывая текущий уровень. Без этого дорожка одного плоского цвета. Полезно для настроек вроде громкости или яркости.

jquery-mobile
<label for="brightness">Brightness</label>
<input type="range" id="brightness"
       value="70" min="0" max="100"
       data-highlight="true">

Мини-слайдер

data-mini=true рисует меньший, более компактный слайдер, занимающий меньше высоты, — удобно при группировке нескольких контролов в панели настроек. Работает так же, как обычный слайдер, только меньшего размера.

jquery-mobile
<label for="age">Age</label>
<input type="range" id="age" value="25" min="0" max="120"
       data-mini="true" data-highlight="true">

Шаг и несколько слайдеров

step задаёт приращение (например, step=5 привязывает к 0, 5, 10, ...). Каждый range input — независимый слайдер; для диапазона с двумя ползунками нужно строить свой виджет или брать сторонний плагин. Поведением управляют нативные атрибуты value, min, max.

jquery-mobile
<label for="temp">Temperature (step 5)</label>
<input type="range" id="temp" value="20" min="0" max="100" step="5">

<!-- Two independent sliders -->
<label for="low">Min</label>
<input type="range" id="low" value="10" min="0" max="100">
<label for="high">Max</label>
<input type="range" id="high" value="90" min="0" max="100">

События слайдера

Слайдер генерирует slidestart, когда пользователь начинает тянуть ползунок, и slidestop, когда перетаскивание заканчивается. Для непрерывных обновлений во время перетаскивания привязывайтесь к нативным событиям 'input' или 'change' нижележащего range input. Читайте и задавайте значение через $(el).val().

jquery-mobile
<label for="vol">Volume</label>
<input type="range" id="vol" value="50" min="0" max="100">

<script>
$("#vol").on("slidestart", function () {
  console.log("User started dragging");
});
$("#vol").on("slidestop", function () {
  console.log("Value is now " + $(this).val());
});
</script>
09

Переключатели flip

Базовый flip-переключатель

Flip-переключатель — это <select> ровно с двумя <option> и data-role=slider. Он рисуется как переключатель вкл/выкл в стиле iOS. Выбранный option определяет начальное состояние, а значение отправляется как у обычного select (значение выбранного option).

jquery-mobile
<label for="notify">Notifications</label>
<select name="notify" id="notify" data-role="slider">
  <option value="off">Off</option>
  <option value="on" selected>On</option>
</select>

Свои подписи

Текст двух option становится подписями по сторонам переключателя. Можно использовать любой короткий текст (On/Off, Yes/No, Enabled/Disabled). Держите подписи короткими, чтобы они помещались в переключателе без обрезки на маленьких экранах.

jquery-mobile
<label for="wifi">Wi-Fi</label>
<select id="wifi" data-role="slider">
  <option value="disabled">Disabled</option>
  <option value="enabled" selected>Enabled</option>
</select>

Мини flip-переключатель

data-mini=true рисует меньший переключатель, занимающий меньше высоты, в тон мини-слайдерам и другим мини-контролам. Сочетайте мини-контролы в плотных панелях настроек для согласованного компактного вида.

jquery-mobile
<label for="sync">Auto-sync</label>
<select id="sync" data-role="slider" data-mini="true">
  <option value="no">No</option>
  <option value="yes" selected>Yes</option>
</select>

Тема flip

data-theme задаёт цвет ползунка, а data-track-theme — цвет дорожки под ним. Смешение схем (например, тёмный ползунок на светлой дорожке) делает активное состояние заметнее.

jquery-mobile
<label for="darkmode">Dark mode</label>
<select id="darkmode" data-role="slider"
        data-theme="b" data-track-theme="a">
  <option value="off">Off</option>
  <option value="on" selected>On</option>
</select>

Программное переключение

Задайте значение через $(el).val(value), затем вызовите .slider('refresh'), чтобы обновить визуальный переключатель. Читайте текущее состояние через .val(). Всегда вызывайте refresh после программного изменения значения нижележащего select, иначе ползунок не сдвинется.

jquery-mobile
<select id="power" data-role="slider">
  <option value="off">Off</option>
  <option value="on">On</option>
</select>

<script>
// Turn the switch on programmatically
$("#power").val("on").slider("refresh");
// Read current state
var state = $("#power").val(); // "on" or "off"
</script>
10

Checkbox и radio

Checkbox

Checkbox — обычный <input type=checkbox>, обёрнутый в <label for=id> (или рядом с ним). jQuery Mobile стилизует label как кликабельный блок. Если label оборачивает input, атрибут for необязателен. Отмеченное состояние отправляется с формой как обычно.

jquery-mobile
<label for="agree"><input type="checkbox" id="agree" name="agree"> I agree</label>

<label for="news"><input type="checkbox" id="news" name="news" checked> Newsletter</label>

<!-- Wrap in ui-field-contain for layout -->
<div class="ui-field-contain">
  <label for="agree">I agree to terms</label>
  <input type="checkbox" id="agree">
</div>

Радиокнопки

Группируйте radio, давая им одинаковый атрибут name. Оберните группу в fieldset с data-role=controlgroup (и <legend>), чтобы визуально объединить их общими углами. В группе с одинаковым именем одновременно может быть отмечена только одна радиокнопка.

jquery-mobile
<fieldset data-role="controlgroup">
  <legend>Choose a color:</legend>
  <label for="r"><input type="radio" name="color" id="r" value="red" checked> Red</label>
  <label for="g"><input type="radio" name="color" id="g" value="green"> Green</label>
  <label for="b"><input type="radio" name="color" id="b" value="blue"> Blue</label>
</fieldset>

Горизонтальные controlgroup

data-type=horizontal выстраивает checkbox или radio в один ряд как сегментированный переключатель, а не вертикально. Это компактно и хорошо для коротких подписей (S/M/L, Yes/No). Держите подписи короткими, чтобы они помещались на узких экранах.

jquery-mobile
<fieldset data-role="controlgroup" data-type="horizontal">
  <legend>Size:</legend>
  <label for="s"><input type="radio" name="size" id="s" value="s" checked> S</label>
  <label for="m"><input type="radio" name="size" id="m" value="m"> M</label>
  <label for="l"><input type="radio" name="size" id="l" value="l"> L</label>
</fieldset>

Мини и тема

data-mini=true уменьшает контролы, а data-theme задаёт схему для отмеченного/активного элемента. Оформляйте активное состояние так, чтобы оно выделялось на фоне страницы. Эти опции применяются сразу ко всей controlgroup.

jquery-mobile
<fieldset data-role="controlgroup" data-mini="true" data-theme="b">
  <label for="a"><input type="checkbox" id="a"> Option A</label>
  <label for="b"><input type="checkbox" id="b"> Option B</label>
</fieldset>

Обновление после изменения

После программной установки свойства checked у checkbox/radio вызовите .checkboxradio('refresh'), чтобы улучшенный вид соответствовал состоянию. Если во время выполнения добавляете или удаляете элементы внутри controlgroup, вызовите .controlgroup('refresh'), чтобы повторно применить групповые стили.

jquery-mobile
<input type="checkbox" id="c1">

<script>
// Check programmatically and update the visual state
$("#c1").prop("checked", true).checkboxradio("refresh");

// For a controlgroup, refresh the group after adding/removing items
$("#grp").controlgroup("refresh");
</script>
11

Меню select

Нативный select

По умолчанию jQuery Mobile показывает стилизованный select, но открывается всё равно системный выбор. data-native-menu=true (или data-role=none) использует полностью нативный выпадающий список устройства — быстрее и привычнее, но менее единообразно между платформами.

jquery-mobile
<label for="country">Country</label>
<select id="country" data-native-menu="true">
  <option value="us">United States</option>
  <option value="ca">Canada</option>
  <option value="uk">United Kingdom</option>
</select>

<!-- data-role="none" also keeps it fully native -->
<select data-role="none">...</select>

Своё меню select

data-native-menu=false открывает всплывающее меню в стиле jQuery Mobile вместо нативного выбора, давая единый вид на всех устройствах. На телефоне оно выглядит как полноэкранный диалог с кнопкой «Готово»; на планшете — как меньшее всплывающее окно рядом с полем.

jquery-mobile
<label for="fruit">Fruit</label>
<select id="fruit" data-native-menu="false">
  <option value="apple">Apple</option>
  <option value="banana">Banana</option>
  <option value="cherry">Cherry</option>
</select>

Placeholder и multiple

Первый option с пустым значением работает как placeholder. data-overlay-theme задаёт цвет подложки своего меню. Атрибут multiple превращает своё меню в диалог-чеклист, где можно выбрать несколько вариантов; на кнопке они показываются через запятую.

jquery-mobile
<label for="color">Color</label>
<select id="color" data-native-menu="false" data-overlay-theme="b">
  <option value="">Choose a color...</option>
  <option value="red">Red</option>
  <option value="green">Green</option>
</select>

<!-- Multiple selection (renders as a checklist dialog) -->
<label for="tags">Tags</label>
<select id="tags" multiple data-native-menu="false">
  <option value="a">A</option>
  <option value="b">B</option>
</select>

Тема select и подложка

data-theme стилизует саму кнопку select; data-overlay-theme задаёт цвет всплывающего окна и подложки; data-divider-theme задаёт цвет разделителей списка внутри меню. Можно вставлять <li data-role=list-divider> между option, чтобы визуально группировать их.

jquery-mobile
<label for="size">Size</label>
<select id="size" data-native-menu="false"
        data-theme="a" data-overlay-theme="b" data-divider-theme="a">
  <option value="s">Small</option>
  <option value="m">Medium</option>
  <li data-role="list-divider">Large sizes</li>
  <option value="l">Large</option>
</select>

События select

Слушайте стандартное событие 'change', чтобы реагировать на выбор. После изменения значения (или замены option) в коде вызовите .selectmenu('refresh'), чтобы подпись кнопки обновилась. Перестраивайте меню через 'refresh', а не повторной инициализацией.

jquery-mobile
<label for="city">City</label>
<select id="city" data-native-menu="false">
  <option value="ny">New York</option>
  <option value="la">Los Angeles</option>
</select>

<script>
$("#city").on("change", function () {
  console.log("Selected: " + $(this).val());
});
// Update options then refresh
$("#city").val("la").selectmenu("refresh");
</script>
12

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

Базовое popup

Popup — это div с data-role=popup. Открывайте его ссылкой на его id с data-rel=popup. Popup накладывается на страницу, по умолчанию по центру. Добавьте ui-content для отступов, а для закрытия используйте data-rel=back на ссылке внутри.

jquery-mobile
<a href="#myPopup" data-rel="popup" class="ui-btn">Open popup</a>

<div data-role="popup" id="myPopup" class="ui-content">
  <p>This is a popup.</p>
  <a href="#" class="ui-btn" data-rel="back">Close</a>
</div>

Переходы popup

Используйте data-transition на открывающей ссылке (или на самом popup), чтобы выбрать анимацию. pop и fade наиболее естественны для всплывающих окон. Применяется тот же набор переходов, что и для страниц; закрытие автоматически проигрывает переход в обратную сторону.

jquery-mobile
<a href="#p" data-rel="popup" data-transition="pop">Pop</a>
<a href="#p" data-rel="popup" data-transition="fade">Fade</a>
<a href="#p" data-rel="popup" data-transition="slidedown">Slide down</a>

<div data-role="popup" id="p" class="ui-content" data-theme="a">
  <p>Transitioned in.</p>
</div>

Позиционирование popup

data-position-to управляет местом появления: 'origin' (элемент, открывший popup, по умолчанию), '#someId' (конкретный элемент) или 'window' (по центру экрана). При программном открытии через popup('open', x, y) можно передать координаты x/y.

jquery-mobile
<!-- Position relative to an element / coordinates -->
<a href="#tip" data-rel="popup" data-position-to="origin">Tip (on the link)</a>
<a href="#tip" data-rel="popup" data-position-to="#target">Tip (on #target)</a>
<a href="#tip" data-rel="popup" data-position-to="window">Centered</a>

<div data-role="popup" id="tip" class="ui-content">
  <p>Positioned popup.</p>
</div>

Popup-меню и подсказка

Popup может содержать любое содержимое: список становится контекстным меню, абзац — подсказкой. Стилизуйте popup через data-theme, а внутреннее содержимое — своей темой. Popup закрывается автоматически при касании вне (если не задано data-dismissible=false).

jquery-mobile
<a href="#menu" data-rel="popup" class="ui-btn">Menu</a>
<div data-role="popup" id="menu" data-theme="b">
  <ul data-role="listview" data-inset="true" data-theme="d">
    <li data-role="divider">Actions</li>
    <li><a href="#">Edit</a></li>
    <li><a href="#">Share</a></li>
    <li><a href="#">Delete</a></li>
  </ul>
</div>

Popup-диалог

Popup, расположенный по центру окна и с кнопкой закрытия, работает как модальный диалог. Добавьте кнопку X (ui-icon-delete с ui-btn-icon-notext) в углу. Ограничьте ширину через max-width, чтобы получить вид настоящего диалога, а не полноширинной панели.

jquery-mobile
<a href="#dlg" data-rel="popup" data-position-to="window"
   data-transition="pop" class="ui-btn">Open dialog</a>

<div data-role="popup" id="dlg" data-theme="a" class="ui-content"
     style="max-width:400px;">
  <a href="#" data-rel="back" class="ui-btn ui-corner-all ui-icon-delete
     ui-btn-icon-notext ui-btn-right">Close</a>
  <h3>Confirm</h3>
  <p>Are you sure?</p>
  <a href="#" class="ui-btn ui-btn-b" data-rel="back">Yes</a>
  <a href="#" class="ui-btn" data-rel="back">No</a>
</div>

Программное открытие и закрытие

Открывайте и закрывайте popup из кода через .popup('open'/'close'). data-dismissible=false запрещает закрытие касанием вне и заставляет пользователя нажать кнопку закрытия — идеально для обязательных подтверждений. При открытии можно передать координаты x/y или объект позиции.

jquery-mobile
<div data-role="popup" id="p2" data-dismissible="false">
  <p>Cannot close by tapping outside.</p>
  <a href="#" class="ui-btn" data-rel="back">Close</a>
</div>

<script>
// Open programmatically (optionally at coordinates)
$("#p2").popup("open");
$("#p2").popup("open", { x: 100, y: 200 });
// Close programmatically
$("#p2").popup("close");
</script>
13

Панели

Базовая панель

Панель — div с data-role=panel, размещённый внутри страницы (обычно до header). Открывайте её кнопкой-ссылкой на её id. Для закрытия используйте data-rel=close на ссылке внутри. Панели идеальны для выдвижных меню навигации.

jquery-mobile
<div data-role="page" id="home">
  <div data-role="panel" id="myPanel">
    <h2>Menu</h2>
    <p>Panel content here.</p>
    <a href="#" class="ui-btn" data-rel="close">Close</a>
  </div>

  <div data-role="header">
    <a href="#myPanel" class="ui-btn ui-btn-inline ui-corner-all ui-icon-bars ui-btn-icon-notext">Menu</a>
    <h1>Home</h1>
  </div>
  <div data-role="main" class="ui-content">
    <p>Page content.</p>
  </div>
</div>

Режимы отображения панели

data-display управляет анимацией открытия: 'reveal' (по умолчанию) сдвигает страницу в сторону, открывая панель под ней; 'overlay' накладывает панель поверх страницы; 'push' сдвигает и панель внутрь, и страницу. Overlay чаще всего используется для меню.

jquery-mobile
<div data-role="panel" id="p1" data-display="reveal">Reveal</div>
<div data-role="panel" id="p2" data-display="overlay">Overlay</div>
<div data-role="panel" id="p3" data-display="push">Push</div>

<!-- data-display controls how the panel interacts with the page:
     reveal : panel sits under the page, page slides away
     overlay: panel slides over the page (page stays)
     push   : both panel and page slide -->

Положение панели

data-position=left (по умолчанию) или right задаёт сторону, с которой выезжает панель. На одной странице можно иметь и левую, и правую панели. Одновременно открыта может быть только одна панель: открытие второй закрывает первую.

jquery-mobile
<!-- Left panel (default) -->
<div data-role="panel" id="leftP" data-position="left">Left</div>

<!-- Right panel -->
<div data-role="panel" id="rightP" data-position="right">Right</div>

<a href="#leftP" class="ui-btn">Open left</a>
<a href="#rightP" class="ui-btn">Open right</a>

Закрытие касанием и свайпом

data-dismissible=true (по умолчанию) закрывает панель при касании вне неё. data-swipe-close=true позволяет закрыть свайпом в противоположном направлении (например, свайп вправо закрывает левую панель). Оба включены по умолчанию для overlay-панелей.

jquery-mobile
<div data-role="panel" id="p"
     data-dismissible="true"
     data-swipe-close="true"
     data-position="left"
     data-display="overlay">
  <p>Tap outside or swipe to close.</p>
</div>

События панели

Панели генерируют panelbeforeopen, panelopen, panelbeforeclose и panelclose. Возврат false из обработчика «before» отменяет действие — полезно для подтверждения перед закрытием. Открывайте и закрывайте из кода через .panel('open'/'close').

jquery-mobile
<div data-role="panel" id="p">...</div>

<script>
$("#p").on("panelopen", function () {
  console.log("Panel opened");
});
$("#p").on("panelbeforeclose", function () {
  // return false here to prevent closing
  console.log("About to close");
});
$("#p").on("panelclose", function () {
  console.log("Panel closed");
});

// Open / close programmatically
$("#p").panel("open");
$("#p").panel("close");
</script>
14

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

Базовый collapsible

Div с data-role=collapsible оборачивает заголовок (h1-h6) как кликабельную шапку и остальное как раскрываемое содержимое. По умолчанию блок свёрнут. Клик по шапке раскрывает и сворачивает содержимое, меняя иконку +/-.

jquery-mobile
<div data-role="collapsible">
  <h3>Section title</h3>
  <p>Hidden content shown when expanded.</p>
  <p>Click the header to toggle.</p>
</div>

Иконки и тема collapsible

Настраивайте индикатор через data-collapsed-icon и data-expanded-icon (по умолчанию плюс/минус). data-theme стилизует шапку; data-content-theme стилизует раскрытую область. data-collapsed=false делает блок изначально раскрытым.

jquery-mobile
<div data-role="collapsible"
     data-collapsed-icon="carat-r"
     data-expanded-icon="carat-d"
     data-theme="b" data-content-theme="a"
     data-collapsed="false">
  <h3>Initially open</h3>
  <p>Custom icons and theme.</p>
</div>

Набор collapsible (аккордеон)

collapsibleset объединяет сворачиваемые блоки так, что открыт только один — аккордеон. Открытие одного автоматически закрывает остальные. (В 1.4 атрибут называется data-role=collapsibleset; старое имя collapsible-set тоже работает.) Весь набор делит единую тему.

jquery-mobile
<div data-role="collapsibleset" data-theme="a" data-content-theme="a">
  <div data-role="collapsible">
    <h3>Section 1</h3>
    <p>Only one section open at a time.</p>
  </div>
  <div data-role="collapsible" data-collapsed="false">
    <h3>Section 2 (open by default)</h3>
    <p>Opening this closes Section 1.</p>
  </div>
  <div data-role="collapsible">
    <h3>Section 3</h3>
    <p>Third section.</p>
  </div>
</div>

Заранее раскрытый и врезной

В collapsibleset задайте data-collapsed=false той секции, которая должна быть открыта изначально. data-inset=true (по умолчанию для наборов) даёт группе скруглённые углы и отступы. Наборы от края до края используют data-inset=false для полной ширины.

jquery-mobile
<!-- A set always starts with one open by default; control with data-collapsed -->
<div data-role="collapsibleset" data-inset="true">
  <div data-role="collapsible" data-collapsed="false">
    <h3>Open first</h3>
    <p>Content</p>
  </div>
  <div data-role="collapsible">
    <h3>Closed second</h3>
    <p>Content</p>
  </div>
</div>

Collapsible со списком

Collapsible может содержать любой виджет, включая список. Это отличный паттерн для группировки длинного списка под сворачиваемой шапкой. Добавьте data-filter=true к collapsible, чтобы фильтровать элементы внутреннего списка через поле поиска в области шапки.

jquery-mobile
<div data-role="collapsible" data-filter="true">
  <h3>Contacts</h3>
  <ul data-role="listview">
    <li><a href="#">Alice</a></li>
    <li><a href="#">Bob</a></li>
    <li><a href="#">Carol</a></li>
  </ul>
</div>

Программное раскрытие и сворачивание

Управляйте collapsible из кода через .collapsible('expand') и .collapsible('collapse'). Слушайте события 'collapse' и 'expand', чтобы реагировать на переключение пользователем. В наборе программное раскрытие одной секции автоматически сворачивает остальные.

jquery-mobile
<div data-role="collapsible" id="c">
  <h3>Section</h3>
  <p>Content</p>
</div>

<script>
// Expand or collapse from code
$("#c").collapsible("expand");
$("#c").collapsible("collapse");
// Toggle based on current state
$("#c h3").click(); // simplest manual toggle
</script>
15

Вкладки

Базовые вкладки

Виджет вкладок — div с data-role=tabs, содержащий панель навигации (ссылки вкладок) и панели содержимого, чьи id совпадают с href ссылок. Сначала показывается ссылка с ui-btn-active. Клик по вкладке показывает её панель и скрывает остальные — без перехода страницы.

jquery-mobile
<div data-role="tabs" id="myTabs">
  <div data-role="navbar">
    <ul>
      <li><a href="#tab1" class="ui-btn-active">One</a></li>
      <li><a href="#tab2">Two</a></li>
      <li><a href="#tab3">Three</a></li>
    </ul>
  </div>
  <div id="tab1" class="ui-body-d ui-content">Content 1</div>
  <div id="tab2" class="ui-body-d ui-content">Content 2</div>
  <div id="tab3" class="ui-body-d ui-content">Content 3</div>
</div>

Вкладки с иконками

Добавьте классы ui-icon-{name} и ui-btn-icon-top к ссылкам вкладок, чтобы показать иконки над подписями, как в таббаре приложения. Активная вкладка сохраняет ui-btn-active. Используйте ui-btn-icon-top, чтобы иконка стояла над текстом в полосе вкладок.

jquery-mobile
<div data-role="tabs">
  <div data-role="navbar">
    <ul>
      <li><a href="#t1" class="ui-btn-active ui-icon-home ui-btn-icon-top">Home</a></li>
      <li><a href="#t2" class="ui-icon-search ui-btn-icon-top">Search</a></li>
      <li><a href="#t3" class="ui-icon-gear ui-btn-icon-top">Settings</a></li>
    </ul>
  </div>
  <div id="t1" class="ui-content">Home tab</div>
  <div id="t2" class="ui-content">Search tab</div>
  <div id="t3" class="ui-content">Settings tab</div>
</div>

AJAX-вкладки

Когда href ссылки вкладки — URL (а не #id), виджет вкладок при активации загружает эту страницу через AJAX в контейнер. Первая вкладка загружается автоматически при инициализации страницы. Это удобно для ленивой загрузки тяжёлого содержимого по вкладкам.

jquery-mobile
<div data-role="tabs">
  <div data-role="navbar">
    <ul>
      <li><a href="ajax-tab1.html" class="ui-btn-active">One</a></li>
      <li><a href="ajax-tab2.html">Two</a></li>
    </ul>
  </div>
  <!-- The first tab's content is loaded into this container -->
  <div class="ui-content" id="ajax-content"></div>
</div>

Сохранение вкладки

Вкладки по умолчанию не запоминают активное состояние между перезагрузками. Используйте событие tabsactivate (даёт ui.newPanel/ui.oldPanel) вместе с localStorage, чтобы сохранить выбор. При загрузке повторно вызовите клик сохранённой вкладки, чтобы восстановить её.

jquery-mobile
<div data-role="tabs" id="t">
  <div data-role="navbar">
    <ul>
      <li><a href="#a" class="ui-btn-active">A</a></li>
      <li><a href="#b">B</a></li>
    </ul>
  </div>
  <div id="a" class="ui-content">A</div>
  <div id="b" class="ui-content">B</div>
</div>

<script>
// Remember the active tab across reloads
var saved = localStorage.getItem("activeTab") || "#a";
$("#t a[href='" + saved + "']").click();
$("#t").on("tabsactivate", function (e, ui) {
  localStorage.setItem("activeTab", "#" + ui.newPanel.attr("id"));
});
</script>

События вкладок

tabsbeforeactivate срабатывает до переключения (верните false, чтобы отменить); tabsactivate — после. Оба дают ui.newTab/ui.oldTab (ссылки <a>) и ui.newPanel/ui.oldPanel (div содержимого). Используйте их для ленивой загрузки содержимого, аналитики или валидации перед переключением.

jquery-mobile
<div data-role="tabs" id="t">...</div>

<script>
$("#t").on("tabsbeforeactivate", function (e, ui) {
  // ui.newTab, ui.oldTab, ui.newPanel, ui.oldPanel
  // return false to cancel the switch
  console.log("Switching to", ui.newPanel.attr("id"));
});
$("#t").on("tabsactivate", function (e, ui) {
  console.log("Now showing", ui.newPanel.attr("id"));
});
</script>
16

Темы

Цветовые схемы (a-e)

Темизация jQuery Mobile использует буквенные «схемы» (a-e), а не один цвет. a — максимальный контраст (тёмная), по умолчанию для header/footer; b — синий акцент; c — светлый фон страницы по умолчанию. Применяйте схему через data-theme на любом элементе.

jquery-mobile
<!-- jQuery Mobile ships with 5 swatches: a, b, c, d, e -->
<!-- a = black (high contrast), b = blue, c = light gray,
     d = medium gray, e = yellow -->

<div data-role="page" data-theme="b">
  <div data-role="header" data-theme="a"><h1>Dark header</h1></div>
  <div data-role="main" class="ui-content">Page body</div>
  <div data-role="footer" data-theme="a"><h4>Dark footer</h4></div>
</div>

Применение тем

Для кнопок используйте класс ui-btn-{swatch} (например, ui-btn-b для синей кнопки). Для остальных элементов — data-theme={swatch}. Дочерний элемент наследует схему родителя, если не задать свою. Схема страницы по умолчанию — 'c' (светло-серая).

jquery-mobile
<!-- Per element -->
<a href="#" class="ui-btn ui-btn-a">Swatch A button</a>
<a href="#" class="ui-btn ui-btn-b">Swatch B button</a>

<!-- On bars, lists, forms -->
<div data-role="header" data-theme="b">...</div>
<ul data-role="listview" data-theme="c">...</ul>
<input type="text" data-theme="b">

Тема подложки

data-overlay-theme задаёт цвет затемнённой подложки за popup, диалогом или своим меню select. Используйте тёмную схему (a или b) для подложки, чтобы содержимое на переднем плане выделялось. Собственный data-theme popup управляет цветом его окна.

jquery-mobile
<!-- Overlay theme for popups, dialogs, custom selects -->
<div data-role="popup" id="p" data-overlay-theme="b" data-theme="a"
     class="ui-content">
  <p>Dark backdrop, light popup.</p>
</div>

<a href="#p" data-rel="popup" data-transition="pop" class="ui-btn">Open</a>

Темы списков и кнопок

Списки принимают отдельные темы: data-theme для строк, data-divider-theme для заголовков-разделителей и data-count-theme для счётчиков. Так можно выделять разделители, оставляя строки сдержанными. Такая же тонкая темизация доступна для кнопок и форм.

jquery-mobile
<ul data-role="listview" data-theme="d" data-divider-theme="b"
    data-count-theme="b" data-inset="true">
  <li data-role="list-divider">Group (swatch b)</li>
  <li><a href="#">Item (swatch d) <span class="ui-li-count">5</span></a></li>
</ul>

Свои схемы

Каждая схема — это просто набор CSS-классов (.ui-bar-{x}, .ui-body-{x}, .ui-btn-up-{x} и т. д.). Чтобы добавить свою схему 'f', скопируйте эти правила и перекрасьте их — или используйте ThemeRoller для генерации полного файла темы. Затем ссылайтесь на неё через data-theme=f.

jquery-mobile
/* Add a custom swatch 'f' by copying the .ui-bar-f, .ui-body-f,
   .ui-btn-up-f, .ui-btn-hover-f, .ui-btn-down-f rules and changing
   the colors. ThemeRoller generates these for you. */
.ui-bar-f { background: #6c2; color: #fff; }
.ui-body-f { background: #efe; color: #030; }
.ui-btn-up-f { background: #6c2; color: #fff; }
.ui-btn-hover-f { background: #5b1; color: #fff; }

<!-- Use it like any built-in swatch -->
<div data-role="header" data-theme="f"><h1>Green header</h1></div>

Наследование темы

Элементы наследуют схему ближайшего предка, если не задают свою. Задайте схему высоко (например, на странице), чтобы единообразно оформить всё внутри, затем переопределяйте отдельные элементы. Глобальную тему страницы по умолчанию можно сменить во время mobileinit.

jquery-mobile
<div data-role="page" data-theme="b">
  <!-- Inherits swatch b unless overridden -->
  <div data-role="main" class="ui-content">
    <a href="#" class="ui-btn">Inherits b</a>
    <a href="#" class="ui-btn ui-btn-a">Explicit a</a>
    <a href="#" class="ui-btn" data-theme="a">Explicit a (attr)</a>
  </div>
</div>

<!-- Global default swatch -->
<script>
$(document).on("mobileinit", function () {
  $.mobile.page.prototype.options.theme = "b";
});
</script>
17

Адаптивная вёрстка

Сетка

Сетки — это CSS-классы, а не виджеты. ui-grid-a делает сетку из 2 колонок, ui-grid-b — из 3, вплоть до ui-grid-d (5 колонок). Дети получают ui-block-a, ui-block-b, ... по порядку и переносятся автоматически. Сетки всегда шириной 100% и сами не реагируют на брейкпоинты.

jquery-mobile
<!-- 2-column grid (ui-grid-a) -->
<div class="ui-grid-a">
  <div class="ui-block-a"><div class="ui-bar">A</div></div>
  <div class="ui-block-b"><div class="ui-bar">B</div></div>
</div>

<!-- 3-column grid (ui-grid-b), 4 = ui-grid-c, 5 = ui-grid-d -->
<div class="ui-grid-b">
  <div class="ui-block-a">A</div>
  <div class="ui-block-b">B</div>
  <div class="ui-block-c">C</div>
</div>

Адаптивные сетки

У сеток jQuery Mobile нет встроенных брейкпоинтов, но можно добавить свой media query: на узких ширинах задать блокам width:100% и float:none, чтобы они шли друг под другом, а на широких экранах оставить колонки по умолчанию. Добавьте класс-маркер, чтобы ограничить правило.

jquery-mobile
<style>
/* Stack grid columns on phones, side-by-side on tablets */
@media (max-width: 40em) {
  .ui-responsive .ui-block-a,
  .ui-responsive .ui-block-b { width: 100%; float: none; }
}
</style>

<div class="ui-grid-a ui-responsive">
  <div class="ui-block-a">Left (stacks on phone)</div>
  <div class="ui-block-b">Right (stacks on phone)</div>
</div>

Таблица reflow

Таблица reflow (data-mode=reflow) на узких экранах перестраивается в стопку карточек, повторяя заголовок каждой колонки как подпись рядом со значением. Добавьте класс ui-responsive, чтобы reflow включался только ниже брейкпоинта, а на широких экранах оставалась обычная таблица.

jquery-mobile
<table data-role="table" data-mode="reflow" class="ui-responsive">
  <thead><tr><th>Name</th><th>Age</th><th>City</th></tr></thead>
  <tbody>
    <tr><td>Alice</td><td>30</td><td>NYC</td></tr>
    <tr><td>Bob</td><td>25</td><td>LA</td></tr>
  </tbody>
</table>

<!-- On narrow screens each cell shows its column header as a label -->

Таблица с переключением колонок

Таблица columntoggle добавляет кнопку «Колонки...», позволяющую пользователю выбрать, какие колонки показывать. Назначайте data-priority=1..6 необязательным колонкам (меньше = важнее, показывается на более широких брейкпоинтах); колонки без приоритета показываются всегда. Самые важные колонки остаются на телефонах, остальные убираются в меню.

jquery-mobile
<table data-role="table" data-mode="columntoggle"
       class="ui-responsive" id="tbl">
  <thead>
    <tr>
      <th data-priority="1">Rank</th>
      <th data-priority="2">Name</th>
      <th>Team</th>           <!-- priority 'persist' (always shown) -->
      <th data-priority="3">Points</th>
      <th data-priority="4">Wins</th>
    </tr>
  </thead>
  <tbody><tr><td>1</td><td>Alice</td><td>Red</td><td>100</td><td>10</td></tr></tbody>
</table>

Брейкпоинты и вспомогательные классы

В jQuery Mobile нет утилитарных классов брейкпоинтов; для своих раскладок вы пишете свои media queries. Встроенный брейкпоинт 40em (640px) управляет только переключением адаптивных таблиц (ui-responsive) между стопкой и табличным режимом. Для сеток и панелей задавайте свои брейкпоинты через запросы в em.

jquery-mobile
<!-- jQuery Mobile doesn't ship breakpoint classes like Bootstrap,
     but you can combine media queries with jQM structure. -->

<style>
@media (min-width: 45em) { /* tablet+ */
  .split { width: 50%; float: left; box-sizing: border-box; padding: 0 .5em; }
}
</style>

<div class="split">Left panel</div>
<div class="split">Right panel</div>

<!-- ui-responsive class triggers table breakpoints at 40em (640px) -->
18

Сенсорные события

tap и taphold

tap срабатывает при быстром касании (быстрее и надёжнее click на мобильных, который ждёт около 300 мс). taphold срабатывает, когда пользователь держит палец около 750 мс. Оба нормализованы для работы с мышью и касанием, поэтому один код работает на десктопе и мобильном.

jquery-mobile
<div id="box" class="ui-bar">Tap or hold me</div>

<script>
$("#box").on("tap", function () {
  $(this).css("background", "yellow");
});
$("#box").on("taphold", function () {
  $(this).css("background", "red");
});
</script>

Свайп и направление

swipe срабатывает при любом горизонтальном свайпе; swipeleft и swiperight сообщают направление — удобно для каруселей и навигации по страницам. Они основаны на горизонтальном движении; вертикальная прокрутка намеренно не считается свайпом, чтобы обычная прокрутка страницы работала.

jquery-mobile
<div id="card" class="ui-bar">Swipe me</div>

<script>
$("#card").on("swipe", function () {
  console.log("Swiped in any direction");
});
$("#card").on("swipeleft", function () {
  $(this).text("Swiped left -> next");
});
$("#card").on("swiperight", function () {
  $(this).text("Swiped right -> prev");
});
</script>

Пороги свайпа

Свайп регистрируется, только если покрывает минимум horizontalDistanceThreshold (по умолчанию 30px) за durationThreshold (по умолчанию 1000 мс) и не превышает verticalDistanceThreshold по вертикали. Увеличьте горизонтальный порог, чтобы требовать более длинные свайпы; уменьшите для большей чувствительности. Задаётся во время mobileinit.

jquery-mobile
<script>
// Globally tune swipe sensitivity (bind before jQM loads)
$(document).on("mobileinit", function () {
  $.event.special.swipe.horizontalDistanceThreshold = 60; // px, default 30
  $.event.special.swipe.durationThreshold = 800;          // ms, default 1000
  $.event.special.swipe.verticalDistanceThreshold = 40;   // px, default 75
});
</script>

<script src="jquery.mobile-1.4.5.min.js"></script>

Виртуальные события мыши

События vmouse* — унифицированные события мыши, касания и указателя в jQuery Mobile: они срабатывают одинаково, использует пользователь палец или мышь. Используйте vclick вместо click, чтобы избежать мобильной задержки 300 мс. Это строительные блоки, на которых построены tap и swipe.

jquery-mobile
<script>
// vmouse events unify mouse + touch + pointer
$("#el").on("vmousedown", function () { /* finger down / mouse down */ });
$("#el").on("vmouseup",   function () { /* finger up / mouse up   */ });
$("#el").on("vmousemove", function () { /* drag                    */ });
$("#el").on("vmouseover", function () { /* hover-in (best-effort)  */ });
$("#el").on("vmouseout",  function () { /* hover-out (best-effort) */ });
$("#el").on("vclick",     function () { /* tap/click unified       */ });
</script>

Смена ориентации

orientationchange срабатывает при повороте устройства, e.orientation равен 'portrait' или 'landscape'. Оборачивайте зависящий от раскладки код в короткий setTimeout, потому что размеры viewport обновляются чуть позже события. Слушайте 'resize' как запасной вариант на устройствах без гироскопа.

jquery-mobile
<script>
$(window).on("orientationchange", function (e) {
  // e.orientation is "portrait" or "landscape"
  console.log("Now " + e.orientation);
});

// React after the rotation finishes (layout is settled)
$(window).on("orientationchange", function (e) {
  setTimeout(function () {
    $("body").removeClass("portrait landscape").addClass(e.orientation);
  }, 300);
});
</script>

Прокрутка и троттлинг

scrollstart и scrollstop — троттленные события прокрутки jQuery Mobile (браузер сам троттлит обработчики scroll, но эти дают ясные моменты начала и конца). Чтобы запретить прокрутку и зум на элементе (например, на canvas для рисования или карте), привяжите touchmove и верните false.

jquery-mobile
<script>
// scrollstart / scrollstop are throttled for performance
$(document).on("scrollstart", function () {
  $("#hint").hide();
});
$(document).on("scrollstop", function () {
  $("#hint").show();
});

// Silence touch scroll on a specific element
$("#canvas").on("touchmove", false);
</script>
19

События страниц и жизненный цикл

События инициализации страницы

pagebeforecreate срабатывает до того, как jQuery Mobile улучшит разметку страницы: лучшее место для вставки классов или виджетов, чтобы они тоже были улучшены. pagecreate срабатывает сразу после улучшения — используйте для привязки обработчиков и инициализации плагинов. Каждое срабатывает один раз на страницу.

jquery-mobile
<div data-role="page" id="home">
  <div data-role="main" class="ui-content">
    <a href="#second" class="ui-btn">Go to second</a>
  </div>
</div>

<script>
$(document).on("pagebeforecreate", "#home", function () {
  // Before enhancement — good place to add classes/widgets
});
$(document).on("pagecreate", "#home", function () {
  // After enhancement, before show — bind widgets here
  console.log("Home page created");
});
</script>

Показ и скрытие страницы

pagebeforeshow/pageshow срабатывают до и после появления страницы; pagebeforehide/pagehide — до и после её скрытия. События 'show' срабатывают каждый раз при показе страницы (не только один), поэтому это правильное место для обновления динамических данных при возврате на страницу.

jquery-mobile
<script>
$(document).on("pagebeforeshow", "#home", function () {
  console.log("About to show home");
});
$(document).on("pageshow", "#home", function () {
  console.log("Home shown (transition done)");
});
$(document).on("pagebeforehide", "#home", function () {
  console.log("About to leave home");
});
$(document).on("pagehide", "#home", function () {
  console.log("Home hidden");
});
</script>

Перед сменой страницы

pagebeforechange срабатывает перед любой навигацией и позволяет её перехватить или перенаправить (вызовите preventDefault для отмены). pagechange срабатывает после успешной навигации; pagechangefailed — если загрузка целевой страницы завершилась ошибкой. Они срабатывают и для внутренних (#id), и для AJAX-переходов.

jquery-mobile
<script>
$(document).on("pagebeforechange", function (e, data) {
  // data.toPage is the target (URL string or jQuery object)
  // data.options has transition, reverse, etc.
  // return false (or e.preventDefault()) to cancel navigation
  if (typeof data.toPage === "string" && data.toPage.indexOf("block") > -1) {
    e.preventDefault();
    alert("Blocked");
  }
});
$(document).on("pagechange", function (e, data) {
  console.log("Navigation completed");
});
$(document).on("pagechangefailed", function (e, data) {
  console.log("Navigation failed");
});
</script>

Загрузка контейнера страницы

pageload срабатывает, когда страница, полученная через AJAX, успешно вставлена в DOM (предоставляются data.url и data.page). pageloadfailed срабатывает при ошибке загрузки: по умолчанию jQM показывает сообщение об ошибке; возврат false из обработчика сообщает, что вы обработали ошибку сами.

jquery-mobile
<script>
// Fires when a page is loaded via AJAX into the DOM
$(document).on("pageload", function (e, data) {
  console.log("Loaded: " + data.url);
  console.log("Page obj:", data.page);
});
$(document).on("pageloadfailed", function (e, data) {
  // return false to let jQM show its default error message
  console.log("Failed to load: " + data.url);
});
</script>

Привязка событий страниц

Привязывайте события страниц делегированием на document, фильтруя по селектору #id страницы, — это работает даже для страниц, подгруженных позже через AJAX. Для программной навигации используйте метод 'change' виджета pagecontainer (современная замена $.mobile.changePage), передавая цель и опции.

jquery-mobile
<script>
// Delegate by page id — works for AJAX-loaded pages too
$(document).on("pagecreate", "#settings", function () {
  var page = $(this);
  page.find("#save").on("tap", function () {
    alert("Saved settings");
  });
});

// Use the pagecontainer widget (1.4+) for programmatic navigation
$(":mobile-pagecontainer").pagecontainer("change", "#settings", {
  transition: "slide",
  reverse: false
});
</script>

Удаление страницы и очистка

По умолчанию jQuery Mobile удаляет страницу из DOM после ухода с неё (если не включён domCache). pageremove срабатывает прямо перед удалением — очищайте здесь интервалы, слушатели и экземпляры плагинов. ui.prevPage в событии pagehide даёт объект jQuery только что скрытой страницы для очистки.

jquery-mobile
<script>
// Fires when a page is removed from the DOM (default behavior for
// non-cached pages after navigation away)
$(document).on("pageremove", function (e, ui) {
  console.log("Page removed from DOM:", ui.prevPage);
});

// Clean up resources when a page is hidden for good
$(document).on("pagehide", "#temp", function () {
  clearInterval($(this).data("timer"));
});
</script>

Was this helpful?

Learning path

Learn from scratch

Learn this language from the ground up with structured lessons.