Affichage d'informations dans le navigateur
Mise à jour : novembre 2007
Même si les navigateurs prennent en charge la plupart des fonctionnalités JScript, les nouvelles fonctionnalités axées sur le .NET Framework, les objets basés sur une classe, les types de données, les énumérations, les directives de compilation conditionnelle et l'instruction const ne sont prises en charge que du côté serveur. Par conséquent, vous devez utiliser ces fonctionnalités en mode exclusif dans les scripts côté serveur. Pour plus d'informations, consultez Informations de version JScript.
Lorsqu'un script est conçu pour s'exécuter dans un navigateur (côté client), les développeurs expérimentés incluent du code qui détecte la version du moteur de script. Une fois que le script a détecté la version du moteur, il peut rediriger le navigateur vers une page contenant un script compatible avec le moteur de script du navigateur. Pour plus d'informations, consultez Détection des fonctionnalités du navigateur.
JScript affiche des informations dans un navigateur par l'intermédiaire des méthodes write et writeln de l'objet document du navigateur. Ces informations peuvent également être affichées dans des formulaires dans un navigateur et dans des messages alert, prompt et confirm. Pour plus d'informations, consultez Utilisation de messages.
Utilisation de document.write et de document.writeln
La solution la plus courante pour afficher des informations consiste à utiliser la méthode write de l'objet document. Elle prend un argument, une chaîne, qu'elle affiche dans le navigateur. La chaîne peut être en texte brut ou HTML.
Dans la mesure où des chaînes peuvent être placées entre guillemets simples ou doubles, vous pouvez placer entre guillemets un élément qui contient des guillemets ou des apostrophes.
document.write("Pi is approximately equal to " + Math.PI);
document.write();
Remarque : |
---|
La fonction simple suivante montre comment éviter de taper document.write chaque fois que vous souhaitez faire apparaître du texte dans la fenêtre du navigateur. Cette fonction ne vous informe pas si l'élément que vous essayez d'écrire n'est pas défini, mais elle vous permet d'émettre la commande w();, qui affiche une ligne vide. |
function w(m) { // Write function.
m = String(m); // Make sure that the m variable is a string.
if ("undefined" != m) { // Test for empty write or other undefined item.
document.write(m);
}
document.write("<br>");
}
w('<IMG SRC="horse.gif">');
w();
w("This is an engraving of a horse.");
w();
La méthode writeln, qui est presque identique à la méthode write, ajoute un caractère de nouvelle ligne à la chaîne fournie. En code HTML, cela donne un espace après l'élément ; à l'intérieur des balises <PRE> et <XMP>, le caractère de nouvelle ligne est interprété littéralement et le navigateur l'affiche.
La méthode write ouvre et efface le document si le document n'est pas en cours d'ouverture et d'analyse lorsque la méthode write est appelée. Cela peut donner des résultats inattendus. L'exemple suivant de script conçu pour afficher l'heure une fois toutes les minutes, ne fonctionne pas après la première exécution, car il s'efface au cours du processus.
<HTML>
<HEAD>
<SCRIPT LANGUAGE="JScript">
function singOut() {
var theMoment = new Date();
var theHour = theMoment.getHours();
var theMinute = theMoment.getMinutes();
var theDisplacement = (theMoment.getTimezoneOffset() / 60);
theHour -= theDisplacement;
if (theHour > 23) {
theHour -= 24
}
// The following line clears the script the second time it is run.
document.write(theHour + " hours, " + theMinute + " minutes, Coordinated Universal Time.");
window.setTimeout("singOut();", 60000);
}
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT>
singOut();
</SCRIPT>
</BODY>
</HTML>
Si vous utilisez la méthode alert de l'objet window au lieu de document.write, le script fonctionne.
// This line produced the intended result.
window.alert(theHour + " hours, " + theMinute + " minutes, Coordinated Universal Time.");
element.innerText ou element.innerHTML est préférable dans Internet Explorer Version 5 et ultérieure.
Effacement du document actif
La méthode clear de l'objet document vide le document actif. Cette méthode efface également votre script (avec le reste du document), c'est pourquoi elle doit être utiliser avec précaution.
document.clear();
Voir aussi
Concepts
Détection des fonctionnalités du navigateur