Window.showModalDialog()

Obsolète: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

Attention : Cette fonctionnalité a été retirée. Veuillez corriger les sites ou applications web sous votre responsabilité qui l'utiliseraient encore.

Cette méthode a été retirée avec Chrome 43 et Firefox 56.

La méthode Window.showModalDialog() permettait de créer et d'afficher une boîte de dialogue modale contenant un document HTML indiqué.

Syntaxe

js
showModalDialog(uri);
showModalDialog(uri, arguments);
showModalDialog(uri, arguments, options);

Paramètres

uri

L'URL du document à afficher dans la boîte de dialogue.

arguments Facultatif

Les valeurs passées comme propriétés à la boîte de dialogue.

options Facultatif

Une chaîne de caractères indiquant l'aspect de l'interface utilisateur pour la boîte de dialogue en utilisant une ou plusieurs valeurs, séparées par des points-virgules :

Syntaxe Description
center: {on | off | yes | no | 1 | 0 } Si la valeur est on, yes, ou 1, la boîte de dialogue est centrée à l'écran. Sinon, elle est cachée. La valeur par défaut est yes.
dialogheight: height La hauteur de la boîte de dialogue, exprimée en pixels.
dialogleft: left La distance de la boîte de dialogue par rapport au bord gauche de l'écran.
dialogwidth: width La largeur de la boîte de dialogue, exprimée en pixels.
dialogtop: top La distance de la boîte de dialogue par rapport au bord haut de l'écran.
resizable: {on | off | yes | no | 1 | 0 } Si cet argument vaut on, yes, ou 1, la fenêtre de la boîte de dialogue peut être redimensionnée, sinon sa taille est fixe. La valeur par défaut est no.
scroll: {on | off | yes | no | 1 | 0 } Si cet argument vaut on, yes, ou 1, la boîte de dialogue dispose de barres de défilement, sinon sa taille est fixe. La valeur par défaut est no.

Note : Firefox n'implémente pas les arguments dialogHide, edge, status, ou unadorned.

Valeur de retour

Contient la propriété returnValue telle que définie par le document ciblé par uri.

Notes

showModalDialog() fut brièvement standardisée en HTML5. Le troisième argument pour les options additionnelles ne faisait pas partie de la version HTML5.

Spécifications

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi