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