Einstieg
Seitenstruktur
jQuery Mobile nutzt data-role attribute, um HTML aufzustocken. Eine page ist ein div mit data-role=page, das header, main und footer enthält. Das viewport meta tag ist Pflicht für korrektes Skalieren auf mobilen Geräten. jQuery core vor jquery.mobile.js laden.
<!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>Mehrere Seiten in einem Dokument
Mehrere data-role=page divs lassen sich in einer einzigen HTML-Datei platzieren. Über anchor hrefs (#about) verlinken. jQuery Mobile zeigt jeweils eine page und animiert transitions. Beim ersten Laden erscheint nur die erste page in Quelldatei-Reihenfolge.
<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-Navigation & links
Per default werden links zu internen (#id) und same-origin-Seiten per AJAX geladen und mit einer transition getauscht. data-ajax=false erzwingt einen normalen vollen Seitenaufruf (praktisch für Nicht-jQuery-Mobile-Seiten). data-prefetch lädt das ziel vor, damit die transition sofort ist.
<!-- 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>prefetching & DOM caching
prefetching lädt verlinkte seiten im hintergrund, sodass navigation sich instant anfühlt. Besuchte seiten werden per default aus dem DOM entfernt, aber domCache behält sie für schnelleres zurück-navigieren auf kosten von speicher. Je seite mit data-dom-cache oder global über die page prototype option aktivieren.
<!-- 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>dialog seiten
data-rel=dialog an einen link (oder data-dialog=true an die page) ergänzen, um eine seite als modales dialogfeld mit close button und transition zu öffnen. data-rel=back an einem link schließt und kehrt zur vorigen seite zurück.
<!-- 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>globale konfiguration (mobileinit)
Das mobileinit event feuert nach dem Laden von jQuery core, aber vor der Initialisierung von jQuery Mobile — die konfiguration hier binden, vor dem Einbinden von jquery.mobile.js. Übliche overrides: default transitions, AJAX einstellungen und der text der lade-meldung. autoInitializePage=false erlaubt es zu steuern, wann die erste seite initialisiert.
<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>Seiten-transitions
Grundlegende transitions
data-transition an einen link ergänzen, um die animation beim navigieren zu wählen. transitions beruhen auf CSS (hardware-beschleunigt, wo möglich). 'none' überspringt die animation für instant navigation. Dasselbe attribut wirkt auf dialogs und popups.
<!-- 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>transition typen
jQuery Mobile bringt ein set aus 2D/3D CSS transitions mit. 3D transitions (turn, flow, flip) wirken auf fähigen geräten großartig, fallen aber auf älterer hardware graceful zurück. pop und fade sind am performantesten und für dialogs und popups empfohlen.
<!-- 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 -->richtung & reverse
data-direction=reverse spielt die transition rückwärts — üblich auf zurück-buttons, damit die animation die vorwärts-navigation spiegelt. paart sich mit data-transition; ohne transition wird der default reversiert.
<!-- 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>dialog transitions
dialogs können jede transition nutzen, aber pop und slidedown fühlen sich für modals am natürlichsten. einen globalen default mit $.mobile.defaultDialogTransition während mobileinit setzen. die close-aktion des dialogs reversiert die transition automatisch.
<!-- 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>deaktivieren & fallback
data-transition=none oder den globalen default auf 'none' setzen, um animationen zu deaktivieren — hilfreich auf schwachen geräten oder für barrierefreiheit. jQuery Mobile erkennt 3D transform support automatisch und degradiert 3D transitions (flip, turn, flow) zu einem simplen fade, wenn nicht unterstützt.
<!-- 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 -->toolbars (header & footer)
fixierter header & footer
data-position=fixed ergänzen, um einen header oder footer oben/unten am viewport zu pinnen, während die seite scrollt. ein tap auf die seite togglet die sichtbarkeit der toolbars per default. der seiteninhalt bekommt padding, damit er nicht hinter den toolbars verschwindet.
<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>fullscreen toolbars
data-fullscreen=true legt die fixierten toolbars über den inhalt (halbtransparent), statt platz zu reservieren. ideal für photo viewer oder karten, wo der inhalt den bildschirm füllen soll. die toolbars erscheinen/verschwinden per tap wie fixierte toolbars.
<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>persistente toolbars
haben zwei seiten footers (oder headers) mit derselben data-id und data-position=fixed, persistiert die toolbar über seiten-transitions hinweg, statt mit der seite zu animieren. das standardmuster für eine dauerhafte bottom navigation bar — nur der aktive link wechselt je seite.
<!-- 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>tap toggle verhalten
fixierte toolbars togglet ihre sichtbarkeit, wenn der nutzer auf die seite tippt. data-tap-toggle=false hält eine toolbar immer sichtbar. verwandte optionen je element: data-hide-during-focus (verbergen, wenn inputs fokussiert sind) und data-update-page-padding (seiten-padding bei resize erneut anwenden).
<!-- 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>toolbar theme & buttons
headers können buttons aufnehmen, positioniert über die klassen ui-btn-left / ui-btn-right. data-theme setzt den farb-swatch der leiste. data-iconpos=notext zeigt nur ein icon für kompakten look. buttons in einem header werden automatisch als inline buttons gestylt.
<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>toolbars dynamisch aktualisieren
nach dem Ändern von toolbar markup zur laufzeit $(el).toolbar('refresh') aufrufen, um styling und padding neu anzuwenden. das toolbar widget (eingeführt in 1.4) verwaltet fixe positionierung und tap-toggle; manuell mit $().toolbar() initialisieren, wenn eine toolbar nach dem page create ergänzt wird.
<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>listen-ansichten
einfaches listview
data-role=listview an ein <ul> ergänzen, um es in eine touch-freundliche liste mit volle-breite tappbaren zeilen zu verwandeln. jedes <li> mit einem <a> wird zu einer verlinkten zeile mit rechtem pfeil. data-inset=true rückt die liste mit abgerundeten ecken und margins ein, statt bündig.
<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>inset listen
bündige listen spannen die volle breite (gut für full-screen menüs); inset listen haben abgerundete ecken und umgebende margins (gut für inhaltsabschnitte innerhalb einer seite). data-inset=true für inset listen nutzen, die eher wie gruppierte einstellungs-panels wirken.
<!-- 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>listen-trenner
ein <li> mit data-role=list-divider wird zum nicht klickbaren abschnitts-header. data-autodividers=true fügt automatisch trenner nach dem ersten buchstaben des item-texts ein — perfekt für eine alphabetische kontaktliste.
<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>zähl-bubbles & thumbnails
ein span mit class=ui-li-count innerhalb eines <li> zeigt eine numerische zähl-bubble rechts. ein <img> mit class=ui-li-thumb (typisch 80x80) dient als linkes thumbnail. mit <h3>/<p> kombinieren für reiche, app-artige listen-zeilen.
<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>such-filter
data-filter=true ergänzt ein suchfeld über der liste, das items in echtzeit nach text filtert. data-filter-placeholder passt die aufforderung an. data-filter-reveal=true verbirgt alle items, bis der nutzer tippt — nützlich für autocomplete-artige lookups.
<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 buttons & verschachtelte listen
enthält ein <li> zwei <a> elemente, rendert jQuery Mobile einen split button: die haupt-zeile navigiert zum ersten link, und ein separater icon-button (via data-split-icon) rechts öffnet den zweiten. ein verschachteltes <ul> in einem <li> wird automatisch zu einer drill-down unterseite.
<!-- 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>formular-steuerelemente
formular-struktur & AJAX einreichung
jQuery Mobile stockt formulareingaben automatisch auf und reichert formulare per AJAX ein, zeigt einen lade-spinner und transitioniert zur ergebnis-seite. data-ajax=false für eine traditionelle volle-seiten einreichung (erforderlich für file uploads ohne moderne api).
<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>text inputs & clear button
alle HTML5 input typen (text, email, tel, number, password, date usw.) werden einheitlich gestylt. data-clear-btn=true ergänzt einen clear (x)-button im feld. data-role=none nutzen, um eine steuerung als schlichtes natives input ohne jQuery Mobile styling zu behalten.
<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">feld-container
ein label + steuerung-paar in ein div mit class=ui-field-contain wickeln. auf breiten screens sitzen label und input nebeneinander; auf schmalen phones stapeln sie sich vertikal. dieses responsive verhalten ersetzt das ältere attribut data-role=fieldcontain.
<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>suchfeld
ein <input type=search> wird zu einem suchfeld mit lupen-icon aufgestockt. mit einem listview paaren, indem das input eine id bekommt und der filter des listviews data-input=#id setzt — so lässt sich das suchfeld beliebig auf der seite platzieren.
<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 & versteckte inputs
textareas werden wie andere inputs gestylt und wachsen beim tippen automatisch; data-autogrow=false fixiert die höhe mit scrollbar. versteckte inputs bleiben unberührt. wie alle inputs in ui-field-contain wickeln für responsive labels.
<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">auto-aufstockung deaktivieren
data-role=none an jede steuerung ergänzen, um jQuery Mobile aufstockung zu überspringen und sie nativ zu lassen. als projekt-weite regel keepNative während mobileinit auf einen selektor-string von elementen setzen, die nie aufgestockt werden sollen — nützlich, wenn eigen gestylte steuerungen mit jQM seiten gemischt werden.
<!-- 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>slider
einfacher range slider
ein <input type=range> mit min, max, value und step wird zu einem touch-freundlichen slider mit wert-bubble aufgestockt. das value attribut setzt die anfangsposition. der slider schreibt seinen wert zurück ins input, reichert sich also normal mit dem formular ein.
<label for="volume">Volume</label>
<input type="range" name="volume" id="volume"
value="50" min="0" max="100" step="1">slider mit highlight
data-highlight=true füllt die spur links vom griff mit der aktiven theme farbe und zeigt das aktuelle niveau klar. ohne ist die spur eine einzige flache farbe. nützlich für einstellungen wie lautstärke oder helligkeit.
<label for="brightness">Brightness</label>
<input type="range" id="brightness"
value="70" min="0" max="100"
data-highlight="true">mini slider
data-mini=true rendert einen kleineren, kompakteren slider, der weniger vertikalen platz braucht — praktisch, wenn mehrere steuerungen in einem einstellungs-panel gruppiert werden. verhält sich identisch zum normalen slider, nur verkleinert.
<label for="age">Age</label>
<input type="range" id="age" value="25" min="0" max="120"
data-mini="true" data-highlight="true">step & mehrere slider
step steuert die schrittweite (z. b. step=5 rastet auf 0, 5, 10, ...). jedes range input ist ein unabhängiger slider; für einen zweigriff-range muss man ein eigenes widget bauen oder ein drittanbieter-plugin nutzen. die nativen attribute value, min, max treiben das verhalten.
<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">slider events
der slider emittiert slidestart, wenn der nutzer den griff zu ziehen beginnt, und slidestop, wenn das ziehen endet. für kontinuierliche updates während des ziehens an das native 'input' oder 'change' event des zugrunde liegenden range inputs binden. den wert mit $(el).val() lesen/schreiben.
<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>flip toggle schalter
einfacher flip toggle
ein flip switch ist ein <select> mit exakt zwei <option> elementen und data-role=slider. er rendert als iOS-artiger an/aus-schalter. die gewählte option bestimmt den anfangszustand, und der wert reichert sich wie ein normales select ein (der wert der gewählten option).
<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>eigene labels
der text der beiden optionen wird zu den labels auf beiden seiten des schalters. beliebiger kurzer text ist möglich (an/aus, ja/nein, aktiviert/deaktiviert). labels kurz halten, damit sie im toggle ohne abschneiden auf kleinen screens passen.
<label for="wifi">Wi-Fi</label>
<select id="wifi" data-role="slider">
<option value="disabled">Disabled</option>
<option value="enabled" selected>Enabled</option>
</select>mini flip switch
data-mini=true rendert einen kleineren flip switch mit weniger vertikalem platz, passend zu mini slidern und anderen mini steuerungen. mini steuerungen gemeinsam in dichten einstellungs-panels paaren für einen konsistent kompakten look.
<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 theme
data-theme legt die farbe des schaltergriffs fest, data-track-theme die farbe der spur dahinter. swatches zu mischen (etwa ein dunkler griff auf heller spur) lässt den aktiven zustand visuell klarer hervortreten.
<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>programmatisches togglen
den wert mit $(el).val(value) setzen, dann .slider('refresh') aufrufen, um den visuellen schalter anzupassen. den aktuellen zustand mit .val() lesen. nach programmatischer wert-änderung am zugrunde liegenden select immer refresh, sonst bewegt sich der griff nicht.
<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>checkboxes & radios
checkboxes
eine checkbox ist ein normales <input type=checkbox>, umwickelt von (oder benachbart zu) einem <label for=id>. jQuery Mobile stylt das label als tappbaren block. umwickelt das label das input, ist das for attribut optional. der angekreuzte zustand reichert sich wie üblich mit dem formular an.
<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 buttons
radios über dasselbe name attribut gruppieren. die gruppe in ein fieldset mit data-role=controlgroup wickeln (und ein <legend>), um sie visuell mit geteilten ecken zu clustern. nur ein radio einer gleichnamigen gruppe kann gleichzeitig angekreuzt sein.
<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>horizontale controlgroups
data-type=horizontal ordnet checkboxes oder radios in einer einzigen reihe als segmentierte steuerung an statt vertikal zu stapeln. kompakt und gut für kurze labels (S/M/L, ja/nein). labels kurz halten, damit sie auf schmalen screens passen.
<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>mini & theme
data-mini=true verkleinert die steuerungen, und data-theme legt den swatch fest, der bei angekreuztem/aktivem item greift. den aktiven zustand themen, damit er sich vom seitenhintergrund abhebt. diese optionen wirken auf die ganze controlgroup gleichzeitig.
<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>refresh nach änderung
nachdem code die checked eigenschaft einer checkbox/radio gesetzt hat, .checkboxradio('refresh') aufrufen, damit die aufgestockte ansicht passt. ergänzt oder entfernt man inputs innerhalb einer controlgroup zur laufzeit, .controlgroup('refresh') aufrufen, um das gruppen-styling neu anzuwenden.
<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>popups
einfaches popup
ein popup ist ein div mit data-role=popup. geöffnet wird es, indem man mit data-rel=popup auf seine id verlinkt. das popup legt sich per default zentriert über die seite. ui-content für padding ergänzen und data-rel=back an einem link innerhalb nutzen, um es zu schließen.
<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 transitions
data-transition am öffnenden link (oder am popup selbst) nutzen, um die animation zu wählen. pop und fade sind für popups am natürlichsten. dasselbe transition set wie für seiten gilt hier; die close-aktion reversiert die transition automatisch.
<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 positionierung
data-position-to steuert, wo das popup erscheint: 'origin' (das öffnende element, default), '#someId' (ein konkretes element) oder 'window' (bildschirmzentriert). beim programmatischen öffnen mit popup('open', x, y) sind auch x/y koordinaten möglich.
<!-- 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 menü & tooltip
ein popup kann beliebigen inhalt enthalten — ein listview wird zum kontext menü, ein absatz zum tooltip. das popup mit data-theme stylen und den inneren inhalt mit eigenem theme. popups schließen automatisch, wenn der nutzer außerhalb tippt (außer data-dismissible=false).
<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>dialog popup
ein popup, zentriert am fenster mit close button, wirkt als modales dialogfeld. einen x-button ergänzen (ui-icon-delete mit ui-btn-icon-notext) in der ecke. die breite über einen max-width stil begrenzen für einen echten dialog look statt eines full-width sheets.
<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>programmatisches öffnen & dismissible
ein popup aus code mit .popup('open'/'close') öffnen oder schließen. data-dismissible=false verhindert schließen per tap außerhalb und zwingt zur nutzung eines close buttons — ideal für erforderliche bestätigungen. beim öffnen sind x/y koordinaten oder ein position objekt möglich.
<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>panels
einfaches panel
ein panel ist ein div mit data-role=panel, innerhalb einer seite platziert (meist vor dem header). geöffnet wird es per verlinkung seiner id mit einem button. data-rel=close an einem link innerhalb nutzen, um das panel zu schließen. panels sind perfekt für einschiebende navigations-menüs.
<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>panel anzeige-modi
data-display steuert die öffnungs-animation: 'reveal' (default) schiebt die seite weg und legt das panel darunter frei; 'overlay' schiebt das panel über die seite; 'push' bewegt panel und seite gemeinsam. overlay ist bei menüs am häufigsten.
<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 -->panel position
data-position=left (default) oder right legt fest, von welcher seite das panel einschiebt. ein linkes und ein rechtes panel gleichzeitig sind möglich. nur ein panel kann gleichzeitig offen sein; das öffnen eines zweiten schließt das erste.
<!-- 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>dismissible & swipe
data-dismissible=true (default) schließt das panel, wenn der nutzer außerhalb tippt. data-swipe-close=true erlaubt das schließen durch swipe in die gegenrichtung (z. b. swipe rechts schließt ein linkes panel). beide sind bei overlay panels per default aktiv.
<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>panel events
panels feuern panelbeforeopen, panelopen, panelbeforeclose und panelclose. false aus einem 'before'-handler zurückgegeben bricht die aktion ab — nützlich, um vor dem schließen zu bestätigen. aus code mit .panel('open'/'close') öffnen/schließen.
<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>collapsibles
einfaches collapsible
ein div mit data-role=collapsible umwickelt eine überschrift (h1-h6) als klickbaren header und den rest als ausklappbaren inhalt. es startet per default zusammengeklappt. ein klick auf den header togglest den inhalt mit einem +/- icon auf und zu.
<div data-role="collapsible">
<h3>Section title</h3>
<p>Hidden content shown when expanded.</p>
<p>Click the header to toggle.</p>
</div>collapsible icons & theme
den indikator über data-collapsed-icon und data-expanded-icon anpassen (default plus/minus). data-theme stylt den header; data-content-theme den ausgeklappten inhaltsbereich. data-collapsed=false lässt den abschnitt ausgeklappt statt zusammengeklappt starten.
<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 set (accordion)
ein collapsibleset gruppiert collapsibles, sodass nur eines gleichzeitig offen ist — ein accordion. das öffnen eines schließt die anderen automatisch. (in 1.4 heißt das attribut data-role=collapsibleset; der ältere name collapsible-set funktioniert weiterhin.) das ganze set teilt ein einheitliches theme.
<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>vorausgeklappt & inset
in einem collapsibleset data-collapsed=false an dem abschnitt setzen, der anfangs offen sein soll. data-inset=true (default bei sets) gibt der gruppe abgerundete ecken und margins. bündige sets nutzen data-inset=false und spannen die volle breite.
<!-- 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 mit listview
ein collapsible kann jedes widget enthalten, auch ein listview. ein gutes muster, um eine lange liste unter einem zusammenklappbaren header zu gruppieren. data-filter=true am collapsible ergänzen, um die items des inneren listviews über ein suchfeld im header-bereich zu filtern.
<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>programmatisch auf-/zuklappen
ein collapsible aus code mit .collapsible('expand') und .collapsible('collapse') steuern. auf die 'collapse' und 'expand' events lauschen, um auf nutzer-toggles zu reagieren. in einem set kollabiert das programmatische ausklappen eines abschnitts die anderen automatisch.
<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>tabs
einfache tabs
ein tabs widget ist ein div mit data-role=tabs, das eine navbar (die tab links) und inhalts-panels enthält, deren ids den link hrefs entsprechen. der link mit ui-btn-active wird zuerst gezeigt. ein klick auf einen tab zeigt sein panel und verbirgt die anderen — ohne seiten-transition.
<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>tabs mit icons
die klassen ui-icon-{name} und ui-btn-icon-top an die tab links ergänzen, um icons über den labels zu zeigen — eine app-artige tab bar. der aktive tab behält ui-btn-active. ui-btn-icon-top nutzen, damit das icon über dem text in der tab leiste sitzt.
<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 tabs
ist der href eines tab links eine URL (nicht #id), lädt das tabs widget diese seite bei aktivierung per AJAX in den container. der erste tab lädt automatisch bei der seiten-initialisierung. nützlich, um schweren inhalt je tab nachzuladen.
<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>tabs persistenz
tabs merken sich ihren aktiven zustand über reloads hinweg nicht per default. das tabsactivate event (liefert ui.newPanel/ui.oldPanel) plus localStorage nutzen, um die auswahl zu persistieren. beim laden den klick des gespeicherten tabs erneut auslösen, um ihn wiederherzustellen.
<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>tab events
tabsbeforeactivate feuert vor einem tab wechsel (false zurückgeben bricht ab); tabsactivate danach. beide liefern ui.newTab/ui.oldTab (die <a> links) und ui.newPanel/ui.oldPanel (die inhalts-divs). nutzen, um inhalt nachzuladen, analytics zu loggen oder vor dem wechsel zu validieren.
<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>theming
theme swatches (a-e)
jQuery Mobile theming nutzt buchstaben-'swatches' (a-e) statt einer farbe. a ist am kontrastreichsten (dunkel) und der default für headers/footers; b ist ein blauer akzent; c ist der helle default seitenhintergrund. ein swatch wird über data-theme an jedem element angewandt.
<!-- 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>themes anwenden
für buttons die klasse ui-btn-{swatch} nutzen (z. b. ui-btn-b für einen blauen button). für andere elemente data-theme={swatch}. ein kind erbt den swatch seines parents, solange keiner explizit gesetzt ist. der default seiten-swatch ist 'c' (hellgrau).
<!-- 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">overlay theme
data-overlay-theme legt die farbe des abgedunkelten hintergrunds hinter einem popup, dialog oder eigenen select menü fest. für das overlay einen dunklen swatch (a oder b) nutzen, damit der vordergrund-inhalt hervorsticht. das data-theme des popups selbst steuert die farbe der popup-box.
<!-- 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>listen- & button-themes
listviews akzeptieren getrennte themes: data-theme für zeilen, data-divider-theme für die trenner-header und data-count-theme für die zähl-bubbles. so lassen sich trenner hervorheben, während zeilen dezent bleiben. dieselbe feingranulare theming-gilt für buttons und formulare.
<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>eigene swatches
jeder swatch ist nur eine menge CSS klassen (.ui-bar-{x}, .ui-body-{x}, .ui-btn-up-{x} usw.). um einen eigenen swatch 'f' zu ergänzen diese regeln kopieren und umfärben — oder das ThemeRoller tool nutzen, um eine komplette eigene theme datei zu erzeugen. dann mit data-theme=f referenzieren.
/* 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>theme vererbung
elemente erben den swatch des nächsten vorfahren, wenn sie keinen eigenen setzen. einen swatch hoch oben setzen (etwa an der seite), um alles darin konsistent zu themen, und einzelne elemente bei bedarf übersteuern. das globale default seiten-theme während mobileinit ändern.
<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>responsives layout
grid layout
grids sind CSS klassen, keine widgets. ui-grid-a macht ein 2-spaltiges grid, ui-grid-b 3 spalten, bis ui-grid-d (5 spalten). kinder bekommen der reihe nach ui-block-a, ui-block-b, ... und umbrechen automatisch. grids sind immer 100% breit und reagieren nicht selbst auf breakpoints.
<!-- 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>responsive grids
jQuery Mobile grids haben keine eingebauten breakpoints, aber eine eigene media query ist möglich: bei schmalen breiten die blöcke auf width:100% und float:none setzen, sodass sie vertikal stapeln, und auf breiteren screens die default spalten gelten lassen. eine marker-klasse ergänzen, um die regel zu scopen.
<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 tabelle
eine reflow tabelle (data-mode=reflow) ordnet sich auf schmalen screens zu einem gestapelten karten-layout um und wiederholt jeden spalten-header als label neben seinem wert. die klasse ui-responsive ergänzen, damit das reflow nur unterhalb des breakpoints greift und breite screens eine normale tabelle sehen.
<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 -->column toggle tabelle
eine columntoggle tabelle ergänzt einen 'spalten...'-button, über den nutzer wählen, welche spalten gezeigt werden. optionalen spalten data-priority=1..6 zuweisen (niedriger = wichtiger, erscheint bei breiteren breakpoints); spalten ohne priorität zeigen immer. die wichtigsten spalten bleiben auf phones; der rest wandert ins menü.
<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>breakpoints & helfer-klassen
jQuery Mobile hat keine utility breakpoint klassen; eigene media queries für eigene layouts schreiben. der eingebaute 40em (640px)-breakpoint steuert nur, wann responsive tabellen (ui-responsive) zwischen gestapelt und tabellarisch wechseln. für grids und panels eigene breakpoints mit em-basierten queries definieren.
<!-- 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) -->touch events
tap & taphold
tap feuert bei kurzer berührung (schneller und zuverlässiger als click auf mobile, das ~300ms wartet). taphold feuert, wenn der nutzer den finger ~750ms hält. beide sind auf maus und touch normalisiert, derselbe code läuft also auf desktop und 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 & swipe richtung
swipe feuert bei jedem horizontalen swipe; swipeleft und swiperight verraten die richtung — praktisch für bild-carousels oder seiten-navigation. sie beruhen auf horizontaler bewegung; vertikales scrollen gilt bewusst nicht als swipe, damit normales seitenscrollen weiterhin funktioniert.
<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>swipe schwellen
ein swipe zählt nur, wenn er innerhalb von durationThreshold (default 1000ms) mindestens horizontalDistanceThreshold (default 30px) abdeckt und vertikal unter verticalDistanceThreshold bleibt. den horizontalen schwellwert erhöhen für längere swipes; senken für ein empfindlicheres gefühl. diese während mobileinit setzen.
<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>virtuelle maus-events
vmouse* events sind jQuery Mobiles vereinheitlichte maus/touch/pointer events — sie feuern konsistent, ob finger oder maus. vclick statt click nutzen, um die 300ms-verzögerung auf mobile zu vermeiden. sie sind die bausteine, auf denen tap und swipe aufbauen.
<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>orientation change
orientationchange feuert bei gerätedrehung, mit e.orientation gleich 'portrait' oder 'landscape'. layoutabhängigen code in ein kurzes setTimeout wickeln, weil die viewport-maße sich leicht nach dem event aktualisieren. das 'resize' event als fallback auf geräten ohne gyroskop lauschen.
<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>scroll & drosselung
scrollstart und scrollstop sind jQuery Mobiles gedrosselte scroll events (der browser drosselt scroll handler nativ, aber diese liefern klare start/stop-momente). um scrollen/zoomen an einem element zu verhindern — etwa einem zeichen-canvas oder einer karte — touchmove binden und false zurückgeben.
<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>seiten-events & lebenszyklus
seiten-initialisierung events
pagebeforecreate feuert, bevor jQuery Mobile das markup der seite aufstockt — der beste ort, um klassen oder widgets zu injizieren, damit sie ebenfalls aufgestockt werden. pagecreate feuert direkt nach abgeschlossenem aufstocken — damit event handler binden und plugins initialisieren. beide feuern je seite einmal.
<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>seiten zeigen & verbergen
pagebeforeshow/pageshow feuern vor/nachdem eine seite sichtbar wird; pagebeforehide/pagehide vor/nach dem verbergen. 'show' events feuern bei jeder anzeige der seite (nicht nur einmal) — der richtige ort, um dynamische daten bei rückkehr zu einer seite zu frischen.
<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>page before change
pagebeforechange feuert vor jeder navigation und ist der ort, sie abzufangen oder umzuleiten (preventDefault aufrufen bricht ab). pagechange feuert nach erfolgreicher navigation; pagechangefailed, wenn das laden der ziel-seite fehlschlug. beide feuern für interne (#id) und AJAX navigationen.
<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>page container load
pageload feuert, wenn eine per AJAX geladene seite erfolgreich ins DOM eingefügt wurde (data.url und data.page werden geliefert). pageloadfailed feuert bei ladefehler — per default zeigt jQM eine fehlermeldung; false aus einem handler zurückgegeben sagt jQM, dass man es selbst behandelt hat.
<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>an seiten-events binden
seiten-events mit event delegation am document binden, gefiltert nach dem #id selektor der seite — das funktioniert auch für seiten, die später per AJAX hereinkommen. für programmatische navigation die 'change'-methode des pagecontainer widgets nutzen (der moderne ersatz für $.mobile.changePage), mit ziel und optionen.
<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>seiten-entfernung & aufräumen
per default entfernt jQuery Mobile eine seite aus dem DOM, sobald man sich von ihr wegbewegt (außer domCache ist an). pageremove feuert unmittelbar vor der entfernung — hier intervall-timer, listener oder plugin-instanzen aufräumen. das ui.prevPage des pagehide events liefert das jquery objekt der gerade verborgenen seite für den abbau.
<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>Verwandte jQuery Mobile-Snippets
Copy-paste ready code for common tasks.
Page Structure
Multi-page template with header, content, and footer roles.
Page Transitions
Apply slide, pop, flip, and fade transitions between pages.
Toolbars
Fixed header and footer bars with fullscreen tap-to-toggle mode.
Navbars
Persistent icon-based navigation bars in the footer.
Listviews
Filterable, grouped lists with thumbnails, icons, and count bubbles.
Forms
Enhanced inputs including sliders, switches, and grouped controls.
Buttons
Themed, iconified, and grouped buttons from links and inputs.
Popup
Modal popups, dialogs, and tooltips with positioning control.
Was this helpful?