Les propriétés partagées


Les propriétés sont des variables réservées à l'objet. Elles sont importantes parce qu'elles permettent de retrouver plus facilement l'objet utilisé. Les valeurs initiales des propriétés peuvent être changées par l'usager au cours de la navigation.

Les valeurs peuvent être vérifiées et formatées selon les entrées faites par l'usager. En validant une propriété, la valeur lue est toujours valide.

Voici la liste des propriétés JavaScripts:

action
alinkColor
anchors
bgColor
border
checked
complete
cookie
defaultChecked
defaultSelected
defaultStatus
defaultValue
description
elements
enabledPlugin
encoding
fgColor
filename
forms
frames
hash
height
host
hostname
href
hspace
index
lastModified
length
linkColor
links
lowsrc
method
name
opener
options
parent
pathname
port
protocol
prototype JavaScript1.1
referrer
search
selected
selectedIndex
self
src
status
target
text
title
top
type
URL
value
vlinkColor
vspace
width
window

ACTION

Cette propriété représente une chaîne de caractères qui spécifie une destination URL lorsque les données d'un formulaire sont soumises.


Syntaxe:

nomFormulaire.action

nomFormulaire est soit le nom d'un formulaire ou un élément dans le tableau de formulaire.


Objet utilisé:

form

Exemple ACTION

<FORM NAME=courrier>
Adresse :<BR>
<INPUT TYPE="text" NAME=email VALUE="webmaster@ungi.com" MAXLENGTH=50 SIZE=25><BR>
Sujet :<BR>
<INPUT TYPE="text" NAME=sujet VALUE="hello"MAXLENGTH=50 SIZE=25><BR>
Corps du courrier :<BR>
<TEXTAREA NAME="textareaName" ROWS=5 COLS=40>Texte contenu dans la boite de saisie</TEXTAREA><BR>
<INPUT TYPE="submit" NAME="envoi" VALUE="envoyer le mail" onClick="envoiMail();return true;">   
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
function envoiMail()

{
adresse="mailto:"+document.courrier.email.value+"?subject="+document.courrier.sujet.value;
document.courrier.action=adresse;
document.courrier.submit();
alert(document.courrier.action);
}
</SCRIPT>

ALINKCOLOR

Cette propriété définit la couleur d'un lien actif, c'est-à-dire la couleur du lien lorsque l'usager appuie sur le lien.


Syntaxe:

document.alinkColor


Objet utilisé:

document

Exemple ALINKCOLOR

<A HREF="http://www.imaginet.fr/ime/">UNGI !</A>
<BR><BR>
<FORM>
Couleur des liens :<BR>
<INPUT TYPE="button" NAME="rouge" VALUE="lien rouge quand cliqué" onClick="changeLien('rouge')">   
<INPUT TYPE="button" NAME="vert" VALUE="lien vert quand cliqué" onClick="changeLien('vert')">   
<INPUT TYPE="button" NAME="bleu" VALUE="lien bleu quand cliqué" onClick="changeLien('bleu')">   
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
function changeLien(couleur)
{
if(couleur=="rouge")

document.alinkColor="FF0000";
if(couleur=="vert")
    document.alinkColor="00FF00";
if(couleur=="bleu")
    document.alinkColor="0000FF";
}
</SCRIPT>

ANCHORS (propriété)

Cette propriété représente un tableau d'objets correspondant aux noms des marqueurs <A> présent dans le code HTML. Voir l'objet "anchor".

Exemple ANCHORS (propriété)

<A NAME="ancre1"></A>
<A NAME="ancre2"></A>
<A NAME="ancre3"></A>

<SCRIPT LANGUAGE="JavaScript1.1">
document.write("nombre de cibles hypertexte : "+document.anchors.length+"<BR>");
</SCRIPT>

ARGUMENTS

Cette propriété représente un argument de l'objet "Function".


Syntaxe:

Pour spécifier le tableau d'arguments dans un objet Function:

unObjet.arguments[index]


Objet utilisé:

Function

Exemple ARGUMENTS

BGCOLOR

Cette propriété définit la couleur d'arrière plan d'un document.


Syntaxe:

document.bgColor


Objet utilisé:

document

Exemple BGCOLOR

<FORM>
Changer la couleur du fond :<BR>
<INPUT TYPE="button" NAME="rouge" VALUE="fond rouge" onClick="changeFond('rouge')">   
<INPUT TYPE="button" NAME="vert" VALUE="fond vert" onClick="changeFond('vert')">   
<INPUT TYPE="button" NAME="bleu" VALUE="fond bleu" onClick="changeFond('bleu')">   
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
function changeFond(couleur)
{
if(couleur=="rouge")
    document.bgColor="FF0000";
if(couleur=="vert")
    document.bgColor="00FF00";

if(couleur=="bleu")
    document.bgColor="0000FF";
}
</SCRIPT>

BORDER

Cette propriété est une chaîne de caractères qui spécifie la largeur en pixel de la bordure d'une image. Utilisée en lecture seulement.


Syntaxe:

nomImage.border

nomImage est soit le nom d'un objet Image ou un élément dans le tableau d'images.


Objet utilisé:

Image

Exemple BORDER

<IMG SRC="ungi.gif" NAME="ungi" width=120 height=80 BORDER=4>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("l'image ci-dessus &agrave; des bords d'&eacute;paisseur : "+document.ungi.border);
</SCRIPT>

CHECKED

Cette propriété possède une valeur booléenne et spécifie le statut d'une option d'une boîte de marquage ou d'un bouton radio (cochée ou non cochée).


Syntaxe:

1. nomCheckbox.checked
2. nomRadio[index].checked

nomCheckbox est soit la valeur de l'attribut NAME d'un objet "checkbox" ou un élément dans le tableau d'éléments.
nomRadio est la valeur de l'attribut NAME d'un objet "radio".
index est un entier représentant un bouton radio dans un objet "radio".

Objet utilisé:

checkbox
radio

Exemple CHECKED

<FORM NAME=formulaire>
<INPUT TYPE="checkbox" NAME="case1" VALUE="Selectionne" onClick=checktest()>
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
function checktest()
{
if(document.formulaire.case1.checked=="1")
    alert('case cochée.')
else
    alert('case non cochée.')
}
</SCRIPT>

COMPLETE

Cette propriété est une valeur booléenne qui indique si le navigateur a réussi ou non à charger une image. Utilisée en lecture seulement.


Syntaxe:

nomImage.complete

nomImage est soit le nom d'un objet image ou un élément dans le tableau d'images.


Objet utilisé:

Image

Exemple COMPLETE

<IMG SRC="badgirl.jpg" NAME="ungi" width=120 height=80 BORDER=4>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
   
document.writeln("La valeur de document.ungi.complete est :"+document.ungi.
complete);

/*
if(document.ungi.complete=="false")
    {
    document.writeln("Lors de l'affichage de cette ligne, le chargement de l'image est en cours.");
    }
else
    {
    document.writeln("Lors de l'affichage de cette ligne, le chargement de l'image est termin&eacute;e.");

}
*/

function completetest()
{
if(document.ungi.complete=="false")
    {
    alert(document.ungi.complete+' : l\'image est en cours de chargement.');
    }
else
    {
    alert(document.ungi.complete+' : l\'image est chargée.');
    }
}
</SCRIPT>

<BR>Testez !<BR>
<FORM NAME=formulaire>
<INPUT TYPE="button" NAME="fini" VALUE="Affichage terminé ?" onClick=completetest()>
</FORM>

COOKIE

Cette propriété représente une chaîne de caractères qui est enregistrée par le navigateur dans le fichier "cookies.txt". Il est possible d'utiliser cette propriété avec les méthodes "substring", "
charAt", "indexOf" et "lastIndexOf" pour déterminer la valeur enregistrée dans le "cookie".


Syntaxe:

document.cookie


Objet utilisé:

document

Exemple COOKIE

<SCRIPT LANGUAGE="JavaScript1.1">

var expression = "hummmm_les_bonnes_pepites_de_chocolat";
aujourdhui = new Date()
var time = aujourdhui.toGMTString()
document.cookie = "@" + time + "=" + expression + ";"
</SCRIPT>

DEFAULTCHECKED

Cette propriété possède une valeur booléenne et indique le statut par défaut d'une option d'une boîte de marquage ou d'un bouton radio (cochée ou non cochée).


Syntaxe:

1. nomCheckbox.defaultchecked
2. nomRadio[index].defaultchecked

nomCheckbox est soit la valeur de l'attribut NAME d'un objet "checkbox" ou un élément dans le tableau d'éléments.
nomRadio est la valeur de l'attribut NAME d'une objet "radio".

index est un entier représentant un bouton radio dans un objet "radio".


Objet utilisé:

checkbox
radio

Exemple DEFAULTCHECKED

<FORM NAME=formulaire>
case1 :<INPUT TYPE="checkbox" NAME="case1" CHECKED><BR>
case2 :<INPUT TYPE="checkbox" NAME="case2"><BR>
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
if(document.formulaire.case1.defaultChecked==true)
    document.writeln("La case1 est cochée par défaut car document.formulaire.case1.
defaultChecked ="+document.formulaire.case1.defaultChecked+"<BR>");
if(document.formulaire.case1.defaultChecked==false)
    document.writeln("La case1 n'est pas cochée par défaut car document.formulaire.case1.defaultChecked ="+document.formulaire.case1.
defaultChecked+"<BR>");

if(document.formulaire.case2.defaultChecked==true)
    document.writeln("La case2 est cochée par défaut car document.formulaire.case2.
defaultChecked ="+document.formulaire.case2.defaultChecked+"<BR>");
if(document.formulaire.case2.defaultChecked==false)
    document.writeln("La case2 n'est pas cochée par défaut car document.formulaire.case2.defaultChecked ="+document.formulaire.case2.
defaultChecked+"<BR>");
</SCRIPT>

DEFAULTSELECTED

Cette propriété possède une valeur booléenne et indique le statut par défaut d'une option d'un objet "select" ou "Option" (sélectionnée ou non sélectionnée).


Syntaxe:

nomSelect.options[index].defaultSelected
nomOption.defaultSelected

nomSelect est soit la valeur de l'attribut NAME d'un objet "select" ou un élément dans le tableau d'éléments.
index est un entier représentant une option dans un objet "select".

nomOption est le nom d'un objet "select" qui a été créé en utilisant le constructeur Option().


Objet utilisé:

Option
Le tableau d'option (objet "select").

Exemple DEFAULTSELECTED

<FORM NAME=formulaire>
<SELECT NAME=liste MULTIPLE SIZE=6>
    <OPTION SELECTED>selection1
    <OPTION SELECTED>selection2
    <OPTION>selection3
    <OPTION SELECTED>selection4
    <OPTION SELECTED>selection5
    <OPTION>selection6
</SELECT>
</FORM>

Liste des &eacute;l&eacute;ments s&eacute;l&eacute;ctonn&eacute;s par d&eacute;faut :<BR>

<SCRIPT LANGUAGE="JavaScript1.1">
for (i=0; i < document.formulaire.liste.length; i++)
    {
    if(document.formulaire.liste[i].defaultSelected==true)

{
        document.writeln(document.formulaire.liste[i].text+" est s&eacute;lectionn&eacute; par d&eacute;faut<BR>");
        }
    }
</SCRIPT>

DEFAULTVALUE

Cette propriété représente une chaîne de caractères qui indique la valeur de défaut d'un objet password, text ou textarea.


Syntaxe:

1. nomPassword.defaultValue
2. nomText.defaultValue
3. nomTextarea.defaultValue

nomPassword est soit la valeur de l'attribut NAME d'un objet "password" ou un élément dans un tableau d'éléments.
nomText est soit la valeur de l'attribut NAME d'un objet "text" ou un élément dans un tableau d'éléments.

nomTextarea est soit la valeur de l'attribut NAME d'un objet "textarea" ou un élément dans un tableau d'éléments.


Objet utilisé:

password
text
textarea

Exemple DEFAULTVALUE

<FORM NAME=formulaire>
<INPUT TYPE="password" NAME="champassword" VALUE="motdepasse" SIZE=15>
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("Le mot de passe par défaut de ce champs est : "+document.formulaire.champassword.defaultValue+"<BR>");
</SCRIPT>

DESCRIPTION

Cette propriété donne une description du plug-in.


Syntaxe:

1. navigator.mimeTypes[index].description
2. navigator.mimeTypes[nomMimeType].description
3. navigator.plugins[index].description
4. navigator.plugins[nomPlugin].description


Objet utilisé:

Plugin

Exemple DESCRIPTION

Description des types mime :<BR>

<SCRIPT LANGUAGE="JavaScript1.1">
for (i=0; i < navigator.mimeTypes.length; i++)
        document.writeln(navigator.mimeTypes[i].description+" <BR>");
</SCRIPT>

ELEMENTS

Cette propriété représente un tableau d'objets correspondant aux éléments d'un formulaire, tels que les objets "checkbox", "radio" et "text". Voir le tableau d'éléments.

Exemple ELEMENTS

<FORM NAME=formulaire>
    <INPUT TYPE="text" NAME=champtexte1 MAXLENGTH=50 SIZE=25 VALUE="voila"><BR>
    <INPUT TYPE="text" NAME=champtexte2 MAXLENGTH=50 SIZE=25 VALUE="un"><BR>
    <INPUT TYPE="text" NAME=champtexte3 MAXLENGTH=50 SIZE=25 VALUE="tableau"><BR>
    <INPUT TYPE="text" NAME=champtexte4 MAXLENGTH=50 SIZE=25 VALUE="d'elements"><BR>
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
for (i=0; i < document.formulaire.elements.length; i++)
    {
    document.write(document.formulaire.elements[i].value+" ");

}
</SCRIPT>

ENCODING

Cette propriété spécifie l'encodage MIME d'un formulaire. Elle représente initialement l'attribut ENCTYPE du marqueur <FORM>.


Syntaxe:

nomFormulaire.encoding

nomFormulaire est soit le nom d'un formulaire ou un élément dans le tableau de formulaires.


Objet utilisé:

form

Exemple ENCODING

<FORM
NAME=formulaire
METHOD=POST
ACTION="mailto:webmaster@ungi.com?subject=bonjour"
ENCTYPE="text/plain"
TARGET="_top">
    <TEXTAREA NAME="textareaName" ROWS=5 COLS=40>Texte contenu dans la boite de saisie</TEXTAREA>
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Type de codage :"+document.formulaire.encoding);
</SCRIPT>

ENABLEDPLUGIN

Cette propriété retourne une référence à un objet "Plugin" pour le plug-in qui contrôle le type MIME. S'il n'y a aucun plug-in qui contrôle le type MYME, la référence retournée sera NULL.

Exemple ENABLEDPLUGIN

<SCRIPT LANGUAGE="JavaScript1.1">
typemime = navigator.mimeTypes["audio/wav"]
if (typemime)
    {
    plugin = typemime.enabledPlugin
    if (plugin)
        document.writeln("Lancement du son ! <BR><EMBED SRC=cyborg.wav>")
    else
    document.writeln("Procurez vous le plug-in !.")
    }
else
    {
    document.writeln("type mime inexistant.")
    }
</SCRIPT>

FILENAME

Cette propriété représente le nom de fichier du plug-in.


Syntaxe:

1. navigator.plugins[index].filename
2. navigator.plugins[nomPlugin].filename


Objet utilisé:

Plugin

Exemple FILENAME

<SCRIPT LANGUAGE="JavaScript1.1">
for (i=0; i < navigator.plugins.length; i++)
{
    document.writeln(navigator.plugins[i].name,
        navigator.plugins[i].description,
    navigator.plugins[i].filename+"<BR>");
}
</SCRIPT>

FGCOLOR

Cette propriété spécifie la couleur du texte du document.


Syntaxe:

document.fgColor


Objet utilisé:

document

Exemple FGCOLOR

<SCRIPT LANGUAGE="JavaScript1.1">
document.fgColor="#FF0000";
document.write("Voilà un texte ROUGE <BR>");
</SCRIPT>

FORMS

Cette propriété représente un tableau d'objets correspondant aux formulaires (marqueur <FORM>) présents dans un document. Voir l'objet "form".

Exemple FORMS

<FORM NAME=formulaire>
<SELECT NAME=liste>
<OPTION SELECTED>selection1
<OPTION SELECTED>selection2
</SELECT>
<BR>
</FORM>
<FORM NAME=formulaire2>
<INPUT TYPE="button" VALUE="Bouton"><BR>
</FORM NAME=formulaire>
<FORM NAME=formulaire3>
<TEXTAREA NAME="boite" ROWS=3 COLS=40></TEXTAREA><BR>
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Il y a document.forms.length ="+document.forms.length+" formulaires dans ce document");
</SCRIPT>

HASH

Cette propriété représente une chaîne de caractères qui commence avec le caractère "#". Ce caractère spécifie qu'il s'agit d'un nom de signet dans un URL.


Syntaxe:

1. links[index].hash
2. location.hash
3. nomArea.hash

index est un entier représentant un objet "link".
nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
link
location

Exemple HASH

<A HREF="http://www.labas.com:2000/repertoire/fichier.htm#interessant">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le signet du lien zero est :"+document.links[0].hash);
</SCRIPT>

HEIGHT

Cette propriété est une chaîne de caractères qui spécifie la hauteur d'une image soit en pixel, soit en pourcentage par rapport à la hauteur de la fenêtre. À la même signification que l'attribut HEIGHT du marqueur <IMG>. Cette propriété est utilisée en lecture seulement.


Syntaxe:

nomImage.height

nomImage est soit le nom d'un objet "Image" ou un élément dans le tableau d'images.


Objet utilisé:

Image

Exemple HEIGHT

<IMG SRC="ungi.gif" NAME="ungi" width=120 height=80 BORDER=4>Logo UNGI !
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("Hauteur autour de l'image : "+document.ungi.height);
</SCRIPT>
<BR>

HSPACE

Cette propriété est une chaîne de caractères qui spécifie en pixel la marge de gauche et de droite d'une image entre celle-ci et le texte. À la même signification que l'attribut HSPACE du marqueur <IMG>. Cette propriété est utilisée en lecture seulement.


Syntaxe:

nomImage.hspace

nomImage est soit le nom d'un objet "Image" ou un élément dans le tableau d'images.


Objet utilisé:

Image

Exemple HSPACE

<IMG SRC="ungi.gif" NAME="ungi" width=120 height=80 BORDER=4 HSPACE=40>Logo UNGI !
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("Espacement horizontal autour de l'image : "+document.ungi.hspace);
</SCRIPT>
<BR>
Attention, la propriété 'hspace' est spécifique à netscape !

HOST

Cette propriété représente une chaîne de caractères qui spécifie le nom de l'hôte et le port dans un URL. C'est-à-dire, la concaténation du nom de l'hôte et le port, séparé par deux points.

Exemple: http://nomHôte:port/

Lorsque la propriété "port" est nul, la propriété host est identique à la propriété "hostname".


Syntaxe:

1. links[index].host
2. location.host
3. nomArea.host

index est un entier représentant un objet "link".

nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
link
location

Exemple HOST

<A HREF="http://www.labas.com:2000/repertoire/fichier.htm#interessant">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le serveur h&ocirc;te du lien links[0] est :"+document.links[0].host);
</SCRIPT>

HOSTNAME

Cette propriété représente une chaîne de caractères qui spécifie le nom de l'hôte et le nom de domaine, ou l'adresse IP, d'un serveur.


Syntaxe:

1. links[index].hostname
2. location.hostname
3. nomArea.hostname

index est un entier représentant un objet "link".
nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
link
location

Exemple HOSTNAME

<A HREF="http://www.labas.com:2000/repertoire/fichier.htm#interessant">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le serveur h&ocirc;te du lien links[0] est :"+document.links[0].hostname);
</SCRIPT>

HREF

Cette propriété représente une chaîne de caractères qui spécifie l'adresse URL au complet.


Syntaxe:

1. links[index].href
2. location.href
3. nomArea.href

index est un entier représentant un objet "link".
nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
link
location

Exemple HREF

<A HREF="http://www.labas.com:2000/repertoire/fichier.htm#interessant">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("L'URL du lien links[0] est :"+document.links[0].href);
</SCRIPT>

INDEX

Cette propriété représente un index d'une option dans l'objet "select". Il s'agit du nombre identifiant la position de l'option dans le menu, partant de zéro.


Syntaxe:

nomSelect.options[ValeurIndex].index
nomOption.index

nomSelect est soit la valeur de l'attribut NAME d'un objet "select" ou un élément dans le tableau d'éléments.
ValeurIndex est un entier représentant une option dans l'objet "select".
nomOption est soit le nom d'une option de l'objet "select" créée avec le constructeur().

Objet utilisé:

Le tableau d'options de l'objet "select"
Option

Exemple INDEX

<FORM NAME=formulaire>
<SELECT NAME=liste>
    <OPTION NAME="sel1">selection1
    <OPTION NAME="sel2">selection2
    <OPTION NAME="sel3">selection3
</SELECT>
</FORM>
Liste des des index de la liste :<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
for (i=0; i < document.formulaire.liste.length; i++)
    {
        document.writeln("document.formulaire.liste["+i+"].index
="+document.formulaire.liste[i].index+" <BR>");
    }
</SCRIPT>

LASTMODIFIED

Cette propriété représente la date de dernière modification d'un document. Elle est utilisée en lecture seulement.


Syntaxe:

document.lastModified


Objet utilisé:

document

Exemple LASTMODIFIED

<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("Dernière modification de ce document : "+document.lastModified);
</SCRIPT>
<BR>

LINKCOLOR

Cette propriété spécifie la couleur des liens hypertextes d'un document.


Syntaxe:

document.linkColor


Objet utilisé:

document

Exemple LINKCOLOR

<SCRIPT LANGUAGE="JavaScript1.1">
document.linkColor="#FF0000";
</SCRIPT>
Définit la couleur du <A HREF="http://www.imaginet.fr/ime/">lien UNGI !</A> en rouge.<BR>

LINKS

Cette propriété représente un tableau d'objets correspondant aux objets "link" présents dans un document. Voir l'objet "link".

Exemple LINKS

<SCRIPT LANGUAGE="JavaScript1.1">
document.linkColor="#FF0000";
</SCRIPT>
<A HREF="http://www.imaginet.fr/ime/">lien UNGI</A>.<BR>
<A HREF="http://www.altavista.com/">lien AltaVista</A>.<BR>
<A HREF="http://www.netscape.com/">lien netscape</A>.<BR>
Liste des liens contenu dans ce document :<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
for (i=0; i < document.links.length; i++)
    {
    document.writeln("document.links["+i+"].href="+document.links[i].href+" <BR>");

}
</SCRIPT>

LOCATION (propriété)

Cette propriété spécifie l'URL complet d'un document. Utilisée en lecture seulement avec l'objet "
location".


Syntaxe:

document.location


Objet utilisé:

document

Exemple LOCATION (propriété)

LOWSRC

Cette propriété est une chaîne de caractères qui spécifie l'URL de la version "Basse résolution" d'une image qui doit être affichée dans un document. Cette propriété représente l'attribut LOWSRC du marqueur <IMG>.


Syntaxe:

nomImage.lowsrc

Parameters
nomImage est soit le nom d'un objet "Image" ou un élément dans le tableau d'images.


Objet utilisé:

Image

Exemple LOWSRC

<IMG SRC="badgirl.jpg" LOWSRC="ungi.gif" NAME="ungi" WIDTH=120 height=80 BORDER=4>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("la propirété lowsrc de l'image est document.ungi.lowsrc
="+document.ungi.lowsrc);
</SCRIPT>
<BR>

METHOD

Cette propriété spécifie la méthode d'envoi des entrées d'un formulaire au serveur. Elle a la même signification que l'attribut METHOD du marqueur <FORM>. Elle devrait être évaluée à "get" ou "post".


Syntaxe:

nomFormulaire.method

nomFormulaire est soit le nom d'un formulaire ou un élément dans le tableau de formulaires.


Objet utilisé:

form

Exemple METHOD

<FORM NAME=formulaire METHOD=post>
    <INPUT TYPE="password" NAME="champassword" VALUE="motdepasse" SIZE=15>
    <INPUT TYPE="submit">
</FORM>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("Méthode de soumission du formulaire document.formulaire.method
="+document.formulaire.method);
</SCRIPT>
<BR>

OPTIONS

Cette propriété représente un tableau correspondant aux options (marqueur <OPTION>) de l'objet "select" présents dans un document. Voir l'objet "select".

Exemple OPTIONS

<FORM NAME=formulaire>
<SELECT NAME=liste>
    <OPTION NAME="sel1">selection1
    <OPTION NAME="sel2">selection2
    <OPTION NAME="sel3">selection3
</SELECT>
</FORM>
Contenu de la liste :<BR>
<SCRIPT LANGUAGE="JavaScript1.1">

for (i=0; i < document.formulaire.liste.options.length; i++)
    {
        document.writeln("document.formulaire.liste.options
["+i+"].text="+document.formulaire.liste.options[i].text+" <BR>");
    }
</SCRIPT>
<BR>

PATHNAME

Cette propriété représente la portion de l'URL qui spécifie le chemin et le nom de fichier.


Syntaxe:

1. links[index].pathname
2. location.pathname
3. nomArea.pathname

index est un entier représentant un objet "link".
nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
link
location

Exemple PATHNAME

<A HREF="http://www.labas.com:2000/repertoire/fichier.htm#interessant">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le chemin du fichier spécifié dand le lien links[0] est :"+document.links[0].
pathname);
</SCRIPT>

PORT

Cette propriété spécifie le port de communication que le serveur utilise pour communiquer.


Syntaxe:

1. links[index].port
2. location.port
3. nomArea.port

index est un entier représentant un objet "link".
nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
link
location

Exemple PORT

<A HREF="http://www.labas.com:2000/repertoire/fichier.htm#interessant">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le port associé au lien links[0] est :"+document.links[0].port);
</SCRIPT>

PROTOCOL

Cette propriété est une chaîne de caractères qui spécifie le début d'une adresse URL, incluant les deux points.


Syntaxe:

1. links[index].protocol
2. location.protocol
3. nomArea.protocol

index est un entier représentant un objet "link".
nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
link
location

Exemple PROTOCOL

<A HREF="http://www.labas.com:2000/repertoire/fichier.htm#interessant">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le protocole spécifié dand le lien links[0] est :"+document.links[0].protocol
);
</SCRIPT>

prototype

Cette propriété définit une propriété qui est partagée par tous les objets d'un type spécifié. Il faut utiliser cette propriété pour ajouter des propriétés aux objets créés avec l'opérateur "new".

Syntaxe:

JavaScript1.1 : typeObjet.prototype.nomPropriété = valeur

typeObjet est le nom d'un constructeur spécifié par le type de l'objet.
nomPropriété est le nom de la propriété qui devra être créée.
valeur est la valeur initiale de la propriété pour tous les objets du typeObjet spécifié.

Objet utilisé:

"Prototype" est une propriété de n'importe quel objet créé avec l'opérateur "new", tel que:

Array
Date
Function
Image
select
string

Exemple :

<SCRIPT LANGUAGE="JavaScript1.1">
// Ajout d'une propriété à l'objet Date :
Date.prototype.Millenaire;

maintenant = new Date();
maintenant.millenaire = "troisieme";

document.writeln("millenaire : "+maintenant.millenaire+"<BR>");
</SCRIPT>

REFERRER

Cette propriété spécifie l'URL du document appelé lorsque l'usager appuie sur un lien.


Syntaxe:

document.referrer


Objet utilisé:

document

Exemple REFERRER

<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Ce document à été ouvert à partir d'un lien sur l'URL document.referrer = "+document.referrer+"<BR>");
</SCRIPT>

SEARCH

Cette propriété représente une chaîne de caractères qui commence avec un point d'interrogation et qui suit par une requête sur l'URL.


Syntaxe:

1. links[index].search
2. location.search
3. nomArea.search

index est un entier représentant un objet "link".
nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
link
location

Exemple SEARCH

<A HREF="http://www.labas.com:2000/repertoire/fichier.cgi?ceciestlarequete">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("La requ&ecirc;te spécifi&eacute;e dand le lien links[0] est :"+document.links[0].search);
</SCRIPT>

SELECTED

Cette propriété possède une valeur booléenne et spécifie le statut d'une option d'un objet "select
" ou "Option" (sélectionnée ou non sélectionnée).


Syntaxe:

nomSelect.options[index].selected
nomOption.selected

nomSelect est soit la valeur de l'attribut NAME d'un objet "select" ou un élément dans un tableau d'éléments.
index est un entier représentant une option dans l'objet "select".

nomOption est le nom d'une option de l'objet "select" créée avec le constructeur Option().


Objet utilisé:

Le tableau d'options de l'objet "select"
Option

Exemple SELECTED

<FORM NAME=formulaire>
<SELECT NAME=liste MULTIPLE SIZE=6>
    <OPTION SELECTED>selection1
    <OPTION SELECTED>selection2
    <OPTION>selection3
    <OPTION SELECTED>selection4
    <OPTION SELECTED>selection5
    <OPTION>selection6
</SELECT>
<BR>
<INPUT TYPE="button" VALUE="montre séléctions" onClick="selections()");
<BR>
Liste des &eacute;l&eacute;ments s&eacute;l&eacute;ctonn&eacute;s :<BR>
<TEXTAREA NAME="boite" ROWS=5 COLS=40></TEXTAREA>
</FORM>


<SCRIPT LANGUAGE="JavaScript1.1">

function selections()
{
var liste = "";
for (i=0; i < document.formulaire.liste.length; i++)
    {
    if(document.formulaire.liste[i].selected==true)
        {
        liste +=document.formulaire.liste[i].text+" est sélectionnée\n";
        }
    }
document.formulaire.boite.value=liste;
}
</SCRIPT>

SELECTEDINDEX

Cette propriété est un entier qui spécifie l'index d'une option sélectionnée dans un objet "select".


Syntaxe:

1. nomSelect.selectedIndex
2. nomSelect.options.selectedIndex

nomSelect est soit la valeur de l'attribut NAME d'un objet "select" ou un élément dans un tableau d'éléments.


Objet utilisé:

Le tableau d'options de l'objet "select"

Exemple SELECTEDINDEX

<FORM NAME=formulaire>
<SELECT NAME=liste>
    <OPTION>selection1
    <OPTION>selection2
    <OPTION>selection3
    <OPTION>selection4
    <OPTION>selection5
    <OPTION>selection6
</SELECT>
<BR>
<INPUT TYPE="button" VALUE="montre séléction" onClick="selectionindex()");
<BR>
Index de l'&eacute;l&eacute;ments s&eacute;l&eacute;ctonn&eacute; :<BR>
<TEXTAREA NAME="boite" ROWS=5 COLS=40></TEXTAREA>
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
function selectionindex()
{

document.formulaire.boite.value=document.formulaire.liste.selectedIndex;
}
</SCRIPT>

SRC

Cette propriété représente une chaîne de caractères qui spécifie l'URL d'une image à être affichée dans un document. Représente l'attribut SRC du marqueur <IMG>.


Syntaxe:

nomImage.src

nomImage est soit le nom d'un objet "Image" ou un élément dans le tableau d'images.


Objet utilisé:

Image

Exemple SRC

<IMG SRC="ungi.gif" NAME="ungi" width=120 height=80 BORDER=4>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("la propirété src de l'image est document.ungi.src="+document.ungi.src);
</SCRIPT>
<BR>

TARGET

Cette propriété est une chaîne de caractères qui fonctionne de la même façon que l'attribut TARGET dans les marqueurs <FORM> et <A>. Pour un formulaire, elle spécifie le nom de la fenêtre auxquelles les réponses du formulaire seront soumises. Pour un lien hypertexte, elle spécifie le nom de la fenêtre qui affichera le contenu du document appelé.


Syntaxe:

1. nomFormulaire.target
2. links[index].target
3. nomArea.target


nomFormulaire est soit le nom d'un formulaire ou un élément dans le tableau de formulaire.
index est un entier représentant un objet "link".
nomArea est la valeur de l'attribut NAME de l'objet "Area".


Objet utilisé:

Area
form
link

Exemple TARGET

<A HREF="http://www.labas.com:2000/repertoire/fichier.cgi?ceciestlarequete" target="_top">Ceci est un lien</A>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.write("L'URL sp&eacute;cifi&eacute;e avec lien links[0] sera ouverte dans :"+document.links[0].target);
</SCRIPT>

TEXT (propriété)

Cette propriété spécifie le texte qui suit le marqueur <OPTION> dans l'objet "select". Il est possible de changer ce texte. "text" est une propriété de l'objet "Option".


Syntaxe:

nomSelect.options[index].text
nomOption.text

nomSelect est soit la valeur de l'attribut NAME d'un objet "select" ou un élément dans le tableau d'éléments.
index est un entier représentant une option dans l'objet "select".
nomOption est le nom d'une option de l'objet "select" créée avec le constructeur Option().

Objet utilisé:

Le tableau d'options de l'objet "select"
Option

Exemple TEXT (propriété)

<FORM NAME=formulaire>
<SELECT NAME=liste>
    <OPTION>selection1
    <OPTION>selection2
    <OPTION>selection3
    <OPTION>selection4
    <OPTION>selection5
    <OPTION>selection6
</SELECT>
<BR>
<INPUT TYPE="text" NAME=champtexte1 MAXLENGTH=10 SIZE=10 VALUE="selection1">
<INPUT TYPE="text" NAME=champtexte2 MAXLENGTH=10 SIZE=10 VALUE="selection2">
<INPUT TYPE="text" NAME=champtexte3 MAXLENGTH=10 SIZE=10 VALUE="selection3">
<INPUT TYPE="text" NAME=champtexte4 MAXLENGTH=10 SIZE=10 VALUE="selection4">

<INPUT TYPE="text" NAME=champtexte5 MAXLENGTH=10 SIZE=10 VALUE="selection5">
<INPUT TYPE="text" NAME=champtexte6 MAXLENGTH=10 SIZE=10 VALUE="selection6">
<INPUT TYPE="button" VALUE="modifier liste" onClick="selectionindex()");
<BR>
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
function selectionindex()
{
document.formulaire.liste[0].text=document.formulaire.champtexte1.value;
document.formulaire.liste[1].text=document.formulaire.champtexte2.value;

document.formulaire.liste[2].text=document.formulaire.champtexte3.value;
document.formulaire.liste[3].text=document.formulaire.champtexte4.value;
document.formulaire.liste[4].text=document.formulaire.champtexte5.value;
document.formulaire.liste[5].text=document.formulaire.champtexte6.value;
}
</SCRIPT>

TITLE

Cette propriété représente un titre d'un document, tout comme les marqueurs <TITLE> et </TITLE>. Cette propriété est utilisée en lecture seulement.


Syntaxe:

document.title


Objet utilisé:

document

Exemple TITLE

<HTML>
<HEAD>
<title>Methodes date</title>
</HEAD>

<BODY>

<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le titre du document est document.title ="+document.title+"<BR>");
</SCRIPT>

</BODY>
</HTML>

TYPE

Cette propriété spécifie le type des éléments d'un formulaire. Le type est la valeur de l'attribut TYPE que l'on retrouve dans les marqueurs <INPUT>, <SELECT> et <TEXTAREA>.


Syntaxe:

1. nomObjet.type
2. mimeTypes[index].type

nomObjet est soit la valeur de l'attribut NAME d'un élément du formulaire ou un élément dans le tableau d'éléments.


Objet utilisé:

button
checkbox
fileUpload

hidden
password
radio
reset
select
submit
text
textarea

Exemple TYPE

<FORM NAME="formulaire">
<INPUT TYPE="text" MAXLENGTH=40 SIZE=40 VALUE="champ texte">
<INPUT TYPE="button" VALUE="appuyer ne fait rien">
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
for (i=0; i < document.formulaire.elements.length; i++)
    {
    document.write("L'élément "+i+" du formulaire est de type "+document.formulaire.elements[i].type+"<BR>")
    }
</SCRIPT>

URL

Cette propriété spécifie l'URL complet du document. Il faut l'utiliser en lecture seulement.


Syntaxe:

document.URL


Objet utilisé:

document

Exemple URL

<SCRIPT LANGUAGE="JavaScript1.1">
document.write("L'URL courante est document.URL = " + document.URL);
</SCRIPT>

VALUE

Cette propriété est une chaîne de caractères qui représente la valeur de l'attribut VALUE de l'objet correspondant.


Syntaxe:

1. nomObject.value
2. nomRadio[index].value
3. nomSelect.options.[index].value
4. nomFileUpload.value
5. nomOption.value

nomObjet est soit la valeur de l'attribut NAME d'un objet suivant: "hidden", "password", "text", "textarea", "button", "reset", "submit" ou "checkbox", ou un élément dans le tableau d'éléments.

nomRadio est la valeur de l'attribut NAME d'un objet "radio".
nomSelect est soit la valeur de l'attribut NAME d'un objet "select" ou un élément dans le tableau d'éléments.
index est un entier représentant un bouton radio d'un objet "radio" ou une option d'un objet "select".
nomFileUpload est soit la valeur de l'attribut NAME de l'objet "FileUpload" ou un élément dans le tableau d'éléments.
nomOption est le nom d'un objet "select" créé avec le constructeur Option().

Objet utilisé:

button
checkbox
FileUpload
hidden
Le tableau d'options de l'objet "select"
Option
password
radio
reset
submit
text
textarea

Exemple VALUE

<FORM NAME="formulaire">
<INPUT TYPE="text" NAME=saisie MAXLENGTH=40 SIZE=40 VALUE="entrez un status">
<INPUT TYPE="button" VALUE="changer status" onClick="changestatus()">
</FORM>

<SCRIPT LANGUAGE="JavaScript1.1">
function changestatus()
{
window.status=document.formulaire.saisie.value;
}
</SCRIPT>

VLINKCOLOR

Cette propriété est une chaîne de caractères qui spécifie la couleur des liens visités.


Syntaxe:

document.vlinkColor


Objet utilisé:

document

Exemple VLINKCOLOR

<SCRIPT LANGUAGE="JavaScript1.1">
document.vlinkColor="#FF0000";
document.write("Les liens visités seront ROUGES <BR>");
</SCRIPT>

<A HREF="http://www.imaginet.fr/ime/">Ungi !</A>

VOID

Cet opérateur spécifie une expression à être évaluée sans qu'une valeur soit retournée. Il faut utiliser cet opérateur afin de spécifier une expression comme un lien hypertexte. L'expression est évaluée sans être chargée à la place du document courant.


Syntaxe:

1. javascript:void (expression)
2. javascript:void expression

expression est une expression JavaScript à évaluer. Les parenthèses sont optionnelles.

Exemple VOID

VSPACE

Cette propriété représente une chaîne de caractères qui spécifie une marge en pixel entre le haut et le bas d'une image et le contenu du document. Représente l'attribut VSAPCE du marqueur <IMG>. Pour les images créées avec le constructeur Image(), la valeur de la propriété VSPACE est 0. La propriété VSAPCE doit être utilisée en lecture seulement.


Syntaxe:

nomImage.vspace

nomImage est soit le nom d'un objet "Image" ou un élément dans le tableau d'images.

Objet utilisé:

Image

Exemple VSPACE

<IMG SRC="ungi.gif" NAME="ungi" width=120 height=80 BORDER=4 VSPACE=35>
<BR>
Logo UNGI !
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("Espacement vertical autour de l'image : "+document.ungi.vspace);
</SCRIPT>
<BR>
Attention, la propriété 'vspace' est spécifique à netscape !

WIDTH

Cette propriété représente une chaîne de caractères qui spécifie la largeur d'une image en pixel ou en pourcentage. Représente l'attribut WIDTH du marqueur <IMG>. La propriété WIDTH doit être utilisée en lecture seulement.


Syntaxe:

nomImage.width

nomImage est soit le nom d'un objet "Image" ou un élément dans le tableau d'images.


Objet utilisé:

Image

Exemple WIDTH

<IMG SRC="ungi.gif" NAME="ungi" width=120 height=80 BORDER=4>
<BR>
Logo UNGI !
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("Largeur de l'image : "+document.ungi.width);
</SCRIPT>
<BR>