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
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
<dialog>
qui remplacewindow.showModalDialog()
.- Une prothèse d'émulation pour
showModalDialog()
qui utilise<dialog>
et les générateurs