Résumé
Crée et affiche un dialogue modal contenant un document HTML spécifié.
Cette fonction est obsolète.
Le support a été arrêté avec la sortie de Chrome 37. Il y possibilité de la laisser active juqu'en Mai 2015 en configurant les paramètres de politique d'entreprise, plus de détails : ici.
Mozilla a annoncé que le support de cette méthode sera supprimé (bug 981796). Ce changement ne sera pas effectif avant Firefox 39, planigié pour les alentours de mi-juin 2015. Pour les entreprises, il est possible d'utiliser le build ESR 38 qui supportera la méthode jusqu'en milieu d'année 2016.
Syntaxe
retour = window.showModalDialog(uri[,arguments][,options]);
où
retour
est un variant, indiquant la propriété returnValue telle que définie par la fenêtre du document spécifié paruri
.uri
est l'URI du document à afficher dans la boîte de dialogue.arguments
est un variant optionnel contenant les valeurs à passer à la boîte de dialogue ; celles-ci sont disponibles dans la propriétéwindow.dialogArguments
de son objetwindow
.options
est une chaîne optionnelle spécifiant les décorations de la fenêtre de dialogue, avec une ou plusieurs valeurs séparées par des points-virgules :
Syntaxe | Description |
---|---|
center: {on | off | yes | no | 1 | 0 } |
Si cette valeur est on , yes ou 1, la fenêtre de dialogue est centrée sur le bureau ; autrement elle est cachée. La valeur par défaut est yes . |
dialogheight:
height
|
Spécifie la hauteur de la boîte de dialogue ; par défaut, la taille est spécifiée en pixels. |
dialogleft:
left
|
Spécifie la position horizontale de la boîte de dialogue par rapport au coin supérieur gauche du bureau. |
dialogwidth:
width
|
Spécifie la largeur de la boîte de dialogue ; par défaut, la taille est spécifiée en pixels. |
dialogtop:
top
|
Spécifie la position verticale de la boîte de dialogue par rapport au coin supérieur gauche du bureau. |
resizable: {on | off | yes | no | 1 | 0 } |
Si cette valeur est on , yes ou 1, la fenêtre de dialogue peut être redimensionnée par l'utilisateur ; autrement sa taille est fixe. La valeur par défaut est no . |
scroll: {on | off | yes | no | 1 | 0 } |
Si cette valeur est on , yes ou 1, la fenêtre de dialogue a des barres de défilement ; autrement elle n'en a pas. La valeur par défaut est no . |
Note : Firefox n'implémente pas les paramètres
dialogHide
, edge
, status
ou unadorned
.Compatibilité
Introduit par Microsoft Internet Explorer 4. Support ajouté à Firefox dans Firefox 3.
Exemples
Notes
Spécification
Microsoft MSDN : showModalDialog