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

<a href="#myPopup" data-rel="popup"class="ui-btn ui-btn-inline ui-corner-all">Afficher la popup</a>

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

Exemple

<div data-role="popup" id="myPopup" class="ui-content">

Essayez-le vous-même »

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="#myPopup1" data-rel="popup" class="ui-btn" data-position-to="window">Fenêtre</a>
<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

<a href="../index.html" data-rel="popup" class="ui-btn" data-transition="fade">Fondu</a>

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

<a href="#myPopup" data-rel="popup" class="ui-btn">Ouvrir la fenêtre contextuelle</a>

<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

<a href="#myPopupDialog" data-rel="popup" class="ui-btn">Ouvrir la fenêtre contextuelle de dialogue</a>

<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

<a href="#myPopup" data-rel="popup" data-position-to="window">
<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

<a href="#myPopup" data-rel="popup">Afficher le popup</a>

<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

<a href="#myPopup" data-rel="popup" data-position-to="window">
<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