jQuery Mobile Kompakt - das Kompendium - über 150 Seiten (typovision)

JQUERY MOBILE
Kompakt

16.05.2012

Patrick Lobacher (GF typovision GmbH)

(c) 2012 - typovision GmbH | jQuery Mobile Kompakt | Patrick Lobacher | www.typovision.de | 16.05.2012 1

EINFÜHRUNG
in jQuery Mobile


DAS MOBILE WEB - MYTHEN

• Es gibt kein mobiles Web - es gibt nur das Web ansich?!

• Man benötigt keine spezielle Anpassung für das mobile Web?!

• Eine Website sollte auf allen Zugangsgeräten funktionieren?!

• Um eine mobile Website zu erstellen, genügt es mit einer Breite von
240px zu arbeiten?!

• => Neue Herausforderungen im mobilen Bereich


MOBILE LÖSUNGEN

Mobile Framework
Kompatible Website Optimierte Website

(Web-Technologie, optimiert für
(Keine Anpassung) (Viewport, BuildIn, ...)
alle Zugangsgeräte)

Web App
Hybride App Native App

(speziell optimierte Applikation
(Web-Technologie eingebettet (eigener Code für alle
bestehend aus Web-
in nativem Rahmengerüst) Plattformen)
Technologie)


MOBILE FRAMEWORKS


WAS IST JQUERY MOBILE

• Was ist jQuery Mobile?

• jQuery Mobile: Berührungsoptimiertes Web Framework für
Smartphones & Tablets

• A uniﬁed, HTML5-based user interface system for all popular
mobile device platforms, built on the rock-solid jQuery and
jQuery UI foundation. Its lightweight code is built with
progressive enhancement, and has a ﬂexible, easily themeable
design.

• progressive enhancement <=> graceful degradation
Progressive Verbesserung <=> würdevolle Herabstufung


JQUERY MOBILE - PROGRESSIVE

• Progressive Enhancement?

• Basis-Inhalte sind von allen Browsern zugänglich

• Basis-Funktionalitäten sind von allen Browsern zugänglich

• Der Inhalt wird in semantischem Markup abgebildet

• Erweitertes Layout wird über extern verlinkte CSS-Dateien zur
Verfügung gestellt

• Erweiterte Funktionen werden über extern verlinkte,
„unaufdringliche“ JS-Dateien realisiert


WAS IST JQUERY MOBILE NICHT

• Was ist jQuery Mobile NICHT?
• jQuery Mobile ist keine jQuery-Alternative für mobile Browser
• Um jQuery Mobile zu benutzen, muss das jQuery Framework eingebunden
werden. Es ist kein Ersatz, sondern ein UI-Layer auf Basis von jQuery
• jQuery Mobile ist kein Webapp-SDK
• Man kann damit natürlich komplette Web-Apps erstellen - die allerdings
erst mit Hybrid-Frameworks wie PhoneGap „nativ“ werden
• jQuery Mobile ist kein Framework für JavaScript Liebhaber
• Ausser für erweiterte Themen, wird kein JavaScript benötigt
• jQuery Mobile ist NICHT die Lösung für ALLE mobile Applikationen,
Websites oder Spiele
• Aber für die meisten :-)


JQUERY MOBILE GESCHICHTE

• Erfunden 2010 vom Team rund um Jon Resig ( jQuery Team)

• John Resig, JavaScript Tool Entwickler für die Mozilla Corporation
(@jeresig auf Twitter)

• Dual Lizenz: GPL oder MIT

• jquerymobile.com

• Aktuelle Version: 1.1.0 (13.04.2012)

• Größe: 19 KB (130 KB)

• (Größe jQuery: 32 KB / 247 KB - Gesamt: 51 KB / 377 KB)

JQUERY MOBILE FEATURE

• jQuery Mobile Feature List

• Cross platform, cross device, and cross browser
• UI optimized for touch devices
• Themeable and customizable design
• Usage of nonintrusive semantic HTML5 code only, without the need of any
Java-Script, CSS, or API knowledge
• AJAX calls automatically to load dynamic content
• Built on the well-known and supported jQuery core
• Lightweight size, 12Kb compressed
• Progressive enhancement
• Accessibility support (http://www.w3.org/TR/wai-aria/)


JQUERY MOBILE KOMPATIBILITÄT


HTML5

• jQuery Mobile verwendet einige der HTML5/CSS3-Features direkt
und kann mit folgenden gut integriert werden:

• Ofﬂine access
• Ofﬂine storage
• Web sockets
• Geolocation access
• Accelerometer and gyroscope support
• Animations
• 2D and 3D transformations
• Gradients and visual effects
• Viewport management (for zooming support inside the browser)
• Webapp installation metadata
• Integration with native applications
• Multimedia support
• Graphic drawing (vector and bitmap)


EMULATOREN

• http://www.mobilexweb.com/emulators

• z.B. Android: http://developer.android.com/sdk/index.html

• Download

• Start der Datei „android“
im Verzeichnis „tools“

• Download der Updates

• Tools > Manage AVDs

• NIE ohne Endgerät oder Emulator testen!!

GETTING STARTED
Jetzt geht‘s los :-)


JQUERY MOBILE EINBINDEN

• Download von http://jquerymobile.com/download/
<link rel="stylesheet" href="http://code.jquery.com/mobile/
1.1.0/jquery.mobile-1.1.0.min.css" />
<script src="http://code.jquery.com/jquery-1.6.4.min.js"></
script>
<script src="http://code.jquery.com/mobile/1.1.0/
jquery.mobile-1.1.0.min.js"></script>

• Einbindung von LATEST (nur zu Testzwecken):
<link href="http://code.jquery.com/mobile/latest/
jquery.mobile.min.css" rel="stylesheet" type="text/css" />
<script src="http://code.jquery.com/jquery-latest.pack.js"></
script>
<script src="http://code.jquery.com/mobile/latest/
jquery.mobile.min.js"></script>


HTML5-GRUNDGERÜST
• Basis HTML

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>Titel</title>
<link rel="stylesheet" href="http://code.jquery.com/mobile/
1.0/jquery.mobile-1.0.min.css" />
<script src="http://code.jquery.com/jquery-1.6.4.min.js"></
script>
<script type="text/javascript" src="http://code.jquery.com/
mobile/1.0/jquery.mobile-1.0.min.js"></script>
<meta name="viewport" content="width=device-width; initial-
scale=1;">
</head>
<body>

</body>
</html>


META-DATEN
• Angaben für den Viewport
<meta name="viewport" content="width=device-width; initial-
scale=1.0; maximum-scale=1.0; user-scalable=0;"/>

width = Wert in Pixel oder device-width
initial-scale = Wert der initialen Skalieren (1.0 für normal)
maximum-scale = Wert für die maximal mögliche Skalierung
minimum-scale = Wert für die minimal mögliche Skalierung
user-scalable = Angabe, ob der User überhaupt skalieren darf

• Angaben zum Fullscreen-Modus
<meta name="apple-mobile-web-app-capable" content="yes" />
Fullscreen Modus - kein Bottom-Controls und kein URL-Feld mehr - kann per JS über
window.navigator.standalone abgefragt werden
<meta name="apple-mobile-web-app-status-bar-style"
content="black" />
Farbe der Status-Leiste oben - diese kann nicht ausgeblendet werden


WEBCLIPS ICON
• Für alle Icon-Größen und/oder Devices müssen eigene Angaben
gemacht werden:
<link rel="icon" href="icons/icon32.png">
<link rel="shortcut icon" href="icons/icon32.png">
<link rel="apple-touch-icon" href="icons/icon57.png" sizes="57x57">
<link rel="apple-touch-icon" sizes="80x80" href="icons/icon80.png">
<link rel="apple-touch-icon-precomposed" sizes="android-only"
href="icons/icon57.png">

<link rel="apple-touch-startup-image" href="images/launch-iphone.png"
media="(max-device-width: 480px)">
<link rel="apple-touch-startup-image" href="images/launch-iPad-p.png"
media="screen and (min-device-width: 481px) and (max-device-width:
1024px) and (orientation:portrait)">
<link rel="apple-touch-startup-image" href="images/launch-iPad-l.png"
media="screen and (min-device-width: 481px) and (max-device-width:
1024px) and (orientation:landscape)">

=> iPhone/iPod: 320×460 / iPad Portrait: 748×1004 / iPad Landscape: 748×1024(rotated 90 degrees)


RESPONSIVE LAYOUTS MIT JQM

• Media-Queries z.B. um die Orientierung zu befragen:
@media (orientation: portrait) {
/* Code hier für die Orientierung Portrait... */
}
@media (orientation: landscape) {
/* Code hier für die Orientierung Landscape... */
}

=> http://www.w3.org/TR/css3-mediaqueries/

• Beim Orientierungswechsel kann es in iOS-Geräten dazu kommen, dass der Zoom nicht mehr
stimmt (iOS Bug) - dafür gibt es zwei Lösungen:

• Abschalten des Zooms
<meta name="viewport" content="width=device-width,
minimum-scale=1.0, maximum-scale=1.0">

• Dynamisches Neuberechnen des Zooms
http://adactio.com/journal/4470/


RESPONSIVE LAYOUTS MIT JQM
• Beispiel: Label neben Formularelemente im Landscape Mode:
@media all and (min-width: 450px){2
label.ui-input-text { display: inline-block; }
}

=> http://www.w3.org/TR/css3-mediaqueries/

• Abfrage von iOS Retina Displays
@media screen and (-webkit-min-device-pixel-ratio: 2){
// iOS Rentina Display
}

• Abfrage der Media Queries über jQuery
// Test auf Screen Media Type
$.mobile.media("screen");

// Test auf min-width
$.mobile.media("screen and (min-width: 480px)");

// Test auf iOS Retina Display
$.mobile.media("screen and (-webkit-min-device-pixel-ratio: 2)");


ARCHITEKTUR

• Cards & Roles

• Idee kommt von WML: Eine oder mehrere Zielseiten beﬁnden
sich in einem HTML-Dokument
• Eine Seite ist ein DIV-Element mit einer spezielle „Rolle“
• Zugehöriges Attribut ist data-role
• (In HTML5 gibt es die data-* Attribute um spezielle, eigene
Auszeichnungen zu vergeben - „custom data attributes“)
• Vorteil: Funktioniert auch auf „Non-HTML5“-Browser


ARCHITEKTUR - ROLLEN


SEITENSTRUKTUR
• data-role ist NICHT mandatory - aber guter Stil!
• <div data-role="page">
<div data-role="header">
<h1>Header</h1>
</div>
<div data-role="content">
<p>CONTENT</p>
</div>
<div data-role="footer" data-position="fixed">
<h4>Footer</h4>
</div>
</div>


ABLAUF

jQuery Mobile
Semantisches
page
HTML5 Markup
anreichern enhancements umwandeln


SEITENSTRUKTUR - JQM
• Das macht jQuery Mobile aus der Seite (enhancement)
<html class="ui-mobile">
<head>
<meta charset="utf-8">
<title>Titel</title>
<link rel="stylesheet" href="http://code.jquery.com/mobile/1.0/
jquery.mobile-1.0.min.css">
<script src="http://code.jquery.com/jquery-1.6.4.min.js"></script>
<script type="text/javascript" src="http://code.jquery.com/mobile/1.0/
jquery.mobile-1.0.min.js"></script>
<meta name="viewport" content="width=device-width; initial-scale=1;">
</head>
<body class="ui-mobile-viewport">
<div data-role="page" data-url="/Users/patricklobacher/Desktop/jQuery Mobile/
test.html" tabindex="0" class="ui-page ui-body-c ui-page-active" style="min-height:
403px; ">
<div data-role="header" class="ui-header ui-bar-a" role="banner">
<h1 class="ui-title" tabindex="0" role="heading" aria-
level="1">Header</h1>
</div>
<div data-role="content" class="ui-content" role="main">
<p>CONTENT</p>
</div>
<div data-role="footer" data-position="fixed" class="ui-footer ui-bar-a ui-
footer-fixed fade ui-fixed-overlay" role="contentinfo" style="top: 241px; ">
<h4 class="ui-title" tabindex="0" role="heading" aria-
level="1">Footer</h4>
</div>
</div>
<div class="ui-loader ui-body-a ui-corner-all" style="top: 354px; "><span
class="ui-icon ui-icon-loading spin"></span><h1>loading</h1></div>
</body>
</html>


THEMING
• Alle Elemente werden über ein Theme dargestellt

• Default ist ein Theme enthalten, weitere müssen über den
sogenannten Theme-Roller eingebracht werden:
http://jquerymobile.com/themeroller/

• Jedes Theme ist in „Swatches“ unterteilt (unterschiedliche Optionen)

• Ansprechen über data-theme="buchstabe"


MULTI-PAGE
Mehrere Seiten in einem Dokument


MULTI-PAGE TEMPLATE
• Weitere Seiten über separate DIVs mit data-role="page" und eindeutiger ID die mittels
Anker-Link angesprungen wird. Seitentitel über data-title="Home".

• 
<div data-role="page" id="home" data-title="Home">
<h1>Willkommen!</h1>
</div>
<a href="#contact" data-role="button">Kontakt</a>
</div>
</div>

<div data-role="page" id="contact" data-title="Contact">
<h1>Kontakt</h1>
</div>
Kontakt Infos...
</div>
<script type="text/javascript">
/* Seitenspezifisches JavaScript */
</script>
</div>

SEITENTITEL

1. Wenn ein Wert für data-title existiert, wird dieser für den Titel der
internen Seite verwendet.

2. Wenn kein Wert für data-title existiert, wird der Header (data-
role="header") verwendet.

3. Existiert weder ein Wert für data-title noch ein Header, wird das
<title> Element innerhalb des <head> Elements auf der Seite
verwendet.


VERLINKUNG
• Wenn man auf HTML-Dokumente verlinkt, die ebenfalls eine
Seitenstruktur über data-role="page" beinhalten, wird diese wie eine
interne Seite behandelt

• Enthält das externe Dokument allerdings mehrere HTML-Seiten, so
muss bei Link das Attribut rel="external" oder target="_blank"
verwendet werden

• Das führt zu einem kompletten Seiten-Refresh (und nicht einer
Animation und Vorladen per AJAX).

• Dies ist notwendig, da jQuery Mobile keine Multi-Page Dokumente in
das DOM der aktuellen Seite laden kann (Namespace Konﬂikte)

• Zusätzlich ist es nicht möglich, Anker im klassischen Sinn zu
verwenden, da diese als Sprungmarken für interne Seite dienen.

NAVIGATIONEN
Links Links Links :-)


NAVIGATION

• In jQuery Mobile werden vier Link-Arten unterschieden:
• Interne Links zu einer anderen Seite die im selben Dokument
enthalten ist (Multipage-Dokument)
• Externer JQM Link zu einer anderen Seite in einem anderen
Dokument
• Externer Link zu einer Nicht-jQueryMobile Seite
• Mobile Spezial-Links

• Die ersten beiden Link-Arten verhalten sich dabei wie folgt:
• Vorladen des Inhalts (bei extern)
• Erzeugung einer Animation von der ersten zur zweiten Seite
• Trigger des Back-Buttons um zur ersten Seite zurückzukommen


INTERNE LINKS (#ID)

Quelle Graﬁk:
jQuery Mobile - Up and running
Maximiliano Firtman
O‘Reilly
ISBN: 978-1-449-39765-4


EXTERNER JQM REQUEST
jQuery Mobile

Page Request
Hijax-Request
Web Server

Append to DOM
Hijax-Response

Enhance Page

Transition
Hijax: http://en.wikipedia.org/wiki/Hijax


DATA-URL
• Das Attribut data-url wird beim „Anreichern“ an die Seite gebunden

• Der Wert entspricht dem eindeutigen Locator (ID) und wird in der
URL-Zeile des Browsers angezeigt

• Per Default verwendet jQuery Mobile hierfür die URL der Seite
• Allerdings kann man diesen Wert gezielt überschreiben indem man
das Attribut selbst setzt.

• Dies ist insbesondere nach einem Redirect sinnvoll
• Oder wenn man den Dateinamen verstecken und nur die URL-Pfad
anzeigen will


EXTERNE JQM REQUEST
1. jQuery Mobile parst das Attribut href lädt die Zielseite mittels eines Ajax-
Requests (Hijax).
2. Wenn die Seite erfolgreich geladen wurde, wird sie in das DOM
eingehängt
3. Ist dies erfolgreich, reichert jQuery Mobile die Seite an -inbesondere wird
das base Element erweitert und das data-url Attribut gesetzt (wenn dies
noch nicht explizit geschehen ist)
4. Nun führt das Framework eine Transition (Übergang) mit dem Typ „slide“
durch (neue Seite wird von rechts nach links animiert „reingeschoben“ und
die alte Seite schiebt sich gleichermaßen nach links raus).
5. Anschließend bekommt die aktive Seite die Klasse ui-page-active
zugewiesen
6. Schließlich wir die URL angepasst, sodaß ein Bookmark gesetzt werden
kann (pushState Feature von HTML5)
7. Schlägt das Laden fehl, wird ein „Error Loading Page“ Overlay gezeigt


TRANSITIONS (ÜBERGÄNGE)
1. jQuery Mobile verfügt über 9 eingebaute Transitions:
1. fade (Ausblenden/Einbleden)
2. pop (Vergrößern/Verkleinern)
3. flip (Umdrehen - wie eine Karte)
4. turn (Rausklappen/Reinklappen nach/von Links)
5. flow (Animationseffekt bekannt vom iPhone Safari beim Wechsel von Seiten)
6. slidefade (Rausfahren/Reinfahren nach/von links bei gleichzeitigem Ausblenden/Einblenden)
7. slide (Rausfahren/Reinfahren nach/von links)
8. slideup (Rausfahren/Reinfahren nach/von oben bei gleichzeitigem Ausblenden/Einblenden)
9. slidedown (Rausfahren/Reinfahren nach/von unten bei gleichzeitigem Ausblenden/Einblenden)
10. none (Keine Animation)

2. Eine Transition kann über das Attribut data-transition="[transition]"
spezifiziert werden, welches auf alle Links, Buttons und Formulare gelegt
werden kann.
3. Um eine umgekehrte Transition zu forcieren kann data-
direction="reverse" verwendet werden.

DIALOGE VS. SEITEN
1. Dialoge sind Seiten mit einem
abgeänderten UI
2. Die Seite wird auf dem Hintergrund platziert,
mit abgerundeten Ecken dargestellt und mit
einem Schließen-Button links oben versehen
3. Eingeleitet wird ein Dialog mit dem Attribut
<a href="#terms" data-rel="dialog"
data-transition="slidedown">AGB</a>
4. Oder aber bei der Deﬁnition
der Seite selbst
<div data-role="dialog" id="terms">
AGB
</a>
5. Dialoge können nicht gebookmarkt werden
und tauchen nicht in der History auf.
6. Dialoge können per API geschlossen werden
function processAgreement(){
// Dialog schließen
$('.ui-dialog').dialog('close');
}


ACTION SHEETS
1. Action Sheets sind Dialoge die von
oben animiert hereinfahren
2. Auf diesen wird meist eine User-Interaktion eingefordert
3. Technisch gesehen sind dies Dialoge,
denen Header und Footer fehlt

4. Code:
<div data-role="page" id="home">

<a href="#logout" data-transition="slidedown">
Logout</a>
</div>

<div data-role="dialog" id="logout">
<span class="title">LOGOUT: Sicher?</span>
<a href="#home" data-role="button" data-theme="b">Yepp!</a>
<a href="#" data-role="button" data-theme="c" data-rel="back">Niemals!</
a>
</div>
<style>
span.title { display:block; text-align:center;
margin-top:10px; margin-bottom:20px; }
</style>
</div>

EXTERNE LINKS
• Damit der jQuery Mobile „Ablauf“ erhalten bleibt:
• Das Ziel muss auch eine jQuery Mobile Seite sein
• Das Ziel muss in der selben Domain liegen.
• Das Ziel darf nur eine Seite enthalten
• Wenn die Ziel-URL ein Verzeichnis ist, muss ein abschließender
Slash angeben werden => href="/clients/" .
• Das target-Attribut darf nicht angegeben werden
• Alle anderen Fälle führen zu einem „normalen“ Laden der Seite
• Vorab laden von Seiten über das Attribut data-prefetch
<a href='neueseite' data-prefetch>Lade Seite vorab</a>
• DOM-Caching (erzeugtes DOM der Seite wird gecached):
<div data-role="page" data-dom-cache="true">


EXTERNE ABSOLUTE LINKS

• Externe absolute Links werden wie folgt erzeugt:
• Zufügen des Attributs: data-rel="external"
<a href="http://www.typovision.de" data-rel="external">typovison</a>

• Zufügen eines target Attributs
<a href="http://www.typovision.de" target="_blank">typovison</a>

• Verweisen auf eine andere Domain
<a href="http://www.anderedomain.de">typovison</a>

• Verwenden des Attributs: data-ajax="false"
<a href="http://www.typovision.de" data-ajax="false">typovison</a>
Dieses Attribut kann auch auf die Seite selbst angewendet werden


MOBILE SPEZIAL-LINKS

• Es gibt einige spezielle Links:
• Starten der Telefon-App
<a href="tel:+498945205930">Rufen Sie uns an!</a>

• Facetime (nur auf iOS)
<a href="facetime:101010">Rufen Sie uns über Facetime an</a>

• Skype (nur wenn vorhanden)
<a href="skype:skype_user?call">Rufen Sie uns über Skype an</a>

• Email
<a href="mailto:info@typovision.de?subject=Kontakt&body=Das
%20ist%20der%20Inhalt">Schreiben Sie uns!</a>
• SMS
<a href="sms://+49151547266?body=SMS%20Text">Schreiben Sie uns
eine SMS</a>


TOOLBARS
Header & Footer Toolsbars


HEADER BAR
• Normale Header Toolbar:
<h1>Seitentitel</h1>
</div>

• Fixieren der Toolbar mittels:
<div data-role="header" data-position="fixed">

• Fullscreen-Mode mittels:
<div data-role="page" data-fullscreen="true">
(Toolbars sind verschwunden und tauchen erst bei Touch wieder auf -
gut für großﬂächige Seiten wie Galerien oder ähnlichem)

• Die Header Bar hat keinen Backbutton per Default, man muss diesen
einschalten (siehe später)

HEADER BAR - TITLE

• Auf den Header/Footer wird das
CSS-Attribut text-overflow: ellipsis
gelegt um den Titel abzuschneiden und
mit ... aufzufüllen:
<h1>Ziemlich langer Titel</h1>
</div>

• Dies kann über folgendes CSS
verhindert werden:
.ui-header .ui-title,
.ui-footer .ui-title {
margin-right: 0 !important;
margin-left: 0 !important;
}


HEADER BAR - FIXED POSITION
• Über das Attribut data-position="fixed" kann die fixe Position von Header Bar
(und auch Footer Bar) emuliert werden, sodaß sie als fixiert wahrgenommen
wird
• iOS unterstützt dafür seit der Version 5.0 die CSS-Eigenschaften position:fixed,
overflow:auto sowie overflow-scrolling: touch
• Auf Android 3.0, sowie Blackberry PlayBook funktioniert dies auch innerhalb
von Block-Elementen und wurde in jQuery Mobile 1.1 nachgereicht.
• Um auf diesen Systemen richtig fixierte Toolbars zu erhalten, sollte das
Feature in jQuery Mobile eingeschaltet werden - Fallback ist immer das
Default-Verhalten:

$(document).bind('mobileinit', function() {
$.mobile.touchOverflowEnabled=true;
});

• Will man nun ausschließlich im Content-Bereich zoomen, so kann man dies
mittels touchOverflowZoomEnabled einschalten.

HEADER TOOLBAR - BUTTONS
• Toolbar mit einem Button:

<a href="logout">Log out</a>
<h1>Title</h1>
</div>
• Toolbar mit zwei Buttons:

<a href="logout">Log out</a>
<h1>Title</h1>
<a href="settings" data-icon="gear" data-
theme="b">Settings</a>
</div>

• Will man den Button rechts positionieren, kann man
class="ui-btn-right" verwenden

HEADER TOOLBAR - BUTTONS

• Button ohne Text:

<h1>Header</h1>
<a href="#" data-icon="plus" data-
iconpos="notext" data-theme="b"></a>
</div>
• Zur Realisierung eines eigene Back-Buttons:

data-rel="back"

Dies stattet den Button mit einer Back-Funktion aus. Das Linkziel wird dann nicht
mehr beachtet und die Animation ﬁndet mit der Richtung „reverse“ statt.
Funktioniert nur in A- und B-Grade Browser. C-Grade Browser ignorieren das Attribut
und folgen dem Link-Ziel


BACK-BUTTON
• Zufügen eine Back-Buttons über folgenden Code:

• <div data-role="page" data-add-back-btn="true"
data-back-btn-text="Previous" data-back-btn-theme="e">

Button aktivieren (default ist false): data-add-back-btn="true"
Button-Text: data-back-btn-text="Previous"
Button-Theme: data-back-btn-theme="e"

• Globales Konﬁgurieren über JavaScript

• $(document).bind('mobileinit',function(){
$.mobile.page.prototype.options.addBackBtn = true;
$.mobile.page.prototype.options.backBtnText = "Previous";
$.mobile.page.prototype.options.backBtnTheme = "b";
});


TOOLBARS - SEGMENTED
• Segmentierte Toolbar:
<div data-role="header" data-theme="b"
data-position="fixed">
<h1>Filme</h1>
<div class="segmented-control ui-bar-d">
<div data-role="controlgroup"
data-type="horizontal">
<a href="#" data-role="button"
class="ui-control-active">Im Kino</a>
class="ui-control-inactive">In Kürze</a>
class="ui-control-inactive">Top-Filme</a>
</div>
</div>
</div>
<style>
.segmented-control { text-align:center;}
.segmented-control .ui-controlgroup {
margin: 0.2em; }
.ui-control-active, .ui-control-inactive {
border-style: solid; border-color: gray; }
.ui-control-active { background: #BBB; }
.ui-control-inactive { background: #DDD; }
</style>


TOOLBARS - UI-BAR

• Toolbar mit einer „UI-Bar“:

<div data-role="footer" class="ui-bar">
<a href="refresh">Refresh</a>
<a href="filter">Filter</a>
<a href="search">Search</a>
<a href="add" data-theme="b">New Item</a>
</div>


TOOLBARS - NAVBAR
• Toolbar mit einer „UI-Bar“:
<div data-role="header"
data-position="fixed">
<h1>Home</h1>
<div data-role="navbar">
<ul>
<li><a href="#index" data-icon="home">Home</a>
<li><a href="#contacts" data-
icon="search">Kontakt</a>
<li><a href="#events" data-icon="info">Events</a>
<li><a href="#news" data-icon="grid">News</a>
</ul>
</div>
</div>

• Für Icon-Only einfach Text weglassen


ICONS

• Übersicht über die verfügbaren Icons:
http://jquerymobile.com/
test/docs/buttons/buttons-icons.html


TOOLBARS - AKTIVER BUTTON

• Aktiver Button mittels:

<div data-role="footer" data-position="fixed">
<div data-role="navbar">
<ul>
<li><a href="#index" class="ui-btn-
active">Home</a>
<li><a href="#contacts">Contacts</a>
<li><a href="#events">Events</a>
<li><a href="#news">News</a>
</ul>
</div>
</div>


TOOLBARS - PERSISTENZ
• Nach jedem Ladevorgang wird auch die Footer-Toolbar neu
geladen. Will man diese persistieren (kein Neuladen), so muss
man folgenden Code verwenden:

<div data-role="footer" class="tabbar" data-id="main-tabbar" data-
position="fixed">
<div data-role="navbar" class="tabbar">
<ul>
<li><a href="tabbar-movies.html" class="ui-btn-active ui-state-
persist">Kino</a></li>
<li><a href="tabbar-theatres.html">Theater</a></li>
</ul>
</div>
</div>

<div data-role="footer" class="tabbar" data-id="main-tabbar" data-
position="fixed">
<div data-role="navbar" class="tabbar">
<ul>
<li><a href="tabbar-movies.html">Kino</a></li>
<li><a href="tabbar-theatres.html"
class="ui-btn-active ui-state-persist">Theater</a></li>
</ul>
</div>
</div>

TOOLBARS - CUSTOM ICONS
• Verwendung von eigenen Icons (beispielsweise von http://
glyphish.com/)
<div data-role="footer" class="ui-navbar-custom" data-position="fixed">
<div data-role="navbar" class="ui-navbar-custom">
<ul>
<li><a href="#" id="home" data-icon="custom" data-theme="d">Home</a></
li>
<li><a href="#" id="movies" data-icon="custom" class="ui-btn-
active">Kino</a></li>
<li><a href="#" id="theatres" data-icon="custom" data-
theme="d">Theater</a></li>
</ul>
</div>
</div>
<style>
.ui-navbar-custom .ui-btn .ui-btn-inner {
font-size: 11px!important; padding-top: 24px!important; padding-bottom: 0px!
important;
}
.ui-navbar-custom .ui-btn .ui-icon {
width: 30px!important; height: 20px!important; margin-left: -15px!important;
box-shadow: none!important; -moz-box-shadow: none!important;
-webkit-box-shadow: none!important; -webkit-border-radius: none !important;
border-radius: none !important;
}
#home .ui-icon {
background: url(icons/53-house.png) 50% 50% no-repeat;
background-size: 22px 20px;
}
...


BUTTONS
Klick & Action


BUTTONS - ARTEN
• Mögliche Arten:
<a href="#" data-role="button">Klick mich!</a>
<button data-theme="b">Klick mich auch!</button>
<input type="button" value="Und mich erst recht!">

• Inline Buttons über:
<a href="#" data-role="button" data-inline="true">B1</a>

• Icon-Buttons über:
<a href="" data-role="button"
data-icon="plus"
data-iconpos="notext"></a>
<button data-icon="search"
data-iconpos="notext">Search</button>


BUTTONS - NATIVE BEIBEHALTEN
• Um automatische Button-Umwandlung aufzuheben, muss das Attribut

data-role="none"

verwendet werden.

• Oder über JS global deaktiviert werden:

$(document).bind('mobileinit',function(){
$.mobile.page.prototype.options.keepNative = "input, select";
});


BUTTON-ICONS
• ICONS:
http://jquerymobile.com/test/docs/buttons/buttons-icons.html

• Eigene ICONS:
data-icon="myapp-tweet"
<style>
.ui-icon-myapp-tweet {
background: url(icons/tweet.png)50% 50% no-repeat;
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) {
.ui-icon-myapp-tweet {
background-image: url(icons-hd/tweet.png) !important;
}
}
</style>


ICON-POSITIONIERUNG
• Positionierungen:
<a href="#" data-role="button" data-icon="help" data-
iconpos="right">Help</a>

<a href="#" data-role="button" data-icon="help" data-
iconpos="left">Help</a>

<div data-role="controlgroup">

data-icon="help"
data-iconpos="bottom">Help</a>

data-icon="help"
data-iconpos="top">Help</a>

</div>


BUTTONS - GRUPPIERUNG
• Button-Gruppierung:
<div data-role="controlgroup">
<a href="#" data-
role="button">Button 1</a>
<a href="#" data-
<a href="#" data-
</div>

• Button-Gruppierung horizontal:
<div data-role="controlgroup" data-type="horizontal">
<a href="#" data-role="button" data-
inline="true">Button 1</a>
</div>


BUTTONS - EFFEKTE

• Button-Effekte:
<a href="#" data-role="button" data-shadow="false" data-
corners="false">Help</a>


FORMULARE
Interaktion


FORMULARE - GRUNDLAGEN

• <form action="send.php" action="get" data-transition="pop">
<label for="email">Email:</label>
<input type="email" name="email" id="email" value="" />
<button type="submit" name="submit">Submit</button>
</form>

• Animation beim Wegschicken über data-transition="pop"

• Ohne AJAX über data-ajax="false" oder target="_blank"


FORMULARE - FIELDCONTAINER
• <form action="send.php" action="get" data-
transition="pop">
<div data-role="fieldcontainer">
<label for="company">Company Name:</label>
<input type="text" id="company" name="company">
</div>
<div data-role="fieldcontainer">
<label for="email">Email:</label>
<input type="email" id="email" name="email">
</div>
</form>


FORMULARE - FELDER

• Mögliche Feld-Arten:
<input type="text">
<input type="password">
<input type="email">
<input type="tel">
<input type="url">
<input type="search">
<input type="number">
<textarea>

• Unterstützung siehe
http://www.quirksmode.org/html5/inputs_mobile.html


FORMULARE - FELDER

• date: Datum Tag, Monat, Jahr
datetime: Tag, Monat, Jahr, Stunde, Minute
time: Stunde, Minute
datetime-local: Datum ohne Zeit-Information
month: Monats-Selektor
week: Wochen-Selektor

<div data-role="field container">
<label for="birth">Your Birthdate:</label>
<input type="date" id="birth" name="birth">
<label for="favmonth">Your favorite month:</label>
<input type="month" id="favmonth" name="favmonth">
</div>


FORMULARE - SELECT 1/2
• Select-Elemente (Mehrfachauswahl mit multiple)

<label for="delivery">Technologie:</label>
<select name="delivery" id="delivery"
multiple="multiple">
<optgroup label="TYPO3">
<option value="extbase">Extbase</option>
<option value="pi">pi_base</option>
</optgroup>
<optgroup label="JavaScript">
<option value="jq">jQuery</option>
<option value="jqm">jQuery Mobile</option>
<option value="jqui">jQuery UI</option>
</optgroup>
<optgroup label="HTML5">
<option value="offline">Offline Storage</option>
<option value="markup">Markup</option>
</optgroup>
</select>


FORMULARE - SELECT 2/2
• Select-Elemente mit eigener ( jQuery Mobile) UI

<label for="genre">Technologie:</label>
<select name="genre" id="genre"
data-native-menu="false"
multiple="multiple">
<option value="">Wählen Sie aus...</option>
<option value="action">TYPO3</option>
<option value="comedy">FLOW3</option>
<option value="drama">jQuery</option>
</select>


FORMULARE - CHECKBOXEN
• Radio-Buttons (name-Attribut muss gleich sein)

<fieldset data-role="controlgroup">
<legend>Technologie:</legend>
<input type="radio" name="tech" id="tech1"
value="TYPO3" checked="checked" />
<label for="tech1" data-theme="b">TYPO3</label>
<input type="radio" name="tech" id="tech2" value="FLOW3" />
<label for="tech2" data-theme="b">FLOW3</label>
<input type="radio" name="tech" id="tech3" value="jQuery" />
<label for="tech3" data-theme="b">jQuery</label>
</fieldset>
<fieldset data-role="controlgroup"
<input type="radio" name="tech" id="tech1"
<label for="tech1">TYPO3</label>
<input type="radio" name="tech" id="tech2" value="FLOW3" />
<label for="tech2">FLOW3</label>
<input type="radio" name="tech" id="tech3" value="jQuery" />
<label for="tech3">jQuery</label>
</fieldset>

Wichtig, damit horizontale Radiobuttons nicht umbrechen
<style>
.ui-controlgroup-horizontal .ui-radio label { font-size: 13px !important; }
</style>


FORMULARE - CHECKBOXEN
• Checkboxen (name-Attribut muss gleich sein)

<fieldset data-role="controlgroup">
<input type="checkbox" name="tech" id="tech1"
<label for="tech1" data-theme="b">TYPO3</label>
<input type="checkbox" name="tech" id="tech2" value="FLOW3" />
<label for="tech2" data-theme="b">FLOW3</label>
<input type="checkbox" name="tech" id="tech3" value="jQuery" />
<label for="tech3" data-theme="b">jQuery</label>
</fieldset>
<fieldset data-role="controlgroup"
<input type="checkbox" name="tech" id="tech1"
<label for="tech1">TYPO3</label>
<input type="checkbox" name="tech" id="tech2" value="FLOW3" />
<label for="tech2">FLOW3</label>
<input type="checkbox" name="tech" id="tech3" value="jQuery" />
<label for="tech3">jQuery</label>
</fieldset>

Wichtig, damit horizontale Checkboxen nicht umbrechen
<style>
.ui-controlgroup-horizontal .ui-checbox label { font-size: 12px !important; }
</style>


FORMULARE - SLIDER
• <div data-role="fieldcontainer">
<label for="qty">Menge:</label>
<input type="range" id="qty" name="qty" min="1"
max="100" value="5" data-theme="e" data-track-theme="b">
</div>


FORMULARE - SWITCH
• <label for="alerts">jQuery:</label>
<select name="slider" id="alerts" data-role="slider">
<option value="off">Aus</option>
<option value="on">An</option>
</select>


LISTEN
Paradigmen


NORMALE LISTEN

• Normale Listen:
<ul data-role="listview">
<li>Offline Access</li>
<li>Geolocation API</li>
<li>Canvas</li>
<li>Offline Storage</li>
<li>New semantic tags</li>
</ul>

data-inset="true"


TRENNER
• Trenner:
<li data-role="list-divider">Group A</li>
<li>Argentina</li>
...
<li data-role="list-divider">Group B</li>
<li>United States</li>
...
<li data-role="list-divider">Group C
<li>Germany</li>
...
</ul>
</div>


INTERAKTIVE LISTEN
• Interakive Listen:
<li><a href="#page2">Interner Link</a>
<li><a href="other.html">Externer Link</a>
<li><a href="http://www.typovision.de">Absoluter
externer Link</a>
<li><a href="tel:+13051010200">Telefon</a>
<li><a href="javascript:alert('Hi!')">JavaScript link</
a>
</ul>
</div>


LISTEN-AUSZEICHNUNG
• Listen-Auszeichnungen:
<li data-role="list-divider"
data-divider-theme="a">
Sonntag
<p class="ui-li-aside">20.Mai 2012</p>
</li>
<li>
<a href="#">18 Uhr
<span class="ui-li-aside">Meeting</span>
</a>
</li>
<li data-role="list-divider"
data-divider-theme="a">
Sonntag
<p class="ui-li-aside">20.Mai 2012</p>
</li>
<li>
<a href="#">Mails
<span class="ui-li-count">123</span></a>
</li>
</ul>


LISTEN DARSTELLUNG
• Listen-Darstellung mit Thumbnails:
<li>
<a href="movies/kung-fu-panda.html">
<img src="images/kungfupanda2.jpg" />
<h3>Kung Fu Panda</h3>
<p>Rated: PG</p>
<p>Runtime: 95 min.</p>
</a>
</li>
...
</ul>

• Um Icons mit der Größe 16x16 Pixel zu
verwenden kann man eine Klasse verwenden:

<img src="images/kungfupanda2.jpg" class="ui-li-icon" />


LISTEN - SPLIT BUTTONS

• Listen-Darstellung mit Split-Buttons:
<ul data-role="listview" data-split-icon="star"
data-split-theme="d">
<li>
<a href="movies/kung-fu-panda.html">
<img src="images/kungfupanda2.jpg" />
<h3>Kung Fu Panda</h3>
<p>Rated: PG</p>
<p>Runtime: 95 min.</p>
</a>
<a href="tickets.html">Tickets kaufen</a>
</li>
</ul>

• Eignet sich sehr gut um zwei verschiedene
Aktionen (Links) zu unterstützen


NUMERISCHE LISTEN

• Numerische Listen mittel <ol>-Tag:
<ol data-role="listview">
<li><a href="#TYPO3">TYPO3</a></li>
<li><a href="#FLOW3">FLOW3</a></li>
<li><a href="#jQuery">jQuery</a></li>
<li><a href="#jQueryMobile">jQuery Mobile</a></li>
</ol>


LISTEN FILTERN
• Filtern von Listen
<ul data-role="listview"
data-filter="true"
data-filter-placeholder="Suche…">
<li><a href="#TYPO3">TYPO3</a></li>
<li><a href="#jQuery">jQuery</a>
</li>
<li><a href="#jQueryMobile">
jQuery Mobile</a></li>
</ul>

• Suchen in Meta-Daten (ﬁndet auch AAPL z.B.)
<li data-filtertext="NASDAQ:AAPL Apple Inc."><a href="#">Apple</a></li>
<li data-filtertext="USA U.S.A. United States of America"><a
href="#">United States</a></li>

• Der Platzhalter-Text kann auch global gesetzt werden:
$(document).bind('mobileinit',function(){
$.mobile.listview.prototype.options.filterPlaceholder="Suche...";
});


VERSCHACHTELTE LISTEN

• Verschachtelte Listen
<li><a href="#TYPO3">TYPO3</a>
<li><a href="#TCA">TCA</a></li>
<li><a href="#TCE">TCE</a></li>
<li><a href="#TypoScript">
TypoScript</a></li>
</ul>
</li>
<li><a href="#jQuery">jQuery</a></li>
</ul>

• Verschachtelte Listen werden automatisch zugeklappt angezeigt. Ein Klick auf eines der
Elemente sorgt dafür, dass mittels eine Slide-Animation die Unterliste angezeigt wird.


CONTENT
Inhalte und deren Auszeichnung


GRID-CONTENT
• Spalten und Zeilen (gleichmäßige Aufteilung):
<section class="ui-grid-b">

<div class="ui-block-a">Zelle 1.1</div>
<div class="ui-block-b">Zelle 1.2</div>
<div class="ui-block-c">Zelle 1.3</div>

<div class="ui-block-a">Zelle 2.1</div>
<div class="ui-block-b">Zelle 2.2</div
<div class="ui-block-c">Zelle 2.3</div>
</section>
• ui-grid-a für 2spaltig
ui-grid-b für 3spaltig
ui-grid-c für 4spaltig
ui-grid-d für 5spaltig
• grid-block-a bis grid-block-e für
Spalte 1 bis 5

AUFKLAPP-CONTENT
• Aufklapp-Content:
<div data-role="collapsible">
<h2>Überschrift1</h2>
<p>INHALT1</p>
</div>
<div data-role="collapsible"
data-collapsed="true">
<h2>Überschrift2</h2>
<p>INHALT2</p> </div>
</div>

• Kann beliebig verschachtelt werden
DIV > DIV > H2 > DIV > H3 > p

• Styling durch:
data-theme
data-content-theme


AUFKLAPP-CONTENT + EMOJI

• Aufklapp-Content mit EMOJI-Icons (nur iOS):

<div data-role="collapsible" data-collapsed="true"
data-theme="a" data-content-theme="b">
<h3>Wireless</h3>
<ul data-role="listview" data-inset="true">
<li><a href="#"> Notifications</a></li>
<li><a href="#"> Location Services</a></li>
</ul>
</div>
<div data-role="collapsible" data-theme="a"
data-content-theme="b">
<h3>Applications</h3>
<li><a href="#"> Faceoff</a></li>
<li><a href="#"> LinkedOut</a></li>
<li><a href="#"> Netflicks</a></li>
</ul>
</div>

• http://www.iphone-ticker.de/ios-5-alle-emoji-symbole-auf-einen-blick-22663/


AKKORDION - COLLAPSIBLE SET
• Akkordion-Funktion (nur ein ausgeklappter
Container zur gleichen Zeit):

<div data-role="collapsible-set" data-theme="a"
data-content-theme="b">
<div data-role="collapsible" data-collapsed="true">
<h3>Wireless</h3>
<li><a href="#"> Notifications
</a></li>
<li><a href="#"> Location Services
</a></li>
</ul>
</div>
<div data-role="collapsible">
<h3>Applications</h3>
<li><a href="#"> Faceoff</a></li>
<li><a href="#"> LinkedOut</a></li>
<li><a href="#"> Netflicks</a></li>
</ul>
</div>
</div>


THEME-ROLLER
Custom Designs


EIGENE SKRIPTE

http://jquerymobile.com/themeroller/


THEME ROLLER

• Mit dem Theme Roller ist es möglich
ein individuelles Theme zu erstellen,
dieses runterzuladen und dann zu verwenden
• Es ist damit möglich alle Elemente individuell
zu gestalten
• In the „Global“-Settings können globale
Einstellungen getroffen werden, die in allen
Swatches gelten sollen


THEME ROLLER

• Es können beliebig viele Swatches hinzugefügt werden
• Man kann entweder den eingebauten Farbwähler (mit Brightness-
und Saturation-Funktion) verwenden oder Adobe Kuler


THEME ROLLER
• Man kann ein „altes“ Theme importieren und umwandeln lassen in
ein Theme der Version 1.1.0
• Das fertig Theme kann anschließend heruntergeladen werden
• Oder man teilt das Theme mit anderen Leuten über einen
eindeutigen Link


JAVASCRIPT
Und das Framework


EIGENE SKRIPTE
• <script src="http://code.jquery.com/
jquery-1.6.4.min.js"></script>

<script>
$(document).bind("mobileinit", function() {
// Eigener Code hier
});
</script>

<script src="http://code.jquery.com/mobile/1.0/
jquery.mobile-1.0.min.js"></script>


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 1/12
Apress
ISBN: 978-1430239666

• Um Events nachzuvollziehen, kann
man einen Event Logger als
Bookmarklet verwenden:
http://code.jquery.com/mobile/latest/
demos/tools/log-page-events.html

• mobileinit
Wenn jQuery Mobile initialisiert wird,
wird ein mobileinit Event auf das
document Objekt getriggert


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 2/12
Apress
ISBN: 978-1430239666

• pagebeforechange
Dies ist der erste Event der während
einem Seitenwechsel getriggert wird.

$( document ).bind( "pagebeforechange",
function( e, data ) {
console.log("Seitenwechsel
startet...");
// Hole die Seite
var toPage = data.toPage;
// Hole die Optionen der Seite
var options = data.options;
// Etwas mit der Seite machen
…
// z.B. Seitenwechsel abbrechen
e.preventDefault();
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 3/12
Apress
ISBN: 978-1430239666

• pagebeforeload
Dies ist der erste Event der während
dem Laden der Seite getriggert wird.

$( document ).bind( "pagebeforeload",
function( e, data ){
console.log("Laden der Seite
startet…");
// Manuelles Laden triggern
e.preventDefault();
// Seite laden + Einfügen ins DOM
var response = manuallyLoadPage();
if (response.status = "success") {
data.deferred.resolve( data.absUrl,
data.options,response.page);
} else {
data.deferred.reject( data.absUrl,
data.options );
}
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 4/12
Apress
ISBN: 978-1430239666

• pagebeforecreate
Dieser Event tritt auf, nachdem der
Seiten-Container zum DOM
hinzugefügt wurde und bevor die
Seite „angereichert“ wird.

$( "#to-page-id" ).
live( "pagebeforecreate", function()
{
console.log( "Hier sollte das Markup
geparst werden, bevor es angereichert
wird" );
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 5/12
Apress
ISBN: 978-1430239666

• pagecreate
Hier ist der beste Platz um Seiten-
Plugins zu initialisieren.

$( "#to-page-id" ).live( "pagecreate",
function(){
console.log("Seiten-Plugins werden
initialisiert...”);
// Initialisiere eigene Plugins
( ":jqmData(role='my-plugin') " )
.myPlugin();
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 6/12
Apress
ISBN: 978-1430239666

• pageinit
Event der auftritt, nachdem die
„Anreicherung“ komplett ist. Die Seite
ist nun „DOM-Ready“.

$( "#to-page-id" ).live( "pageinit",
function(){
console.log("Die Seite wurde
angereichert... ");
...
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 7/12
Apress
ISBN: 978-1430239666

• pageload
Event nachdem die Seite erfolgreich
ins DOM geladen wurde.

$( document ).bind( "pageload",
console.log("Seite wurde erfolgreich
ins DOM geladen...");
});

• pageloadfailed
Wird aufgerufen, wenn das Laden fehl
schlägt.


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 8/12
Apress
ISBN: 978-1430239666

• pagebeforehide
Wird auf der Seite getriggert von der
die Animation startet. Wird nur
abgefeuert, wenn der Seitenwechsel
eine dedizierte „von“ Seite besitzt.

$( "#from-page-
id" ).live( "pagebeforehide", function( e,
data ){
console.log( "Der Seitenübergang
startet jetzt..." );
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 9/12
Apress
ISBN: 978-1430239666

• pagebeforeshow
Wird auf der Seite getriggert zu der
die Animation führen soll. Wird nur
abgefeuert, wenn der Seitenwechsel
eine dedizierte „zu“ Seite besitzt.

$( "#from-page-
id" ).live( "pagebeforeshow", function( e,
data ){
console.log( "Der Seitenübergang
startet jetzt..." );
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 10/12
Apress
ISBN: 978-1430239666

• pagehide
Wird auf der Seite getriggert von der
die Animation gestartet ist und die
nun versteckt ist.

$( "#from-page-id" ).live( "pagehide",
console.log( "Der Seitenübergang ist
fertig..." );
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 11/12
Apress
ISBN: 978-1430239666

• pageshow
Wird auf der Seite getriggert zu der
die Animation führen soll und die nun
sichtbar ist.

$( "#from-page-id" ).live( "pageshow",
console.log( "Der Seitenübergang ist
fertig..." );
});


Quelle Graﬁk:
Pro jQuery Mobile
Brad Broulik

EVENTS 12/12
Apress
ISBN: 978-1430239666

• pagechange
Letzter Event eines Seitenwechsels.

$( document ).bind( "pagechange",
console.log(“Change page
successfully completed...”);
var toPage = data.toPage;
var options = data.options;
});

• pagechangefailed
Wird getriggert, falls der
Seitenwechsel fehl schlägt.


WIDGETS
• Zugriff auf das jQuery Mobile Objekt:
$.mobile. bzw. jQuery.mobile

• Mögliche Widgets
page
dialog $.mobile.<widget_name>.prototype.
collapsible $.mobile.<widget_name>.prototype.options.
fieldcontain
navbar $.mobile.page.prototype.options
listview
checkboxradio gültig für
button
slider Instanzen: data-role="page"
textinput
selectmenu
controlgroup


DEFAULT CONFIGURATION

• Ändern von Default-Werten:
$(document).bind("mobileinit", function() {
$.mobile.pushStateEnabled = true;
$.mobile.loadingMessage = "Lädt...";
$.mobile.pageLoadErrorMessage = "Fehler!";
$.mobile.defaultPageTransition = "fade";
$.mobile.minScrollBack = 150;
$.mobile.activeBtnClass = "active-button";
$.mobile.ajaxEnabled = false;
$.mobile.allowCrossDomainPages = true;

// resultiert in <div data-typovision-role="page">
$.mobile.ns = "typovision";

...
});


DATA UTILITIES

• Zugriff auf die Data-Attribute
var buttons = $("a[data-role=button"]);
var buttons = $("a:jqmData(role='button')");

$("a").jqmRemoveData("transition"); // statt removedata
$("#button1").jqmData("theme", "a"); // statt data


PAGE UTILITIES
• Seiten-Funktionen

// activePage ist das <div>
var currentPageId = $.mobile.activePage.id;

// pageContainer ist das <body>
$.mobile.pageContainer...

// Laden einer externen Seite
$.mobile.changePage("external.html");

// Übergang zu einer internen Seite im selben Doc
$.mobile.changePage($("#pageId"));
$.mobile.changePage($("#page2"), {
transition: "slide",
reverse: true
});


API - CHANGEPAGE 1/2
• $.mobile.changePage( toPage, [options] )
• toPage (string oder jQuery collection)
• toPage: URL (contact.html) oder interne ID (#contact)
• toPage: jQuery collection ($("#contact"))
• options (object)
• transition (string, default: $.mobile.defaultTransition, „slide“)
Übergangs-Animations-Funktion
• reverse (boolean, default: false)
Ablauf der Animation: Vorwärts=false, Rückwärts=true
• changeHash (boolean, default: true)
Aktualisierung des Hash in der URL-Zeile
• role (string, default: „page“)
Das data-role Attribut. Kann „page“ oder „dialog“ sein
• pageContainer ( jQuery collection, default: $.mobile.pageContainer)
Speziﬁziert das Element, welches die Seite nach dem Laden enthält


API - CHANGEPAGE 2/2

• options (object) (Fortsetzung...)
• type (string, default: „get“)
Speziﬁziert die Methode des Ladens („get“ oder „post“)
• data (string oder object, default: undeﬁned)
Daten, die an den AJAX-Request gesendet werden
• reloadPage (boolean, default: false)
Forciert einen Reload der Seite, selbst wenn diese im DOM-Cache ist
• showLoadMsg (boolean, default: true)
Anzeigen einer Loading-Message während des Ladens
• fromHashChange (boolean, default: false)
Zeigt an, dass die Funktion aus einem hashchange Event aufgerufen wurde


CHANGEPAGE - BEISPIEL 1/2
• Beispiel 1

<script>
function viewProduct(idProduct) {
$.mobile.changePage("productdetail.php", {
method: "post",
data: {
action: 'getProduct',‘
id: idProduct
},
transition: "fade"
});
}
</script>

<a href="javascript:viewProduct(5200)" data-
role="button">Produkt-Details</a>

CHANGEPAGE - BEISPIEL 2/2

• Beispiel 2

/* Erstellung und Öffnen einer neuer Seite */

// Erstellung des Markups
var newPage = $("<div data-role=page data-url=hi><div
data-role=header><h1>Neuer Header</h1></div><div data-
role=content>Neuer Inhalt!</div></div>");

// Füge die Seite zum Seitencontainer hinzu
newPage.appendTo( $.mobile.pageContainer );

// Übergang zur neuen Seite einleiten
$.mobile.changePage( newPage );


DYNAMISCHE BUTTONS 1/4

• Grundstruktur des Markups
<div data-role="page" data-theme="b">
<h1>Dynamische Buttons</h1>
</div>
id="create-button1">Erzeuge Button1</a>

• Button ans Ende zufügen
$( "#create-button1" ).bind( "click", function() {
$( '<a href="http://jquerymobile.com"
id="button1" data-role="button"
data-icon="star" data-inline="true"
data-theme="a">Button1</a>' )
.appendTo( ".ui-content" )
.button();
});


• Button nach dem Klick-Button zufügen
$( "#create-button2" ).bind( "click",
function() {
$( '<a href="http://jquerymobile.com"
id="button2">Button2</a>' )
.insertAfter( "#create-button2" )
.button({
corners: true,
icon: "home",
inline: true,
shadow: true,
theme: 'a',
create: function(event) {
console.log( "Creating
button..." );
for (prop in event) {
console.log(prop +
' = ' + event[prop]);
}
}
})
});



• Input-Type Button zufügen und konﬁgurieren

$( '<input type="submit" id="button5" value="Button5" data-theme="a" /
>' )
.button();
});

$( '<input type="submit" id="button6" value="Button6" />' )
.button({
'icon': "home",
'inline': true,
'shadow': true,
'theme': 'a'
})
});



• Mehrere Buttons zufügen sowie Aktivierung/Deaktivierung

$( "#create-multiple-buttons" ).bind( "click", function() {
$( '<button id="button3" data-theme="a">Button3</
button>' ).insertAfter( "#create-multiple-buttons" );
$( '<button id="button4" data-theme="a">Button4</
button>' ).insertAfter( "#button3" );
$.mobile.pageContainer.trigger( "create" );
});

$( "#disable-button3" ).bind( "click", function() {
$( "#button3" ).button( "disable" );
});

$( "#enable-button3" ).bind( "click", function() {
$( "#button3" ).button( "enable" );
});


DYNAMISCHER TEXTINPUT

• Input-Felder dynamisch hinzufügen sowie De-/Aktivierung

• $( '<input type="text" name="text1" value="" data-theme="c" />' )
.insertAfter( "#firstName" )
.textinput();

$( '<input type="text" name="text2" id="text2" value="" />' )
.insertAfter( "#text1" )
.textinput({
theme: 'c'
});

$( "#text1" ).textinput( "disable" );

$( "#text1" ).textinput( "enable" );


DYNAMISCHE SELECTS

• Selectmenüs erzeugen

• $( '<select name="select1" id="select1" data-theme="e">...</select>' )
.insertAfter( "#foo" )
.selectmenu();

$( '<select name="select2" id="select2">...</select>' )
.insertAfter( "#select1" )
.selectmenu({
theme: "e",
overlayTheme: "c",
disabled: false,
nativeMenu: false
});

$( "#select1" ).selectmenu( "disable" );

$( "#select1" ).selectmenu( "enable" );


DYNAMISCHE RADIOBUTTONS

• Radiobuttons erzeugen

• $( '<fieldset data-role="controlgroup">
<legend>Map view:</legend>
<input type="radio" name="map" id="map1" value="Map" />
<label for="map1" data-theme="c">Map</label>...</fieldset>')
.insertAfter( "#radio1" );

$( '<fieldset data-role="controlgroup">
<legend>Map view:</legend>
<input type="radio" name="map" id="map1" value="Map" />
<label for="map1">Map</label>...</fieldset>' )
.insertAfter( "#radio1" );

$( "#map1" ).checkboxradio({ theme: "e" });
$( "#map2" ).checkboxradio({ theme: "e" });



DYNAMISCHE CHECKBOXEN

• Checkboxen erzeugen

• $( '<fieldset data-role="controlgroup">
<legend>Genre:</legend>
<input type="checkbox" name="genre" id="c1" />
<label for="c1" data-theme="c">Action</label>...</fieldset>' )
.insertAfter( "#element1" );


$( '<fieldset data-role="controlgroup">
<legend>Genre:</legend>
<input type="checkbox" name="genre" id="c3" />
<label for="c3">Action</label>...</fieldset>' )
.insertAfter( "#create-cb2" );

$( '#c3' ).checkboxradio({ theme: "e" });
$( '#c4' ).checkboxradio({ theme: "e" });



DYNAMISCHE SLIDER

• Slider erzeugen

• $( '<label for="s1">Brightness:</label>
<input type="range" name="s1" id="s1" min="0" max="9" data-theme="d"/>')
.insertAfter( "#element1" );
$( "#s1" ).slider();

• $( '<label for="s1">Brightness:</label>
<input type="range" name="s1" id="s1" min="0" max="10" />' )
.insertAfter( "#create-s2" );
$( "#s1" ).slider({
theme: "d",
trackTheme: "a",
disabled: false
});


DYNAMISCHE SWITCHES

• Switch erzeugen

• $( '<select name="switch1" data-role="slider" data-theme="c"></select>' )
.insertAfter( “#foo” )
.slider();

$( '<select name="switch2" id="switch2">...</select>' )
.insertAfter( “#switch1” )
.slider({
theme: "b",
trackTheme: "c",
disabled: false
});


jQuery Mobile Kompakt - das Kompendium - über 150 Seiten (typovision)

jQuery Mobile Kompakt - das Kompendium - über 150 Seiten (typovision)

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Was ist angesagt?

Was ist angesagt? (20)

Ähnlich wie jQuery Mobile Kompakt - das Kompendium - über 150 Seiten (typovision)

Ähnlich wie jQuery Mobile Kompakt - das Kompendium - über 150 Seiten (typovision) (20)

Mehr von die.agilen GmbH

Mehr von die.agilen GmbH (20)

jQuery Mobile Kompakt - das Kompendium - über 150 Seiten (typovision)