Window : méthode confirm()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode confirm() de l'interface Window indique au navigateur d'afficher une boîte de dialogue avec un message optionnel et d'attendre que la personne confirme ou annule la boîte de dialogue.
Sous certaines conditions — par exemple au changement d'onglet — le navigateur pourra ne pas afficher la boîte de dialogue ou ne pas attendre la confirmation ou l'annulation.
Syntaxe
confirm()
confirm(message)
Paramètres
messageFacultatif-
Une chaîne de caractères qu'on souhaite afficher dans la boîte de dialogue de confirmation.
Valeur de retour
Confirmer avant une action
L'exemple suivant montre comment vérifier la valeur retournée par une boîte de dialogue de confirmation.
Lorsque l'utilisateur·ice clique sur le bouton OK, nous appelons window.open(), et si l'utilisateur·ice clique sur Annuler, nous affichons du texte dans un élément <pre>.
<button id="windowButton">Ouvrir un nouvel onglet</button>
<pre id="log"></pre>
const windowButton = document.querySelector("#windowButton");
const log = document.querySelector("#log");
windowButton.addEventListener("click", () => {
if (window.confirm("Voulez-vous ouvrir un nouvel onglet ?")) {
window.open("https://developer.mozilla.org/docs/Web/API/Window/open");
} else {
log.innerText = "Content que vous restiez !";
}
});
Notes
Les boîtes de dialogue sont des fenêtres bloquantes — elles empêchent l'utilisateur·ice d'accéder au reste de l'interface du programme tant que la boîte de dialogue n'est pas fermée.
Pour cette raison, vous ne devez pas abuser de toute fonction qui crée une boîte de dialogue ou une fenêtre bloquante.
Alternativement, un élément <dialog> peut être utilisé pour les confirmations.
Spécifications
| Specification |
|---|
| HTML # dom-confirm-dev |
Compatibilité des navigateurs
Voir aussi
- L'élément HTML
<dialog> - La méthode
window.alert() - La méthode
window.prompt() - N'utilisez jamais un avertissement lorsque vous voulez dire Annuler (angl.) sur A List Apart (2017)