jQuery Mobile Attributs de données


Attributs de données jQuery

Utilisation de jQuery MobileAttributs data-* de HTML5pour créer une apparence plus conviviale au toucher et plus attrayante pour les appareils mobiles.

Dans la liste de référence ci-dessous,les valeurs affichées en grassont les valeurs par défaut.


Boutons

Obsolète après la version 1.4. Utilisezles classes CSSà la place.Les liens hypertexte avecdata-role="button"`data-role="button"`. Les éléments button, les liens dans les barres d'outils et les champs de saisie sont automatiquement rendus comme des boutons sans avoir besoin d'ajouter `data-role="button"`.

Attributs de données Valeur Description
data-corners true | false Spécifie si le bouton a des coins arrondis
data-icon Référence des icônes Spécifie l'icône du bouton. Par défaut : aucune icône.
data-iconpos left | right | top | bottom | notext Spécifie la position de l'icône
data-iconshadow true | false Spécifie si l'icône du bouton a une ombre
data-inline true | false Spécifie si le bouton est en ligne
data-mini true | false Spécifie si le bouton est de petite taille ou de taille normale
data-shadow true | false Spécifie si le bouton a une ombre
data-theme Lettres (a-z) Spécifie la couleur de thème du bouton

lamp Pour combiner plusieurs boutons, utilisez un conteneur avec `data-role="controlgroup"` et `data-type="horizontal|vertical"` pour spécifier si les boutons doivent être groupés horizontalement ou verticalement.


Cases à cocher

avectype="checkbox"des paires de label et input. Elles sont automatiquement rendues sous forme de boutons ; data-role n'est pas requis.

Attributs de données Valeur Description
data-mini true | false Spécifie si la case à cocher est de taille réduite ou normale
data-role none Empêche jQuery Mobile de rendre la case à cocher sous forme de bouton
data-theme Lettres (a-z) Spécifie la couleur de thème de la case à cocher

lamp Pour combiner plusieurs cases à cocher, utilisez un conteneur avec `data-role="controlgroup"` et `data-type="horizontal|vertical"` pour spécifier si les cases à cocher doivent être groupées horizontalement ou verticalement.


Blocs pliables

Dans un conteneur avecdata-role="collapsible"`data-role="collapsible"`, un élément de titre suivi de n'importe quel balisage HTML.

Attributs de données Valeur Description
data-collapsed true | false Spécifie si le contenu est replié ou déplié
data-collapsed-icon Référence des icônes Spécifie l'icône du bouton repliable. La valeur par défaut est "plus".
data-content-theme Lettres (a-z) Spécifie la couleur de thème du contenu repliable. Indique s'il faut ajouter des coins arrondis au contenu repliable.
data-expanded-icon Référence des icônes Spécifie l'icône du bouton repliable lorsque le contenu est déplié. La valeur par défaut est "minus".
data-iconpos left | right | top | bottom Spécifie la position de l'icône
data-inset true | false Spécifie si le bouton repliable est rendu avec des coins arrondis et des marges
data-mini true | false Spécifie si le bouton repliable est de petite taille ou de taille normale
data-theme Lettres (a-z) Spécifie la couleur de thème du bouton repliable


Ensembles pliables

Dans un conteneur avecdata-role="collapsible-set"`data-role="collapsible-set"`, blocs de contenu repliables.

Attributs de données Valeur Description
data-collapsed-icon Référence des icônes Spécifie l'icône du bouton repliable. La valeur par défaut est "plus".
data-content-theme Lettres (a-z) Spécifie la couleur de thème du bouton repliable
data-expanded-icon Référence des icônes Spécifie l'icône du bouton repliable lorsque le contenu est déplié. La valeur par défaut est "minus".
data-iconpos left | right | top | bottom | notext Spécifie la position de l'icône
data-inset true | false Spécifie si les blocs repliables sont rendus avec des coins arrondis et des marges
data-mini true | false Spécifie si le bouton repliable est de petite taille ou de taille normale
data-theme Lettres (a-z) Spécifie la couleur du thème de l'ensemble repliable


Contenu

Obsolète en version 1.4, n'est plus pris en charge après la version 1.5.Utilisez-role="content"un conteneur avec `data-role="content"`.

Attributs de données Valeur Description
data-theme Lettres (a-z) Spécifie la couleur du thème du contenu.


Groupes de contrôles

avecdata-role="controlgroup"`data-role="controlgroup"` un conteneur `<div>` ou `<fieldset>`. Regroupe plusieurs champs de formulaire stylisés en boutons d'un même type (boutons basés sur des liens, boutons radio, cases à cocher, éléments select). Pour regrouper les cases à cocher et les boutons radio d'un formulaire, il est recommandé d'utiliser un conteneur `<fieldset>` à l'intérieur d'un `<div>` avec `data-role="fieldcontain"` pour améliorer le style des libellés.

Attributs de données Valeur Description
data-mini true | false Spécifie si le groupe de contrôles est de petite taille ou de taille normale
data-type horizontal | vertical Spécifie si le groupe de contrôles est affiché horizontalement ou verticalement


Boîtes de dialogue

avecdata-role="dialog"`data-role="dialog"` un conteneur, ou avecdata-rel="dialog"`data-rel="dialog"` un lien.

Attributs de données Valeur Description
data-close-btn-text un texte Spécifie le texte pour le bouton de fermeture du dialogue
data-dom-cache true | false Spécifie s'il faut vider le cache DOM de jQuery pour les pages individuelles (si défini sur true, vous devez gérer le DOM vous-même et tester sur tous les appareils mobiles)
data-overlay-theme Lettres (a-z) Spécifie la couleur du masque (arrière-plan) de la page de dialogue
data-theme Lettres (a-z) Spécifie la couleur du thème de la page de dialogue
data-title un texte Spécifie le titre de la page de dialogue


Amélioration

avecdata-enhance="false"oudata-ajax="false"`data-enhance="false"` conteneur.

Attributs de données Valeur Description
data-enhance true | false Si défini sur "true" (par défaut), jQuery Mobile améliorera automatiquement la page pour la rendre plus adaptée aux appareils mobiles. Si défini sur "false", le framework n'améliorera pas la page.
data-ajax true | false Spécifie si la page est chargée via AJAX

Remarque :`data-enhance="false"` doit être utilisé conjointement avec `$.mobile.ignoreContentEnabled=true` pour empêcher jQuery Mobile d'améliorer automatiquement la page.

Lorsque `$.mobile.ignoreContentEnabled` est défini sur true, tous les liens ou éléments de formulaire à l'intérieur d'un conteneur `data-ajax="false"` seront ignorés par la fonctionnalité de navigation du framework.


Conteneurs de champs

Obsolète après la version 1.4, n'est plus pris en charge après la version 1.5. Utilisez plutôt `class="ui-fieldcontain"`.Enveloppe les paires étiquette/élément de formulaire, avecdata-role="fieldcontain"`data-role="fieldcontain"` conteneur.


Barres d'outils fixes

avecdata-role="header"oudata-role="footer", et avecdata-position="fixed"Conteneur d'attribut `data-position="fixed"`.

Attributs de données Valeur Description
data-disable-page-zoom true | false Spécifie si l'utilisateur peut zoomer la page
data-fullscreen true | false Spécifie si la barre d'outils est toujours fixée en haut ou en bas
data-tap-toggle true | false Spécifie si l'utilisateur peut basculer la visibilité de la barre d'outils en cliquant
data-transition slide | fade | none Spécifie l'effet de bascule lorsque le clic se produit
data-update-page-padding true | false Spécifie si la marge intérieure supérieure et inférieure de la page est mise à jour lors des événements resize, transition et "updatelayout" (jQuery Mobile met toujours à jour la marge intérieure lors de l'événement "pageshow")
data-visible-on-page-show true | false Spécifie la visibilité de la barre d'outils lorsque la page parente est affichée


Interrupteurs à bascule

Un avecdata-role="slider"l'élément `<select>` et deux éléments `<option>`.

Attributs de données Valeur Description
data-mini true | false Spécifie si l'interrupteur est de taille petite ou normale
data-role none Empêche jQuery Mobile d'afficher l'interrupteur à bascule comme un bouton
data-theme Lettres (a-z) Spécifie la couleur du thème de l'interrupteur à bascule
data-track-theme Lettres (a-z) Spécifie la couleur du thème de la piste


Barre de pied de page

avec un conteneurdata-role="footer".

Attribut de données Valeur Description
data-id un texte Spécifie un ID unique. Obligatoire pour les pieds de page persistants.
data-position inline | fixed Spécifie si le pied de page est en ligne avec le contenu de la page ou reste fixé en bas.
data-fullscreen true | false Indique si le pied de page est fixé en bas ou se superpose au contenu de la page (pour une zone d'affichage plus grande).
data-theme Lettre (a-z) Spécifie la couleur du thème du pied de page. La valeur par défaut est "a".

Remarque :Pour activer le positionnement plein écran, utilisez data-position="fixed" puis ajoutez l'attribut data-fullscreen à l'élément.


Barre d'en-tête

avecdata-role="header"conteneur.

Attribut de données Valeur Description
data-id un texte Spécifie un identifiant unique. Obligatoire pour les en-têtes persistants.
data-position inline | fixed Spécifie si l'en-tête est en ligne avec le contenu de la page ou reste fixé en haut.
data-fullscreen true | false Spécifie si l'en-tête est fixé en haut ou se superpose au contenu de la page (pour une zone d'affichage plus grande).
data-theme Lettre (a-z) Spécifie la couleur du thème de l'en-tête. La valeur par défaut est "a".

Remarque :Pour activer le positionnement plein écran, utilisez data-position="fixed" puis ajoutez l'attribut data-fullscreen à l'élément.


Liens

Tous les liens, y compris ceux avec data-role="button" et les boutons d'envoi de formulaire.

Attribut de données Valeur Description
data-ajax true | false Spécifie s'il faut charger les pages via ajax pour améliorer l'expérience utilisateur et l'interaction. Si défini sur false, jQuery Mobile effectuera une requête de page normale.
data-direction reverse Animation de transition inversée (uniquement pour les pages et les dialogues)
data-dom-cache true | false Spécifie s'il faut vider le cache DOM jQuery pour chaque page (si défini sur true, vous devez gérer le DOM vous-même et tester sur tous les appareils mobiles).
data-prefetch true | false Spécifie s'il faut précharger les pages dans le DOM afin qu'elles soient disponibles lorsque l'utilisateur les visite.
data-rel back | dialog | external | popup Spécifie les options de comportement des liens. Back - revient à la page précédente dans l'historique. Dialog - ouvre le lien en tant que dialogue, non enregistré dans l'historique. External - utilisé pour créer un lien vers un autre domaine. Popup - ouvre une popup.
data-transition fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none Spécifie l'effet lors du passage d'une page à la suivante. Consultez notre sectionTransitions de pages jQuery Mobile.
data-position-to origin | jQuery selector | window Spécifie la position de la popup. Origin - Par défaut. Positionne la popup sur le lien qui l'ouvre. jQuery selector - Positionne la popup sur l'élément spécifié. Window - Positionne la popup au centre de l'écran de la fenêtre.


Listes

avecdata-role="listview"le <ol> ou <ul>.

Attribut de données Valeur Description
data-autodividers true | false Spécifie s'il faut diviser automatiquement les éléments de la liste.
data-count-theme Lettre (a-z) Spécifie la couleur du thème de la bulle de comptage.
data-divider-theme Lettre (a-z) Spécifie la couleur du thème des séparateurs de liste.
data-filter true | false Spécifie s'il faut ajouter une zone de recherche à la liste.
data-filter-placeholder un texte Obsolète après la version 1.4. Utilisez plutôt l'attribut placeholder HTML.Spécifie le texte à l'intérieur de la zone de recherche. La valeur par défaut est "Filtrer les éléments..."
data-filter-theme Lettre (a-z) Spécifie la couleur du thème du filtre de recherche.
data-icon Référence d'icône Spécifie l'icône de la liste.
data-inset true | false Spécifie si la liste est rendue avec des coins arrondis et des marges.
data-split-icon Référence d'icône Spécifie l'icône du bouton divisé. La valeur par défaut est "arrow-r".
data-split-theme Lettre (a-z) Spécifie la couleur du thème du bouton divisé.
data-theme Lettre (a-z) Spécifie la couleur du thème de la liste.


Éléments de liste

avecdata-role="listview"le <li> à l'intérieur d'un <ol> ou <ul>.

Attribut de données Valeur Description
data-filtertext un texte Spécifie le texte à rechercher lors du filtrage des éléments. Ce texte sera filtré au lieu du texte réel de l'élément de liste.
data-icon Référence d'icône Spécifie l'icône de l'élément de liste.
data-role list-divider Spécifie le séparateur de l'élément de liste.
data-theme Lettre (a-z) Spécifie la couleur du thème de l'élément de liste.

Remarque :L'attribut data-icon ne fonctionne que sur les éléments de liste comportant des liens.


Barres de navigation

avecdata-role="navbar"les éléments <li> à l'intérieur d'un conteneur.

Attribut de données Valeur Description
data-icon Référence d'icône Spécifie l'icône pour l'élément de liste.
data-iconpos left | right | top | bottom | notext Spécifie la position de l'icône.

lamp Les barres de navigation héritent de l'échantillon de thème de leur conteneur parent. Il n'est pas possible de définir l'attribut data-theme pour la barre de navigation. Vous pouvez définir l'attribut data-theme individuellement pour chaque lien dans la barre de navigation.


Pages

avecdata-role="page"le conteneur.

Attribut de données Valeur Description
data-add-back-btn true | false Ajoute automatiquement un bouton de retour, uniquement dans les barres d'en-tête.
data-back-btn-text un texte Spécifie le texte du bouton de retour.
data-back-btn-theme Lettre (a-z) Spécifie la couleur du thème du bouton de retour.
data-close-btn-text Lettre (a-z) Spécifie le texte du bouton de fermeture des boîtes de dialogue.
data-dom-cache true | false Spécifie s'il faut vider le cache DOM jQuery pour chaque page (si défini sur true, vous devez gérer le DOM vous-même et tester sur tous les appareils mobiles).
data-overlay-theme Lettre (a-z) Spécifie la couleur de superposition (d'arrière-plan) de la page de dialogue.
data-theme Lettre (a-z) Spécifie la couleur du thème de la page.
data-title un texte Spécifie le titre de la page.
data-url url Met à jour la valeur de l'URL, plutôt que l'URL utilisée pour demander la page.


Popups

avecdata-role="popup"le conteneur.

Attribut de données Valeur Description
data-corners true | false Spécifie si la popup est arrondie.
data-overlay-theme Lettre (a-z) Spécifie la couleur de superposition (d'arrière-plan) de la popup. Par défaut, l'arrière-plan est transparent (none).
data-shadow true | false Spécifie si la popup a une ombre.
data-theme Lettre (a-z) Spécifie la couleur du thème de la popup. La valeur par défaut est héritée, "none" rend la popup transparente.
data-tolerance 30, 15, 30, 15 Spécifie la distance par rapport aux bords de la fenêtre (haut, droite, bas, gauche).

avecdata-rel="popup"l'ancre :

Attribut de données Valeur Description
data-position-to origin | jQuery selector | window >Spécifie la position de la popup. Origin - Par défaut. Positionne la popup sur le lien qui l'ouvre. Sélecteur jQuery - Positionne la popup sur l'élément spécifié. Window - Positionne la popup au centre de la fenêtre.
data-rel popup Utilisé pour ouvrir la popup
data-transition fade | flip | flow | pop | slide | slidedown slidefade | slideup | turn | none Spécifie l'effet lors du passage d'une page à la suivante. Consultez notre sectionTransitions de pages jQuery Mobile.


Boutons radio

avectype="radio"le label et l'input associés. Ils sont automatiquement rendus avec des styles de bouton, data-role n'est pas requis.

Attribut de données Valeur Description
data-mini true | false Spécifie si le bouton est de petite taille ou de taille normale.
data-role none Empêche jQuery Mobile de rendre le bouton radio comme un bouton amélioré, ce qui laisse l'élément dans son état natif.
data-theme Lettre (a-z) Spécifie la couleur de thème du bouton radio.

lamp Pour regrouper des boutons radio, utilisez un conteneur avec data-role="controlgroup" et data-type="horizontal" pour spécifier si les boutons radio doivent être regroupés horizontalement ou verticalement.


Sélection

Tous les éléments<select>. Ceux-ci sont automatiquement rendus avec des styles de bouton, data-role n'est pas requis.

Attribut de données Valeur Description
data-icon Référence d'icône Spécifie l'icône pour l'élément select. La valeur par défaut est "arrow-d".
data-iconpos left | right | top | bottom | notext Spécifie la position de l'icône.
data-inline true | false Spécifie si l'élément select est en ligne.
data-mini true | false Spécifie si l'élément select est de petite taille ou de taille normale.
data-native-menu true | false Lorsqu'il est défini sur false, il utilise le menu de sélection personnalisé intégré de jQuery (recommandé si vous souhaitez que le menu de sélection ait le même aspect sur tous les appareils mobiles).
data-overlay-theme Lettre (a-z) Spécifie la couleur de thème du menu de sélection personnalisé intégré de jQuery (utilisé avec data-native-menu="false").
data-placeholder true | false Peut être défini sur un élément <option> d'un menu de sélection non natif.
data-role none Empêche jQuery Mobile de rendre l'élément select avec un style de bouton.
data-theme Lettre (a-z) Spécifie la couleur de thème de l'élément select.

lamp Pour combiner plusieurs éléments select, utilisez un conteneur avec l'attribut data-role="controlgroup" et data-type="horizontal|vertical" pour spécifier si les éléments select doivent être groupés horizontalement ou verticalement.


Slider

avectype="range"champs de saisie. Ceux-ci sont automatiquement rendus avec des styles de bouton, date-role n'est pas requis.

Attribut de données Valeur Description
data-highlight true | false Spécifie si la piste du curseur est mise en surbrillance
data-mini true | false Spécifie si le curseur est de petite taille ou de taille normale
data-role none Empêche jQuery Mobile de rendre le contrôle de curseur avec un style de bouton
data-theme Lettre (a-z) Spécifie la couleur de thème du contrôle de curseur (champ de saisie, poignée et piste)
data-track-theme Lettre (a-z) Spécifie la couleur de thème de la piste du curseur


Champs de saisie textuels et zones de texte

avectype="text|search|etc."input ouélément textarea. Ceux-ci sont automatiquement rendus avec des styles de bouton, date-role n'est pas requis.

Attribut de données Valeur Description
data-mini true | false Spécifie si le champ de saisie est de petite taille ou de taille normale
data-role none Empêche jQuery Mobile de rendre les champs de saisie/zones de texte avec des styles de bouton
data-theme Lettre (a-z) Spécifie la couleur de thème du champ de saisie


Autres extensions