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

lamp 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

lamp 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.

lamp 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.

lamp 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.

lamp 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