jQuery Mobile Datenattribute
jQuery-Datenattribute
Verwendung von jQuery MobileHTML5-data-*-Attribute, um ein berührungsfreundlicheres und attraktiveres Erscheinungsbild für mobile Geräte zu erzeugen.
In der unten stehenden Referenzliste sindfett dargestellte Wertedie Standardwerte.
Schaltflächen
Nach Version 1.4 veraltet. Verwenden SieCSS-Klassenstattdessen.Hyperlinks mitdata-role="button"`data-role="button"`. Button-Elemente, Links in Toolbars und Eingabefelder werden automatisch als Buttons gerendert, ohne dass `data-role="button"` hinzugefügt werden muss.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-corners | true | false | Gibt an, ob die Schaltfläche abgerundete Ecken hat |
| data-icon | Icon-Referenz | Gibt das Icon für den Button an. Standardmäßig ist kein Icon vorhanden. |
| data-iconpos | left | right | top | bottom | notext | Gibt die Position des Icons an |
| data-iconshadow | true | false | Gibt an, ob das Button-Icon einen Schatten hat |
| data-inline | true | false | Gibt an, ob der Button inline ist |
| data-mini | true | false | Gibt an, ob der Button klein oder in regulärer Größe ist |
| data-shadow | true | false | Gibt an, ob der Button einen Schatten hat |
| data-theme | Buchstaben (a-z) | Legt die Themefarbe des Buttons fest |
| Um mehrere Buttons zu kombinieren, verwenden Sie einen Container mit `data-role="controlgroup"` und `data-type="horizontal|vertical"`, um anzugeben, ob die Buttons horizontal oder vertikal gruppiert werden sollen. |
Checkboxen
mittype="checkbox"Paaren aus label und input. Sie werden automatisch als Buttons gerendert; data-role ist nicht erforderlich.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-mini | true | false | Legt fest, ob das Kontrollkästchen klein oder normal groß ist |
| data-role | none | Verhindert, dass jQuery Mobile das Kontrollkästchen als Button rendert |
| data-theme | Buchstaben (a-z) | Legt die Themefarbe des Kontrollkästchens fest |
| Um mehrere Kontrollkästchen zu kombinieren, verwenden Sie einen Container mit `data-role="controlgroup"` und `data-type="horizontal|vertical"`, um anzugeben, ob die Kontrollkästchen horizontal oder vertikal gruppiert werden sollen. |
Einklappbare Blöcke
In einem Container mitdata-role="collapsible"`data-role="collapsible"`, ein Überschriftenelement, gefolgt von beliebigem HTML-Markup.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-collapsed | true | false | Legt fest, ob der Inhalt eingeklappt oder ausgeklappt ist |
| data-collapsed-icon | Icon-Referenz | Gibt das Symbol für die einklappbare Schaltfläche an. Standard ist "plus". |
| data-content-theme | Buchstaben (a-z) | Gibt die Themenfarbe des einklappbaren Inhalts an. Gibt an, ob dem einklappbaren Inhalt abgerundete Ecken hinzugefügt werden. |
| data-expanded-icon | Icon-Referenz | Gibt das Symbol für die einklappbare Schaltfläche an, wenn der Inhalt ausgeklappt ist. Standard ist "minus". |
| data-iconpos | left | right | top | bottom | Gibt die Position des Icons an |
| data-inset | true | false | Gibt an, ob die einklappbare Schaltfläche mit abgerundeten Ecken und Rändern dargestellt wird |
| data-mini | true | false | Gibt an, ob die einklappbare Schaltfläche klein oder normal groß ist |
| data-theme | Buchstaben (a-z) | Gibt die Themenfarbe der einklappbaren Schaltfläche an |
Einklappbare Sets
In einem Container mitdata-role="collapsible-set"`data-role="collapsible-set"`, einklappbare Inhaltsblöcke.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-collapsed-icon | Icon-Referenz | Gibt das Symbol für die einklappbare Schaltfläche an. Standard ist "plus". |
| data-content-theme | Buchstaben (a-z) | Gibt die Themenfarbe der einklappbaren Schaltfläche an |
| data-expanded-icon | Icon-Referenz | Gibt das Symbol für die einklappbare Schaltfläche an, wenn der Inhalt ausgeklappt ist. Standard ist "minus". |
| data-iconpos | left | right | top | bottom | notext | Gibt die Position des Icons an |
| data-inset | true | false | Gibt an, ob die einklappbaren Blöcke mit abgerundeten Ecken und Außenabständen gerendert werden |
| data-mini | true | false | Gibt an, ob die einklappbare Schaltfläche klein oder normal groß ist |
| data-theme | Buchstaben (a-z) | Gibt die Themenfarbe des einklappbaren Sets an |
Inhalt
Veraltet in Version 1.4, ab Version 1.5 nicht mehr unterstützt.Verwenden Siedata-role="content"einen Container mit `data-role="content"`.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-theme | Buchstaben (a-z) | Gibt die Themenfarbe des Inhalts an. |
Kontrollgruppen
mitdata-role="controlgroup"`data-role="controlgroup"` `<div>`- oder `<fieldset>`-Container. Gruppiert mehrere schaltflächenartig gestaltete Eingabeelemente eines einzelnen Typs (linkbasierte Schaltflächen, Optionsfelder, Kontrollkästchen, Auswahlelemente). Zum Gruppieren von Formular-Kontrollkästchen und Optionsfeldern wird empfohlen, einen `<fieldset>`-Container innerhalb eines `<div>` mit `data-role="fieldcontain"` zu verwenden, um die Label-Formatierung zu verbessern.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-mini | true | false | Gibt an, ob die Kontrollgruppe klein oder normal groß ist |
| data-type | horizontal | vertikal | Gibt an, ob die Kontrollgruppe horizontal oder vertikal angezeigt wird |
Dialoge
mitdata-role="dialog"`data-role="dialog"`-Container oder mitdata-rel="dialog"`data-rel="dialog"`-Link.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-close-btn-text | irgendein Text | Gibt den Text für die Schaltfläche zum Schließen des Dialogs an |
| data-dom-cache | true | false | Gibt an, ob der jQuery-DOM-Cache für einzelne Seiten geleert werden soll (wenn auf true gesetzt, müssen Sie das DOM selbst verwalten und auf allen mobilen Geräten testen) |
| data-overlay-theme | Buchstaben (a-z) | Gibt die Masken- (Hintergrund-)Farbe der Dialogseite an |
| data-theme | Buchstaben (a-z) | Gibt die Themenfarbe der Dialogseite an |
| data-title | irgendein Text | Gibt den Titel der Dialogseite an |
Erweiterung
mitdata-enhance="false"oderdata-ajax="false"`data-enhance="false"` Container.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-enhance | true | false | Wenn auf "true" (Standard) gesetzt, wird jQuery Mobile die Seite automatisch erweitern, um sie für mobile Geräte besser geeignet zu machen. Wenn auf "false" gesetzt, wird das Framework die Seite nicht erweitern. |
| data-ajax | true | false | Gibt an, ob die Seite über AJAX geladen wird |
Hinweis:`data-enhance="false"` muss zusammen mit `$.mobile.ignoreContentEnabled=true` verwendet werden, um zu verhindern, dass jQuery Mobile die Seite automatisch verbessert.
Wenn `$.mobile.ignoreContentEnabled` auf true gesetzt ist, werden alle Links oder Formularelemente innerhalb eines `data-ajax="false"`-Containers von der Navigationsfunktionalität des Frameworks ignoriert.
Feldcontainer
Veraltet seit Version 1.4, nicht mehr unterstützt seit Version 1.5. Verwenden Sie stattdessen `class="ui-fieldcontain"`.Umschließt Label/Form-Element-Paare, mitdata-role="fieldcontain"`data-role="fieldcontain"` Container.
Fixierte Toolbars
mitdata-role="header"oderdata-role="footer", und mitdata-position="fixed"`data-position="fixed"` Attribut-Container.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-disable-page-zoom | true | false | Gibt an, ob der Benutzer die Seite zoomen kann |
| data-fullscreen | true | false | Gibt an, ob die Toolbar immer oben oder unten fixiert ist |
| data-tap-toggle | true | false | Gibt an, ob der Benutzer die Sichtbarkeit der Symbolleiste durch Klicken umschalten kann |
| data-transition | slide | fade | none | Gibt den Umschalteffekt beim Klicken an |
| data-update-page-padding | true | false | Gibt an, ob der obere und untere Innenabstand der Seite bei resize-, transition- und "updatelayout"-Ereignissen aktualisiert wird (jQuery Mobile aktualisiert den Innenabstand immer beim "pageshow"-Ereignis) |
| data-visible-on-page-show | true | false | Gibt die Sichtbarkeit der Symbolleiste an, wenn die übergeordnete Seite angezeigt wird |
Flip-Umschalter
Eines mitdata-role="slider"dem `<select>`-Element und zwei `<option>`-Elementen.
| Datenattribute | Wert | Beschreibung |
|---|---|---|
| data-mini | true | false | Gibt an, ob der Schalter eine kleine oder reguläre Größe hat |
| data-role | none | Verhindert, dass jQuery Mobile den Umschalter als Schaltfläche rendert |
| data-theme | Buchstaben (a-z) | Legt die Theme-Farbe des Umschalters fest |
| data-track-theme | Buchstaben (a-z) | Legt die Theme-Farbe des Tracks fest |
Fußleiste
mitdata-role="footer"Container.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-id | irgendein Text | Legt eine eindeutige ID fest. Erforderlich für persistente Fußleisten. |
| data-position | inline | fixed | Legt fest, ob die Fußleiste inline mit dem Seiteninhalt angeordnet ist oder am unteren Rand fixiert bleibt. |
| data-fullscreen | true | false | Gibt an, ob die Fußzeile am unteren Rand fixiert ist oder den Seiteninhalt überlagert (für einen größeren Anzeigebereich). |
| data-theme | Buchstabe (a-z) | Gibt die Themenfarbe der Fußzeile an. Standard ist "a". |
Hinweis:Um die Vollbildpositionierung zu aktivieren, verwenden Sie data-position="fixed" und fügen Sie dann dem Element das Attribut data-fullscreen hinzu.
Kopfleiste
mitdata-role="header"Container.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-id | irgendein Text | Gibt eine eindeutige ID an. Erforderlich für persistente Kopfzeilen. |
| data-position | inline | fixed | Gibt an, ob die Kopfzeile inline mit dem Seiteninhalt ist oder oben fixiert bleibt. |
| data-fullscreen | true | false | Gibt an, ob die Kopfzeile oben fixiert ist oder den Seiteninhalt überlagert (für einen größeren Anzeigebereich). |
| data-theme | Buchstabe (a-z) | Gibt die Themenfarbe der Kopfzeile an. Standard ist "a". |
Hinweis:Um die Vollbildpositionierung zu aktivieren, verwenden Sie data-position="fixed" und fügen Sie dann dem Element das Attribut data-fullscreen hinzu.
Links
Alle Links, einschließlich derer mit data-role="button" und den Absende-Schaltflächen von Formularen.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-ajax | true | false | Gibt an, ob Seiten per Ajax geladen werden sollen, um Benutzererfahrung und Interaktion zu verbessern. Wenn auf false gesetzt, führt jQuery Mobile eine normale Seitenanforderung aus. |
| data-direction | reverse | Umgekehrte Übergangsanimation (nur für Seiten und Dialoge) |
| data-dom-cache | true | false | Gibt an, ob der jQuery-DOM-Cache für jede Seite geleert werden soll (wenn auf true gesetzt, müssen Sie das DOM selbst verwalten und auf allen Mobilgeräten testen). |
| data-prefetch | true | false | Gibt an, ob Seiten in das DOM vorgeladen werden sollen, sodass sie verfügbar sind, wenn der Benutzer sie besucht. |
| data-rel | back | dialog | external | popup | Gibt die Optionen für das Linkverhalten an. Back – geht zur vorherigen Seite im Verlauf zurück. Dialog – öffnet den Link als Dialog, der nicht im Verlauf gespeichert wird. External – wird für die Verlinkung zu einer anderen Domain verwendet. Popup – öffnet ein Popup. |
| data-transition | fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none | Gibt den Effekt an, wenn von einer Seite zur nächsten gewechselt wird. Sehen Sie sich unseren Abschnitt zujQuery Mobile Seitenübergängenan. |
| data-position-to | origin | jQuery selector | window | Gibt die Position des Popups an. Origin – Standard. Positioniert das Popup auf dem Link, der es öffnet. jQuery selector – Positioniert das Popup auf dem angegebenen Element. Window – Positioniert das Popup in der Mitte des Fensters. |
Listen
mitdata-role="listview"dem <ol> oder <ul>.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-autodividers | true | false | Gibt an, ob Listeneinträge automatisch unterteilt werden. |
| data-count-theme | Buchstabe (a-z) | Gibt die Themenfarbe der Zählerblase an. |
| data-divider-theme | Buchstabe (a-z) | Gibt die Themenfarbe der Listentrenner an. |
| data-filter | true | false | Gibt an, ob der Liste ein Suchfeld hinzugefügt wird. |
| data-filter-placeholder | irgendein Text | Seit Version 1.4 veraltet. Verwenden Sie stattdessen das HTML-Attribut placeholder.Gibt den Text im Suchfeld an. Standard ist "Filter items..." |
| data-filter-theme | Buchstabe (a-z) | Legt die Themenfarbe des Suchfilters fest. |
| data-icon | Icon-Referenz | Legt das Icon der Liste fest. |
| data-inset | true | false | Legt fest, ob die Liste mit abgerundeten Ecken und Außenabständen gerendert wird. |
| data-split-icon | Icon-Referenz | Legt das Icon des Split-Buttons fest. Standard ist "arrow-r". |
| data-split-theme | Buchstabe (a-z) | Legt die Themenfarbe des Split-Buttons fest. |
| data-theme | Buchstabe (a-z) | Legt die Themenfarbe der Liste fest. |
Listeneinträge
mitdata-role="listview"das <li> innerhalb von <ol> oder <ul>.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-filtertext | irgendein Text | Gibt den Text an, nach dem beim Filtern von Elementen gesucht wird. Dieser Text wird anstelle des tatsächlichen Textes des Listeneintrags gefiltert. |
| data-icon | Icon-Referenz | Gibt das Symbol des Listeneintrags an. |
| data-role | list-divider | Gibt den Trenner des Listeneintrags an. |
| data-theme | Buchstabe (a-z) | Gibt die Theme-Farbe des Listeneintrags an. |
Hinweis:Das Attribut data-icon funktioniert nur bei Listeneinträgen mit Links.
Navigationsleisten
mitdata-role="navbar"den <li>-Elementen in einem Container.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-icon | Icon-Referenz | Gibt das Symbol für den Listeneintrag an. |
| data-iconpos | left | right | top | bottom | notext | Gibt die Position des Symbols an. |
| Navigationsleisten erben das Theme-Farbschema von ihrem übergeordneten Container. Es ist nicht möglich, das Attribut data-theme für die Navigationsleiste festzulegen. Sie können das Attribut data-theme für jeden Link in der Navigationsleiste einzeln festlegen. |
Seiten
mitdata-role="page"dem Container.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-add-back-btn | true | false | Automatisch eine Zurück-Schaltfläche, nur in Kopfleisten. |
| data-back-btn-text | irgendein Text | Gibt den Text für die Zurück-Schaltfläche an. |
| data-back-btn-theme | Buchstabe (a-z) | Gibt die Themenfarbe der Zurück-Schaltfläche an. |
| data-close-btn-text | Buchstabe (a-z) | Gibt den Text für die Schließen-Schaltfläche in Dialogen an. |
| data-dom-cache | true | false | Gibt an, ob der jQuery-DOM-Cache für jede Seite geleert werden soll (wenn auf true gesetzt, müssen Sie das DOM selbst verwalten und auf allen Mobilgeräten testen). |
| data-overlay-theme | Buchstabe (a-z) | Gibt die Overlay-(Hintergrund-)Farbe der Dialogseite an. |
| data-theme | Buchstabe (a-z) | Gibt die Themenfarbe der Seite an. |
| data-title | irgendein Text | Gibt den Seitentitel an. |
| data-url | url | Aktualisiert den URL-Wert statt der URL, die zum Anfordern der Seite verwendet wird. |
Popups
mitdata-role="popup"dem Container.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-corners | true | false | Gibt an, ob das Popup abgerundet ist. |
| data-overlay-theme | Buchstabe (a-z) | Gibt die Overlay-(Hintergrund-)Farbe des Popups an. Standard ist transparenter Hintergrund (none). |
| data-shadow | true | false | Gibt an, ob das Popup einen Schatten hat. |
| data-theme | Buchstabe (a-z) | Gibt die Theme-Farbe des Popups an. Standard ist geerbt, "none" setzt das Popup auf transparent. |
| data-tolerance | 30, 15, 30, 15 | Gibt den Abstand zu den Fensterrändern an (oben, rechts, unten, links). |
mitdata-rel="popup"dem Anker:
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-position-to | origin | jQuery selector | window | >Gibt die Position des Popups an. Origin - Standard. Positioniert das Popup auf dem Link, der es öffnet. jQuery-Selektor - Positioniert das Popup auf dem angegebenen Element. Window - Positioniert das Popup in der Mitte des Fensters. |
| data-rel | Popup | Wird verwendet, um das Popup zu öffnen. |
| data-transition | fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none | Gibt den Effekt an, wenn von einer Seite zur nächsten gewechselt wird. Sehen Sie sich unseren Abschnitt zujQuery Mobile Seitenübergängenan. |
Optionsfelder
Mittype="radio"dem zugehörigen Label und Eingabefeld. Sie werden automatisch als Button-Stile gerendert, data-role ist nicht erforderlich.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-mini | true | false | Gibt an, ob der Button klein oder in regulärer Größe ist. |
| data-role | none | Verhindert, dass jQuery Mobile den Radio-Button als verbesserten Button rendert, wodurch das Element in seinem nativen HTML-Zustand angezeigt wird. |
| data-theme | Buchstabe (a-z) | Gibt die Themenfarbe des Radio-Buttons an. |
| Um mehrere Radio-Buttons zu gruppieren, verwenden Sie einen Container mit dem Attribut data-role="controlgroup" und data-type="horizontal|vertical", um anzugeben, ob die Radio-Buttons horizontal oder vertikal gruppiert werden sollen. |
Auswählen
Alle<select>-Elemente. Diese werden automatisch als Button-Stile gerendert, data-role ist nicht erforderlich.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-icon | Icon-Referenz | Gibt das Icon für das Select-Element an. Standard ist "arrow-d". |
| data-iconpos | left | right | top | bottom | notext | Gibt die Position des Symbols an. |
| data-inline | true | false | Gibt an, ob das Select-Element inline ist. |
| data-mini | true | false | Gibt an, ob das select-Element klein oder in regulärer Größe dargestellt wird. |
| data-native-menu | true | false | Wenn auf false gesetzt, wird das integrierte benutzerdefinierte Select-Menü von jQuery verwendet (empfohlen, wenn das Select-Menü auf allen mobilen Geräten gleich aussehen soll). |
| data-overlay-theme | Buchstabe (a-z) | Gibt die Theme-Farbe des integrierten benutzerdefinierten Select-Menüs von jQuery an (wird mit data-native-menu="false" verwendet). |
| data-placeholder | true | false | Kann an einem <option>-Element eines nicht-nativen Select-Menüs festgelegt werden. |
| data-role | none | Verhindert, dass jQuery Mobile das select-Element als Button-Stil rendert. |
| data-theme | Buchstabe (a-z) | Gibt die Theme-Farbe des select-Elements an. |
| Um mehrere select-Elemente zu kombinieren, verwenden Sie einen Container mit dem Attribut data-role="controlgroup" und data-type="horizontal|vertical", um anzugeben, ob die select-Elemente horizontal oder vertikal gruppiert werden sollen. |
Slider
mittype="range"Eingabefeldern. Diese werden automatisch im Button-Stil gerendert; date-role ist nicht erforderlich.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-highlight | true | false | Gibt an, ob die Slider-Spur hervorgehoben wird. |
| data-mini | true | false | Gibt an, ob der Slider klein oder regulär ist |
| data-role | none | Verhindert, dass jQuery Mobile das Slider-Steuerelement als Stil rendert |
| data-theme | Buchstabe (a-z) | Gibt die Themenfarbe des Slider-Steuerelements an (Input, Handle, Track) |
| data-track-theme | Buchstabe (a-z) | Gibt die Themenfarbe der Slider-Spur an |
Texteingaben & Textareas
mit⟧type="text|search|etc."input oderElement. Diese werden automatisch als Button-Stile gerendert, date-role ist nicht erforderlich.. These are automatically rendered as button styles, date-role is not required.
| Datenattribut | Wert | Beschreibung |
|---|---|---|
| data-mini | true | false | Gibt an, ob das Eingabefeld klein oder regulär ist |
| data-role | none | Verhindert, dass jQuery Mobile Eingabefelder/Textbereiche als Button-Stile rendert |
| data-theme | Buchstabe (a-z) | Gibt die Themenfarbe des Eingabefelds an |
Andere Erweiterungen