Popups jQuery Mobile
Une popup est une boîte de dialogue très populaire qui peut être affichée en superposition sur la page.
Les popups peuvent être utilisées pour afficher du texte, des images, des cartes ou d'autres contenus.
Pour créer une popup, utilisez les éléments <a> et <div>. Ajoutez l'attribut data-rel="popup" à l'élément <a>, et ajoutez l'attribut data-role="popup" à l'élément <div>. Spécifiez ensuite un id pour le <div>, et définissez le href du <a> sur l'id spécifié pour le <div>. Le contenu à l'intérieur du <div> est ce que la popup affiche.
Remarque :La popup <div> et le lien <a> cliqué doivent être sur la même page.
Exemple
<div data-role="popup" id="myPopup">
<p>Ceci est une simple fenêtre contextuelle</p>
</div>
Essayez-le vous-même »
Si vous avez besoin d'ajouter du padding et des marges à la fenêtre contextuelle, ajoutez la classe "ui-content" à la balise <div> :
Fermer la fenêtre contextuelle
Par défaut, cliquer en dehors de la zone de la fenêtre contextuelle ou appuyer sur la touche "Esc" ferme la fenêtre contextuelle. Si vous ne voulez pas que la fenêtre contextuelle se ferme lors d'un clic à l'extérieur, ajoutez l'attribut data-dismissible="false" (non recommandé). Vous pouvez également ajouter un bouton de fermeture à la fenêtre contextuelle. Utilisez l'attribut data-rel="back" sur le bouton, et contrôlez la position du bouton avec des styles.
| Description | Exemple |
|---|---|
| Bouton de fermeture à droite | Essayez-le vous-même |
| Bouton de fermeture à gauche | Essayez-le vous-même |
| Utilisation de l'attribut data-dismissible | Essayez-le vous-même |
Positionner la fenêtre contextuelle
Par défaut, la fenêtre contextuelle s'affiche directement au-dessus de l'élément cliqué. Pour contrôler la position de la fenêtre contextuelle, utilisez l'attribut data-position-to sur le lien cliqué utilisé pour ouvrir la fenêtre contextuelle.
Trois façons de contrôler la position de la fenêtre contextuelle :
| Valeur de l'attribut | Description |
|---|---|
| data-position-to="window" | La popup est centrée dans la fenêtre |
| data-position-to="#myId" | La popup s'affiche sur l'élément #id connu |
| data-position-to="origin" | Par défaut. La popup s'affiche sur l'élément cliqué. |
Exemple
<a href="#myPopup2" data-rel="popup" class="ui-btn" data-position-to="#demo">id="demo"</a>
<a href="#myPopup3" data-rel="popup" class="ui-btn" data-position-to="origin">Origine</a>
Essayez-le vous-même »
Transitions
Par défaut, les popups n'ont aucun effet de transition. Si nécessaire, vous pouvez ajouter des transitions à l'aide de l'attribut data-transition="value" (Transitions de jQuery Mobile):
Tous les exemples de transitions
Essayez-le vous-même »
Bordures de flèche de fenêtre contextuelle
Pour ajouter une bordure de flèche directionnelle à la fenêtre contextuelle, utilisez l'attribut data-arrow avec la valeur "l" (gauche), "t" (haut), "r" (droite) ou "b" (bas) :
Exemple
<div data-role="popup" id="myPopup" class="ui-content" data-arrow="l">
<p>Direction de la bordure gauche.</p>
</div>
Essayez-le vous-même »
Boîte de dialogue contextuelle
Vous pouvez créer une fenêtre contextuelle de dialogue standard (balisage d'en-tête, de contenu et de pied de page) :
Exemple
<div data-role="popup" id="myPopupDialog">
<div data-role="header"><h1>Texte d'en-tête..</h1></div>
<div data-role="main" class="ui-content"><p>Du texte..</p><a href="#">Un lien..</a>
<div data-role="footer"><h1>Texte de pied de page..</h1></div>
</div>
Essayez-le vous-même »
Popup d'image
Vous pouvez afficher des images dans un popup :Exemple
<img src="/wp-content/uploads/2015/10/example.jpeg" alt="Exemple" style="width:200px;"></a>
<div data-role="popup" id="myPopup">
<img src="/wp-content/uploads/2015/10/example.jpeg" style="width:800px;height:400px;" alt="Exemple">
</div>
Essayez-le vous-même »
Superposition d'arrière-plan du popup
Vous pouvez utiliser l'attribut data-overlay-theme pour ajouter une couleur d'arrière-plan derrière le popup.
Par défaut, l'arrière-plan de superposition est transparent. Utilisez data-overlay-theme="a" pour ajouter un arrière-plan clair, et utilisez data-overlay-theme="b" pour ajouter un arrière-plan de superposition sombre :
Exemple
<div data-role="popup" id="myPopup" data-overlay-theme="b">
<p>Il y a un fond sombre derrière moi.</p>
</div>
Essayez-le vous-même »
Les popups d'image utilisent souvent des superpositions d'arrière-plan :
Exemple
<img src="/wp-content/uploads/2015/10/example.jpeg" alt="Exemple" style="width:200px;"></a>
<div data-role="popup" id="myPopup" data-overlay-theme="b">
<img src="/wp-content/uploads/2015/10/example.jpeg" style="width:800px;height:400px;" alt="Exemple">
</div>
Essayez-le vous-même »
Remarque :Dans les chapitres suivants, vous apprendrez à utiliser des formulaires dans les popups.
Autres extensions