style, CSSStyleDeclarationNN 6 IE 4 DOM 2

Dans son sens le plus générique, un objet style est le point d´accès permettant aux scripts de lire et d´écrire des attributs de style individuels pour un élément donné. L´objet style présente (ou a le potentiel nécessaire pour présenter) chaque attribut de feuille de style pris en charge par le navigateur (les types d´attributs CSS décrits dans le chapitre 11).

 

Mais, en pratique, un objet style auquel vous accédez par le biais de la propriété style d´un objet élément HTML (l´une des propriétés partagées décrites précédemment dans ce chapitre) a une portée limitée: Il ne reflète que les paramètres CSS explicitement définis dans la balise de l´élément par le biais des paramètres ou de l´attribut style affectés à la propriété style de l´élément par script. Mais d´autres feuilles de style associées au navigateur (feuilles de style internes) et au document (règles de feuille de syle explicites définies dans l´élément <style> et les règles importées par le biais d´un élément link ou d´une règle @import) affectent également les caractéristiques d´affichage de l´élément. Il est possible de lire l´ensemble des attributs de feuille de style affectant un élément, la définition de style applicable, mais il faut utiliser une syntaxe dépendant du navigateur. IE utilise la propriété currentStyle d´un élément, alors que Netscape 6 utilise la méthode window.getComputedStyle() du DOM W3C. Les deux syntaxes renvoient un objet qui permet aux scripts de passer en revue la valeur de chaque valeur d´attribut de style applicable.

 

Alors que les trois objets IE ayant trait au style (style, currentStyle et runtimeStyle) renvoient un objet style avec des propriétés présentant des attributs de style CSS, la situation est plus complexe dans Netscape 6. D´un côté, Netscape 6 implémente une version de l´objet CSSStyleDeclaration du DOM W3C qui présente tous les attributs CSS en tant que propriétés. C´est la version à laquelle on accède par le biais de la propriété style d´un objet élément (comme dans IE, ce qui signifie que la propriété style d´un objet élément fonctionne sur les divers navigateurs). Mais lorsque vous lisez la feuille de style applicable (par le biais de window.getComputedStyle()), l´objet renvoyé ne présente pas les attributs CSS directement en tant que propriétés. A la place, vous devez utiliser les méthodes CSSStyleDeclaration (répertoriées ci-dessous) pour passer en revue une valeur d´attribut spécifique par nom. C´est une façon plus longue d´accéder à une valeur d´attribut de style applicable particulière, mais tout à fait dans le style du reste de la syntaxe de lecture d´attributs déployée dans le DOM W3C. La seule fois où cette différence entre navigateurs vous affecte est quand vous avez besoin de voir l´attribut de style applicable pour un style non modifié. Une fois que vous définissez une valeur d´attribut par le biais de la propriété style d´un objet élément, vous pouvez le lire par le biais de la propriété style quel que soit le navigateur).

 

Cette section répertorie les propriétés d´objet style, ainsi que les méthodes officielles Netscape 6 (DOM W3C), permettant d´accéder à ces attributs. Le DOM W3C regroupe un pourcentage important des propriétés de l´objet style dans un objet intitulé CSS2Properties. La spécification offre l´objet CSS2Properties comme un objet pratique facultatif pour les navigateurs. Heureusement pour les auteurs de scripts travaillant avec tous les navigateurs, Netscape 6 implémente CSS2Properties, au moins pour la propriété style de l´objet élément.

 

Les propriétés de l'objet style répertoriées ci-dessous correspondent aux attributs CSS. Pour plus de détails sur une propriété particulière, consultez la liste correspondante dans le chapitre 11.

 
Référence de modèle d'objet
 
  • [window.]document.getElementById("elementID").style
  • [window.]document.styleSheets[i].rules[j].style
  • [window.]document.styleSheets[i].cssRules[j].style
 
Propriétés spécifiques à l´objet
 
acceleratorazimuthbackground
backgroundAttachmentbackgroundColorbackgroundImage
backgroundPositionbackgroundPositionXbackgroundPositionY
backgroundRepeatbehaviorblockDirection
borderborderBottomborderBottomColor
borderBottomStyleborderBottomWidthborderCollapse
borderColorborderLeftborderLeftColor
borderLeftStyleborderLeftWidthborderRight
borderRightColorborderRightStyleborderRightWidth
borderSpacingborderStyleborderTop
borderTopColorborderTopStyleborderTopWidth
borderWidthbottomcaptionSide
clearclipclipBottom
clipLeftclipRightclipTop
colorcontentcounterIncrement
counterResetcssFloatcssText
cuecueAftercueBefore
cursordirectiondisplay
elevationemptyCellsfilter
fontfontFamilyfontSize
fontSizeAdjustfontStretchfontStyle
fontVariantfontWeightheight
imeModelayoutFlowlayoutGrid
layoutGridCharlayoutGridLinelayoutGridMode
layoutGridTypeleftletterSpacing
lineBreaklineHeightlistStyle
listStyleImagelistStylePositionlistStyleType
marginmarginBottommarginLeft
marginRightmarginTopmarkerOffset
marksmaxHeightmaxWidth
minHeightminWidthMozBinding
MozOpacityorphansoutline
outlineColoroutlineStyleoutlineWidth
overflowoverflowXoverflowY
paddingpaddingBottompaddingLeft
paddingRightpaddingToppage
pageBreakAfterpageBreakBeforepageBreakInside
pausepauseAfterpauseBefore
pitchpitchRangepixelBottom
pixelHeightpixelLeftpixelRight
pixelToppixelWidthplayDuring
posBottomposHeightposLeft
posRightposTopposWidth
positionquotesrichness
rightrubyAlignrubyOverhang
rubyPositionscrollbar3dLightColorscrollbarArrowColor
scrollbarBaseColorscrollbarDarkShadowColorscrollbarFaceColor
scrollbarHighlightColorscrollbarShadowColorscrollbarTrackColor
sizespeakspeakHeader
speakNumeralspeakPunctuationspeechRate
stressstyleFloattableLayout
textAligntextAlignLasttextAutospace
textDecorationtextDecorationBlinktextDecorationLineThrough
textDecorationNonetextDecorationOverlinetextDecorationUnderline
textIndenttextJustifytextKashidaSpace
textOverflowtextShadowtextTransform
textUnderlinePositiontopunicodeBidi
verticalAlignvisibilityvoiceFamily
volumewhiteSpacewidows
widthwordBreakwordSpacing
wordWrapwritingModezIndex
zoom
 
Méthodes spécifiques à l´objet
 
getPropertyCSSValue()getPropertyPriority()getPropertyValue()
item()removeProperty()setProperty()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

acceleratorNN s.o. IE 5 (Win) DOM s.o.

Voir Texte.

Pour IE 5 et les versions ultérieures sous Windows 2000 ou une version plus récente de Windows, les utilisateurs peuvent définir une préférence pour activer une touche d´accélération (ou des lettres accessKey de page Web) lors de l´enfoncement de la touche Alt. La propriété de la touche accelerator contrôle si l´élément est traité comme une chaîne de touche d´accélération activable ou non. Disponible comme propriété des objets IE currentStyle (en lecture seule) et runtimeStyle (en lecture/écriture) uniquement.

 
Exemple
 
document.getElementById("controlH").style.accelerator = true;
 
Valeur

Valeur booléenne: true | false.

 
Par défaut

false

azimuth, cue, cueAfter, cueBefore, elevation, pause, pauseAfter, pauseBefore, pitch, pitchRange, playDuring, richness, speak, speakHeader, speakNumeral, speakPunctuation, speechRate, stress, voiceFamily, volumeNN 6 IE s.o DOM 2

Lecture/écriture

Ce vaste groupe de propriétés provient des attributs CSS conçus pour les navigateurs qui utilisent les techniques de synthèse vocale pour diffuser le contenu des documents. Il n´y a pas que les malvoyants qui peuvent bénéficier de cette possibilité, mais Netscape 6 n´inclut pas cette fonctionnalité par défaut. Il est possible que d´autres fabricants de navigateurs construisent un navigateur avec synthèse vocale à partir du moteur Mozilla. Tout est en place dans le DOM Mozilla pour permettre la définition par script de ces propriétés de style. En attendant, ce ne sont que des paramètres fictifs dans Netscape 6. Pour en savoir plus sur ces attributs CSS, reportez-vous au chapitre 11.

 
Valeur

Toutes les valeurs pour ces propriétés sont des chaînes.

 
Par défaut

Aucune.

backgroundNN 6 IE 4 DOM 2

Lecture/écriture

Fournit l´attribut background de la feuille de style de l'élément. Il s'agit d'une forme courte d'attribut, en sorte que la propriété définie par script consiste en une chaîne de valeurs séparées par des espaces pour les propriétés backgroundAttachment, backgroundColor, backgroundImage, backgroundPosition et backgroundRepeat. La valeur background peut contenir une ou plusieurs valeurs, l'ordre des valeurs individuelles étant sans importance. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("myDiv").style.background = "url(logo.gif) repeat-y";
 
Valeur

Chaîne de valeurs séparées par des espaces, correspondant à une ou plusieurs propriétés de style d'arrière-plan individuel.

 
Par défaut

Aucune.

backgroundAttachmentNN 6 IE 4 DOM 2

Lecture/écriture

Définit la façon dont l'image se comporte par rapport à l'élément. L'image peut soit rester fixe dans la zone visible de l'élément, soit défiler en même temps que celui-ci lors du défilement du document. Lors du défilement, le fond défini comme fixe ressemble à la toile de fond immobile sur laquelle défile le générique d'un film.

 
Exemple
 
document.getElementById("myDiv").style.backgroundAttachment = "fixed";
 
Valeur

Chaîne ayant une des valeurs autorisées suivantes: fixed | scroll.

 
Par défaut

scroll

backgroundColorNN 6 IE 4 DOM 2

Lecture/écriture

Définit la couleur d'arrière-plan de l'élément. Si vous définissez également backgroundImage, l'image recouvre la couleur. Les pixels transparents de l'image laissent apparaître la couleur.

 
Exemple
 
document.getElementById("highlighted").style.backgroundColor = "yellow";
 
Valeur

Toute spécification de couleur valide (voir description en début de chapitre) ou transparent.

 
Par défaut

transparent

backgroundImageNN 6 IE 4 DOM 2

Lecture/écriture

Adresse URL de l'image d'arrière-plan de l'élément. Si vous définissez également backgroundColor, l'image recouvre la couleur. Les pixels transparents de l'image laissent apparaître la couleur.

 
Exemple
 
document.getElementById("navbar").style.backgroundImage =
"url(images/navVisited.jpg)";
 
Valeur

Toute adresse URL complète ou relative de fichier image au format URL CSS: url(filePath).

 
Par défaut

Aucune.

backgroundPositionNN 6 IE 4 DOM 2

Lecture/écriture

Indique les emplacements supérieur et gauche de l'image d'arrière-plan par rapport à la zone de contenu (et au remplissage) de l'élément. Les positions peuvent être spécifiées sous la forme de valeurs de longueur (avec des nombres et unités ou des pourcentages) ou selon une combinaison de constantes top, right, bottom, left et center. La propriété n´a aucun effet sur les images d´arrière-plan définies pour se répéter le long des deux axes. Certains types de valeurs ne fonctionnent pas (ou pas correctement) dans IE 4. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("div3").style.backgroundPosition = "20% 50%";
 
Valeur

Une chaîne contenant une valeur (à appliquer aux axes horizontal et vertical) ou une paire de valeurs délimitée par des espaces. Les valeurs peuvent être des valeurs de longueur explicites (avec une unité comme dans 30px 5px), des pourcentages (comme 50% 50%) ou des constantes de position qui ont un sens explicite pour leurs combinaisons.

Les valeurs de pourcentage sont interpolées avec logique. Par exemple, une valeur de 0% signifie que l´image touche le bord supérieur ou gauche du bloc d´élément; une valeur de 50% centre l´image verticalement ou horizontalement; une valeur de 100% signifie que l´image touche le bord inférieur ou droit du bloc d´élément.

 
Paire de valeurs constantesEquivalences en pourcentagePaire de valeurs constantesEquivalences en pourcentage
top left0% 0%center center50% 50%
left top0% 0%right 100% 50%
top50% 0%right center100% 50%
top center50% 0%center right100% 50%
center top50% 0%bottom left0% 100%
right top100% 0%left bottom0% 100%
top right100% 0%bottom50% 100%
left0% 50%bottom center50% 100%
left center0% 50%center bottom50% 100%
center left0% 50%bottom right 100% 100%
center50% 50%right bottom100% 100%
 
Par défaut

0% 0%

backgroundPositionX, backgroundPositionYNN s.o. IE 4 DOM s.o.

Lecture/écriture

Indiquent les emplacements supérieur et gauche de l'image d'arrière-plan par rapport à la zone de contenu (et au remplissage) de l'élément. Utiles si vous voulez ajuster l´image d´arrière-plan le long d´un axe sans toucher à l´autre axe. Les mêmes précautions IE 4 pour backgroundPosition s´appliquent à ces deux propriétés.

 
Exemple
 
document.getElementById("div3").style.backgroundPositionX = "20px";
document.getElementById("table2").style.backgroundPositionY = "10px;"
 
Valeur

Vous devez pouvoir spécifier des pourcentages correspondant respectivement à la largeur et la hauteur du cadre de l'élément de bloc au niveau duquel l'image (ou la mosaïque d´images) commence. Toutefois, les pourcentages ne fonctionnent pas toujours dans Internet Explorer 4 pour Windows (et jamais dans la version Macintosh), bien qu'ils soient renvoyés comme unités de valeur par défaut. Les valeurs exprimées en pixels sont plus sûres. Aucune constante autorisée n'est reconnue, hormis top et left.

 
Par défaut

0

backgroundRepeatNN 6 IE 4 DOM 2

Lecture/écriture

Indique la nécessité ou non de répéter l'image d'arrière-plan (spécifiée à l'aide de la propriété backgroundImage) et, le cas échéant, les axes de répétition. Vous pouvez utiliser la fonction de répétition d'images d'arrière-plan pour créer des bandes horizontales et verticales avec certains paramètres.

 
Exemple
 
document.getElementById("div3").style.backgroundRepeat = "repeat-y";
 
Valeur

Avec la valeur (chaîne) no-repeat, une instance de l'image apparaît dans l'élément à l'emplacement défini par la propriété backgroundposition (par défaut, dans l'angle supérieur gauche). Les répétitions normales se produisent le long des deux axes, mais une image peut être répétée sur une seule ligne (repeat-x) ou une seule colonne (repeat-y) . Pour rétablir la valeur par défaut, affectez la valeur repeat.

 
Par défaut

repeat

behaviorNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Contrôle si un comportement externe Windows IE est affecté à un élément.

 
Exemple
 
document.getElementById("div3").style.behavior = "url(#default#userData)";
 
Valeur

Une valeur d´URL formatée CSS, avec l´URL pointant sur un fichier .htc externe, ID d´un élément object qui charge un contrôle de comportement ActiveX dans la page ou un des comportements par défaut intégrés (auhe format url(#default#behaviorName)).

 
Par défaut

Aucune.

blockDirectionNN s.o. IE 5 (Win) DOM s.o.

Lecture seule

Renvoie la direction du script d´écriture de l´élément courant. Disponible comme propriété de l´objet IE currentStyle.

 
Exemple
 
if (document.getElementById("myDIV").style.blockDirection = "rtl") {
    // process right-to-left text
}
 
Valeur

Valeurs constantes sous forme de chaîne: ltr | rtl.

 
Par défaut

ltr

borderNN 6 IE 4 DOM 2

Lecture/écriture

Fournit la forme courte de propriété utilisée pour obtenir ou définir, en une seule instruction, les propriétés borderColor, borderStyle et/ou borderWidth pour les quatre bordures entourant un élément. Vous devez spécifier un style de bordure (voir borderStyle) pour que les modifications apportées à cette propriété affectent l'affichage de la bordure de l'élément (un style manquant est interprété comme pas de style du tout, donc pas de bordure). De nombreuses autres propriétés permettent de définir la largeur, le style et la couleur de bordures ou groupes de bordures si vous ne voulez pas que les quatre côtés soient identiques. Seuls les paramètres du composant explicitement définis dans les attributs de la balise de l'élément sont représentés dans la propriété. Vous pouvez cependant affecter des composants ne faisant pas partie de la balise initiale. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("announce").style.border = "inset red 4px";
 
Valeur

Chaîne délimitée par des espaces. Pour les valeurs des composants borderStyle et borderWidth, consultez la section consacrée aux propriétés respectives dans ce chapitre. Pour plus de détails sur la valeur borderColor, consultez la section consacrée aux couleurs CSS au début du chapitre 11.

 
Par défaut

Aucune.

borderBottom, borderLeft, borderRight, borderTopNN 6 IE 4 DOM 2

Lecture/écriture

Formes courtes de propriétés utilisées pour obtenir ou définir, en une seule instruction, les propriétés borderColor, borderStyle et/ou borderWidth pour un seul côté d'un élément. Vous devez spécifier un style de bordure (voir borderStyle) pour que les modifications apportées à ces propriétés affectent l'affichage de la bordure de l'élément (un style manquant est interprété comme pas de style du tout, donc pas de bordure). Si vous voulez que les quatre côtés soient identiques, consultez la section consacrée à l'attribut border. Seuls les paramètres du composant explicitement définis dans les attributs de la balise de l'élément sont représentés dans la propriété. Vous pouvez cependant affecter des composants ne faisant pas partie de la balise initiale. Disponible comme propriétés des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("announce").style.borderBottom = "inset red 4px";
document.getElementById("announce").style.borderLeft = "solid #20ff00 2px";
document.getElementById("announce").style.borderRight = "double 3px";
document.getElementById("announce").style.borderTop = "outset red 8px";
 
Valeur

Chaîne délimitée par des espaces. Pour plus de détails sur le paramétrage de borderSideStyle et borderSideWidth , consultez les sections de ce chapitre qui y sont consacrées. Pour plus de détails sur les formats de valeur borderSideColor, consultez la section consacrée aux couleurs au début du chapitre 11.

 
Par défaut

Aucune.

borderBottomColor, borderLeftColor, borderRightColor, borderTopColorNN 6 IE 4 DOM 2

Lecture/écriture

Fournit la couleur d'un côté individuel de la bordure d'un élément. Veillez à ne pas abuser de ces propriétés en mélangeant des couleurs mal assorties. Consultez également la section consacrée à l'attribut borderColor pour plus de détails sur la définition, en une seule instruction, de la couleur de groupes de côtés.

 
Exemple
 
document.getElementById("announce").style.borderBottomColor = "red";
document.getElementById("announce").style.borderLeftColor = "#20ff00";
document.getElementById("announce").style.borderRightColor = "rgb(100, 75, 0)";
document.getElementById("announce").style.borderTopColor = "rgb(90%, 0%, 25%)";
 
Valeur

Pour plus de détails sur les valeurs de couleur CSS, consultez la section consacrée aux couleurs, au début du chapitre 11.

 
Par défaut

Aucune.

borderBottomStyle, borderLeftStyle, borderRightStyle, borderTopStyleNN 6 IE 4 DOM 2

Lecture/écriture

Fournit le style de ligne d'un côté individuel de la bordure d'un élément. Les attributs spécifiques aux côtés vous permettent de remplacer un style appliqué aux quatre côtés à l'aide des propriétés border ou borderStyle. Consultez également la section consacrée à la propriété borderStyle pour plus de détails sur la définition, en une seule instruction, du style de groupes de côtés.

 
Exemple
 
document.getElementById("announce").style.borderBottomStyle = "groove";
document.getElementById("announce").style.borderLeftStyle = "double";
document.getElementById("announce").style.borderRightStyle = "solid";
document.getElementById("announce").style.borderTopStyle = "inset";
 
Valeur

Les valeurs de style sont des constantes insensibles à la casse, associées à des méthodes spécifiques d'affichage des bordures. Les constantes de style CSS sont: dashed, dotted, double, groove, hidden, inset, none, outset, ridge et solid. Les navigateurs ne reconnaissent pas tous la totalité des valeurs des recommandations CSS. Pour plus de détails sur les styles de bordure disponibles, consultez la liste d'attributs border-style dans le chapitre 11.

 
Par défaut

Aucune.

borderBottomWidth, borderLeftWidth, borderRightWidth, borderTopWidthNN 6 IE 4 DOM 2

Lecture/écriture

Fournit la largeur d'un côté individuel de la bordure d'un élément. Consultez également la section consacrée à la propriété borderWidth pour plus de détails sur la définition, en une seule instruction, de la largeur de groupes de côtés.

 
Exemple
 
document.getElementById("announce").style.borderBottomWidth= "thin";
document.getElementById("announce").style.borderLeftWidth = "thick";
document.getElementById("announce").style.borderRightWidth = "2px";
document.getElementById("announce").style.borderTopWidth = "0.5em";
 
Valeur

Trois constantes insensibles à la casse (thin | medium | thick) permettent au navigateur de définir le nombre de pixels utilisés pour afficher la bordure. Pour une plus grande précision, vous pouvez spécifier une valeur de longueur (pour en savoir plus sur les valeurs de longueur CSS, reportez-vous au début du chapitre 11).

 
Par défaut

medium

borderCollapseNN 6 IE 5 DOM 2

Lecture/écriture

Contrôle le modèle de bordure de tableau que l´élément table doit utiliser.

 
Exemple
 
document.getElementById("myTable").style.borderCollapse = "separate";
 
Valeur

Deux constantes insensibles à la casse, sous forme de chaîne: collapse | separate. IE pour Macintosh et Netscape 6 ne répondent pas aux modifications de cette propriété.

 
Par défaut

separate

borderColorNN 6 IE 4 DOM 2

Lecture/écriture

Forme courte d'attribut permettant d'appliquer à plusieurs côtés d'une bordure la même couleur ou une couleur différente. Vous pouvez spécifier entre une et quatre valeurs de couleur, séparées par des espaces. Le nombre de valeurs spécifiées détermine à quels côtés de la bordure ces valeurs doivent être appliquées.

 
Exemple
 
document.getElementById("announce").style.borderColor = "red";
document.getElementById("announce").style.borderColor = "red green";
document.getElementById("announce").style.borderColor =
"black rgb(100, 75, 0) #c0c0c0";
document.getElementById("announce").style.borderColor = "yellow green blue red";
 
Valeur

Cette propriété accepte une, deux, trois ou quatre valeurs de couleur sous forme de chaîne, selon le nombre de côtés et les côtés spécifiques auxquels vous souhaitez appliquer les couleurs. Pour plus de détails sur la façon dont le nombre de valeurs affecte cette propriété, consultez la liste d'attributs border-color dans le chapitre 11.

 
Par défaut

Propriété couleur de l'objet (si définie).

borderSpacingNN 6 IE 5 DOM 2

Lecture/écriture

Contrôle l´espacement entre les cellules du tableau lorsque le tableau est en mode de bordures séparées (par défaut), similaire à la propriété cellSpacing de l´objet table. IE pour Macintosh ne répond pas aux modifications apportées à la valeur de cette propriété. Disponible dans IE comme propriété de l´objet style.

 
Exemple
 
document.getElementById("myTable").style.borderSpacing= "12px";
 
Valeur

Valeur de longueur CSS sous forme de chaîne (reportez-vous au début du chapitre 11 pour en savoir plus sur les valeurs de longueur CSS).

 
Par défaut

Aucune.

borderStyleNN 6 IE 4 DOM 2

Lecture/écriture

Forme courte de propriété permettant de définir, en une seule instruction, un style identique ou différent pour plusieurs côtés de bordure. Vous pouvez spécifier entre une et quatre valeurs de style, séparées par des espaces. Le nombre de valeurs spécifiées détermine à quels côtés de la bordure ces valeurs doivent être appliquées.

 
Exemple
 
document.getElementById("announce").style.borderStyle = "solid";
document.getElementById("announce").style.borderStyle = "solid double";
document.getElementById("announce").style.borderStyle =
"double groove groove double";
 
Valeur

Les valeurs de style sont des constantes insensibles à la casse, associées à des méthodes spécifiques d'affichage des bordures. Les constantes de style CSS sont: dashed, dotted, double, groove, hidden, inset, none, outset, ridge et solid. Les navigateurs ne reconnaissent pas tous la totalité des valeurs des recommandations CSS. Pour plus de détails sur les styles de bordure disponibles, consultez la liste d'attributs border-style dans le chapitre 11.

Cette propriété accepte une, deux, trois ou quatre valeurs de style sous forme de chaîne, selon le nombre de côtés et les côtés spécifiques auxquels vous souhaitez appliquer les styles. Pour plus de détails sur la façon dont le nombre de valeurs affecte cette propriété, consultez la liste d'attributs border-style dans le chapitre 11.

 
Par défaut

none

borderWidthNN 6 IE 4 DOM 2

Lecture/écriture

Forme courte de propriété permettant de définir, en une seule instruction, une largeur identique ou différente pour plusieurs côtés de bordure. Vous pouvez spécifier entre une et quatre valeurs de largeur, séparées par des espaces. Le nombre de valeurs détermine les côtés auxquels seront affectées ces largeurs.

 
Exemple
 
document.getElementById("founderQuote").style.borderWidth = "3px 5px";
 
Valeur

Trois constantes insensibles à la casse (thin | medium | thick) permettent au navigateur de définir précisément le nombre de pixels utilisés pour afficher la bordure. Pour une plus grande précision, vous pouvez spécifier une valeur de longueur (pour en savoir plus sur les valeurs de longueur, reportez-vous au début du chapitre 11).

Cette propriété accepte une, deux, trois ou quatre valeurs, selon le nombre de côtés et les côtés spécifiques auxquels vous souhaitez appliquer les largeurs. Pour plus de détails sur la façon dont le nombre de valeurs affecte cette propriété, consultez la liste d'attributs border-width dans le chapitre 11.

 
Par défaut

medium

bottomNN 6 IE 5 DOM 2

Lecture/écriture

Pour les éléments à positionnement absolu, définit la position du bord inférieur du cadre d'un élément (contenu plus remplissage, bordure et/ou marge inférieurs) par rapport au bord inférieur du conteneur père. IE pour Windows et Netscape 6 ont un comportement inattendu lorsque l´élément positionné utilise le contexte de positionnement racine. Au lieu d´utiliser le bas du document comme bord de comparaison, ces navigateurs utilise le bas de l´espace de la fenêtre du navigateur. Cela signifie que la position précise de l´élément varie selon la taille de la fenêtre du navigateur de l´utilisateur. IE 5 pour Macintosh utilise le bas du document comme bord de comparaison. Cela rend l´utilisation de la propriété bottom pour un élément positionné imbriqué dans un autre élément positionné plus pratique. Dans le cas d'un élément à positionnement relatif, le décalage est calculé par rapport au côté inférieur de l'emplacement où l'élément devrait normalement apparaître.

 

Pour effectuer des calculs à partir de cette valeur dans IE, extrayez les propriétés pixelBottom et posBottom, qui renvoient de véritables valeurs numériques.

 
Exemple
 
document.getElementById("blockD2").style.bottom = "35px";
 
Valeur

Chaîne composée d'une valeur numérique et d'une unité de mesure de longueur, d'un pourcentage ou d'une valeur auto.

 
Par défaut

auto

captionSideNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Contrôle l´emplacement de l´élément caption (imbriqué dans un élément table) par rapport au cadre du tableau.

 
Exemple
 
document.getElementById("myTable").style.captionSide = "bottom";
 
Valeur

Chaîne insensible à la casse de l'une des constantes suivantes. bottom | left | right | top. Il se peut que certains navigateurs soient limités aux valeurs bottom et top.

 
Par défaut

top

currentStyleNN s.o. IE 5 DOM s.o.

Lecture seule

Renvoie un objet style avec des propriétés qui reflètent les valeurs effectives appliquées à l´élément. Cette propriété prend en compte les règles de feuille de style définies dans un élément style , règles importées à partir des fichiers de feuilles de style externes et des attributs de style internes. Comme la propriété style ne reflète que les attributs de style internes, la propriété currentStyle est plus utile pour lire les valeurs initiales après le chargement d´un document. Pour modifier des attributs de style, vous pouvez utiliser les propriétés de l´objet style de l´élément. Pour des capacités similaires dans Netscape 6, reportez-vous à la méthode window.getComputedStyle() .

 
Exemple
 
var currSize = document.getElementById("elementID").currentStyle.fontSize;
 
Valeur

Référence de l'objet style .

 
Par défaut

L´objet style effectif.

clearNN 6 IE 4 DOM 2

Lecture/écriture

Détermine si l'élément peut s'afficher dans la même bande horizontale que l'élément flottant. Généralement, l'attribut de style float d'un autre élément avoisinant est paramétré sur left ou right. Pour éviter que l'élément courant ne se trouve dans la même bande que le bloc flottant, paramétrez la propriété clear sur le même côté (left ou right). Si vous ne savez pas avec certitude où se produira le chevauchement éventuel, paramétrez la propriété clear sur both. Si la propriété clear d'un élément est paramétrée sur une valeur autre que none, l'élément s'affiche au début de la ligne disponible suivante au-dessous de l'élément flottant.

 
Exemple
 
document.getElementById("myDiv").style.clear = "both";
 
Valeur

Chaîne insensible à la casse de l'une des constantes suivantes. both | left | none | right.

 
Par défaut

none

clipNN 6 IE 4 DOM 2

Lecture/écriture

Définit une zone de découpe d'un élément positionnable. La zone de découpe (clipping) est la zone du calque de l'élément dans laquelle apparaît le contenu. Il peut arriver que la découpe ne fonctionne pas bien dans Internet Explorer 4 pour Macintosh. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("art2").style.clip = "rect(5px 100px 40px 0)";
 
Valeur

Chaîne non sensible à la casse composée soit de la constante auto, soit du paramétrage de l'attribut CSS clip, qui détermine la forme (uniquement rect pour le moment) et la position du rectangle de découpe par rapport au coin supérieur gauche de l'élément original. Lorsque vous spécifiez les longueurs des côtés de la zone de détourage, suivez toujours l'ordre suivant: top, right, bottom, left. Reportez-vous à la section consacrée aux valeurs de longueur au début du chapitre 11. La valeur auto aligne la zone de découpe sur le bloc qui contient le contenu. Dans Internet Explorer, la largeur peut s'étendre à celle du conteneur père (comme l'élément body).

 
Par défaut

Aucune.

clipBottom, clipLeft, clipRight, clipTopNN s.o. IE 5 (Win) DOM s.o.

Lecture seule

Renvoie une zone de découpe d'un élément positionnable. Disponible dans IE comme propriété de l´objet currentStyle uniquement.

 
Exemple
 
var cl = document.getElementById("art2").style.clipLeft;
 
Valeur

Constantes auto ou chaînes de longueur, non sensibles à la casse: Pour plus de détails sur les valeurs de longueur CSS, reportez-vous au début du chapitre 11.

 
Par défaut

Aucune.

colorNN 6 IE 4 DOM 2

Lecture/écriture

Définit l'attribut de feuille de style color de premier plan (texte) de l'élément. Pour certains éléments de type graphique, tels que les contrôles de formulaire, l'attribut color peut également être appliqué aux bordures, ou autres parties, d'un élément. Ce comportement dépend du navigateur et peut donc varier d'un navigateur à l'autre.

 
Exemple
 
document.getElementById("specialDiv").style.color = "green";
 
Valeur

Spécification de couleur CSS non sensible à la casse (reportez-vous à la section qui y est consacrée au début du chapitre 11).

 
Par défaut

black

contentNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Définit le contenu supplémentaire à afficher avant ou après un élément (de concert avec les pseudo-classes :before et :after). Bien que la propriété soit disponible dans IE 5 pour Mac et Netscape 6, les valeurs sont des chaînes vides et le contenu affiché (qui n´apparaît que dans Netscape 6) ne change pas si vous lui affectez une valeur.

 
Valeur

Reportez-vous à la section consacrée à l´attribut CSS content dans le chapitre 11.

 
Par défaut

Aucune.

counterIncrement, counterResetNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Ces propriétés sont des paramètres fictifs réservés pour les implémentations futures des mécanismes de compteurs automatiques spécifiés dans la spécification CSS. Elles ne sont pas encore fonctionnelles dans les navigateurs indiqués ci-dessus.

 
Valeur

Reportez-vous à la section consacrée aux attributs CSS counterIncrement et counterReset dans le chapitre 11.

 
Par défaut

Aucune.

cssFloatNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Contrôle l´attribut CSS float d´un élément, permettant au contenu du texte adjacent d´entourer des éléments de bloc, tels que les images. La modification de cette valeur dans IE 5 pour Mac n´a aucun effet. Le préfixe « css » dans le nom de cette propriété permet d´éviter les conflits potentiels avec le mot clé JavaScript float.

 
Exemple
 
document.getElementById("myDiv").style.cssFloat = "right";
 
Valeur

Chaîne de valeur constante autorisée: left | right | none.

 
Par défaut

none

cssTextNN 6 IE 4 DOM 2

Lecture seule

Renvoie une règle de feuille de style CSS complète, sous forme de chaîne. Si la règle comprend une forme courte de paramètres d´attributs de style (comme border), les navigateurs renvoient des versions modifiées d´après ce qu´ils pensent que la valeur signifie. Si l'attribut style d'un élément est style="border: groove red 3px", dans IE pour Windows, la propriété cssText de cet élément renvoie:

BORDER-RIGHT: red 3px groove; BORDER-TOP: red 3px groove; 
BORDER-LEFT: red 3px groove; BORDER-BOTTOM: red 3px groove
 

Dans IE pour Mac, elle renvoie:

{BORDER-TOP: 3px groove red; BORDER-RIGHT: 3px groove red; 
BORDER-BOTTOM: 3px groove red; BORDER-LEFT: 3px groove red}
 

Et dans Netscape 6:

border: 3px groove red;
 

Remarque: Chaque navigateur manipule la séquence de valeurs individuelles. Vous pouvez toutefois affecter à la propriété une valeur de forme courte et ce, dans l´ordre que vous désirez. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("block3").style.cssText = "margin: 2px; font-size: 14pt";
 
Valeur

Valeurs d'attributs de style séparés par des points-virgules, sous forme de chaîne.

 
Par défaut

Aucune.

cue, cueAfter, cueBefore

Voir azimuth.

cursorNN 6 IE 4 DOM 2

Lecture/écriture

Spécifie la forme du curseur lorsque le pointeur de la souris se trouve au-dessus de l'élément. L'apparence précise des curseurs dépend du système d'exploitation. Avant de modifier la forme d'un curseur, examinez les curseurs standard utilisés par le navigateur et le système d'exploitation. En effet, les utilisateurs s'attendent à ce qu'une forme de curseur ait la même signification dans toutes les applications.

 

Le paramétrage de cette propriété n'affecte le curseur que s'il se trouve au-dessus de l'élément courant, sans l'affecter directement de façon générale.

 
Exemple
 
document.getElementById("hotStuff").style.cursor = "pointer";
 
Valeur

Toute constante de curseur, sous forme de chaîne, comme elle est prise en charge par divers navigateurs et versions.

Le paramètre IE 6 d´une URL externe nécessite l´adresse d´un fichier de curseur doté de l´extension .cur ou .ani.

 
Nom du curseurIE pour WindowsIE/MacNN
aliass.os.o6
all-scroll6s.os.o
auto446
cells.os.o6
col-resize6s.os.o
context-menus.os.o6
copys.os.o6
count-downs.os.o6
count-ups.os.o6
count-up-downs.os.o6
crosshair446
default446
e-resize446
grabs.os.o6
grabbings.os.o6
hand44s.o
help446
move446
n-resize446
ne-resize446
no-drop6s.os.o
not-allowed6s.os.o
nw-resize446
pointer446
progress6s.os.o
row-resize6s.os.o
s-resize446
se-resize446
spinnings.os.o6
sw-resize446
text446
url(uri) 6s.os.o
vertical-text6s.os.o
w-resize446
wait446
 
Par défaut

auto

directionNN 6 IE 5 DOM 2

Lecture/écriture

Renvoie la direction du script d´écriture de l´élément courant. Conçue essentiellement pour les éléments au sein des documents avec des directions d´écriture de scripts mixtes (par exemple, un mélange de texte en français et en arabe).

 
Exemple
 
document.getElementById("term3").style.direction = "ltr";
 
Valeur

Valeurs constantes sous forme de chaîne: ltr | rtl.

 
Par défaut

ltr

displayNN 6 IE 4 DOM 2

Lecture/écriture

Contrôle le type de cadre CSS utilisé pour afficher l´élément. Les paramètres les plus courants pour le contenu du corps déterminent si un élément est affiché comme élément de bloc ou élément interne. Lorsque l'attribut a pour valeur none, l'élément est masqué et tous les contenus avoisinants sont redimensionnés pour remplir l'espace. Certains types de cadres sont spécifiques aux tableaux et aux listes.

 
Exemple
 
document.getElementById("instructionDiv").style.display = "none";
 
Valeur

Toute constante d´affichage, sous forme de chaîne, comme elle est prise en charge par divers navigateurs et versions.

 
Type d´affichageIE pour WindowsIE/MacNN
block546
inline546
inline-block5.5s.os.o
none446
run-ins.o56
table-footer-group5.556
table-header-group556
 
Par défaut

Dépend de l´élément.

elevation

Voir azimuth.

emptyCellsNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Lorsqu´un tableau est défini pour afficher le format de cadre de cellules séparées (par défaut) et qu´une bordure est établie pour les éléments td dans ce tableau, la propriété de style emptyCells contrôle si le tableau affiche des bordures autour des cellules vides de contenu.

 
Exemple
 
document.getElementById("myTable").style.emptyCells = "hide";
 
Valeur

Chaîne de valeurs constantes autorisées: hide | show.

 
Par défaut

show

filterNN s.o. IE 4 (Win) DOM s.o.

Lecture/écriture

Définit le filtre visuel, de transition ou de fondu à appliquer au contenu d'un élément. Un filtre visuel peut être appliqué à un élément pour produire des effets tels que retournement du contenu, néon, ombre portée et bien d'autres. Un filtre de transition agit sur la visibilité d'un élément. La valeur du filtre de transition détermine quel effet visuel doit être appliqué à la transition entre le masquage et l'affichage de l'élément (ou vice versa). Parmi les effets possibles, on peut citer l'effet de volet horizontal ou vertical. Un filtre de fondu détermine la vitesse de la transition entre deux états. Bien que la propriété filter existe dans Internet Explorer pour Macintosh, elle n´y est pas opérationnelle.

 
Exemple
 
document.getElementById("fancy").style.filter= "dropshadow()";
 
Valeur

Chaque propriété de filtre peut être associée à plusieurs types de filtres, séparés par un espace. Chaque type de filtre est suivi d'un couple de parenthèses permettant de définir les paramètres de comportement du filtre pour l'élément actuel. Un paramètre consiste généralement en un couple nom/valeur relié par le signe égale. Remarque: Microsoft a introduit une syntaxe de filtre entièrement nouvelle à partir de Microsoft Internet Explorer 5.5 pour Window. La nouvelle syntaxe fonctionne en parallèle avec l´ancienne (pour l´instant). Pour plus de détails sur les paramètres de filtres, consultez la liste d'attributs de feuille de style filter dans le chapitre 11.

 
Par défaut

Aucune.

fontNN 6 IE 4 DOM 2

Lecture/écriture

Forme courte de propriété permettant de définir, en une seule instruction d'affectation, une ou plusieurs propriétés liées aux polices: fontFamily, fontSize, lineHeight (qui doit être précédée d´un symbole / dans cette propriété) fontStyle, fontVariant et fontWeight. Une liste de valeurs séparées par un espace (dans un ordre quelconque) est appliquée aux propriétés de police spécifiques pour lesquelles ce type de valeur est admis. Ou vous pouvez court-circuiter ces paramètres individuels en choisissant l´une des polices système par défaut (dépendantes du système d´exploitation): caption | icon | menu | message-box | small-caption | status-bar.

 
Exemple
 
document.getElementById("subhead").style.font = "bolder small-caps 16pt";
 
Valeur

Pour la syntaxe et des exemples de types de valeur applicables aux propriétés de police, voir les sections consacrées aux propriétés en question.

 
Par défaut

Aucune.

fontFamilyNN 6 IE 4 DOM 2

Lecture/écriture

Fournit la liste des familles de polices à utiliser, par ordre de priorité, pour afficher le contenu de l'objet. Un ou plusieurs noms de famille de polices peuvent être inclus dans une liste de valeurs de propriété séparées par des virgules. Si un nom de famille de police se compose de plusieurs mots, il doit être entouré de guillemets intérieurs. Disponible comme propriété des objets IE style et runtimeStyle uniquement, mais les propriétés de polices individuelles sont disponibles dans currentStyle également.

 
Exemple
 
document.getElementById("subhead").style.fontFamily =
    "'Century Schoolbook', Times, serif";
 
Valeur

Nombre quelconque de noms de police, séparés par des virgules. Les noms constitués de plusieurs mots doivent être placés entre guillemets. Les noms de familles génériques reconnus sont: serif | sans-serif | cursive | fantasy | monospace.

 
Par défaut

Valeur par défaut du navigateur.

fontSizeNN 6 IE 4 DOM 2

Lecture/écriture

Définit la taille de police de l'élément. Plusieurs méthodes sont disponibles. Un ensemble de constantes (xx-small, x-small, small, medium, large, x-large, xx-large) permet de définir des tailles dites absolute. En réalité, elles sont absolues pour autant que l'on parle d'un seul navigateur et d'un seul système, car leurs points de référence varient en fonction du navigateur et du système d'exploitation (un peu comme les anciennes tailles de polices HTML de 1 à 7). Mais elles permettent à l'auteur d´être certain que si la valeur d'un élément est paramétrée sur large, il s'affichera plus grand que elle est paramétrée sur medium.

 

Un autre ensemble de constantes (larger, smaller) permet de définir des tailles dites relatives. Du fait que l'attribut de style font-size est hérité de l'élément parent, ces tailles relatives sont appliquées à l'élément parent pour déterminer la taille de caractères de l'élément actuel. C'est au navigateur de déterminer exactement de combien la taille de police doit être agrandie ou réduite, et cela dépend en grande partie de la façon dont la taille de police de l'élément parent a été définie. Si elle a été définie comme taille absolue (large par exemple), le paramétrage de la taille de police de l'élément enfant sur larger entraînera l'affichage d'une police de taille x-large dans le navigateur. L'incrémentation n'est pas aussi tranchée si la taille de police de l'élément parent est définie par une taille ou un pourcentage.

 

Si vous spécifiez une valeur de longueur pour la propriété fontSize, vous obtiendrez une meilleure cohérence d´un système d´exploitation à un autre si vous utilisez des unités telles que les pixels (px) ou les cadratins (em) au lieu de points (pt). Les unités em sont calculées sur la taille de police de l'élément parent. Enfin, vous pouvez paramétrer fontSize sur un pourcentage calculé par rapport à la taille de police de l'élément parent.

 
Exemple
 
document.getElementById("teeny").style.fontSize = "x-small";
 
Valeur

Valeurs insensibles à la casse, sous forme de chaîne, d'une des catégories suivantes. Pour une taille absolue, l'une des constantes suivantes: xx-small | x-small | small | medium | large | x-large | xx-large. Pour une taille relative, l'une des constantes suivantes: larger | smaller. Pour en savoir plus sur les valeurs de longueur (length), reportez-vous à la section consacrée aux valeurs de longueur CSS au début du chapitre 11. Pour en savoir plus sur les valeurs de pourcentage, reportez-vous à la section consacrée à la valeur de pourcentage et au symbole %.

 
Par défaut

Taille de police de l'élément parent.

fontSizeAdjustNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Fournit la valeur d´aspect de la police, généralement de la première famille de police dans une séquence d´attributs de famille de police, forçant les autres familles de police à calculer leur taille de police d´affichage afin qu´elle se rapproche le plus près possible de celle de la famille de police principale. Bien que cette propriété soit un élément de l´objet style dans IE 5 pour Mac et Netscape 6, ni l´attribut style ni les modifications qui lui ont été apportées par script n´affectent l´affichage de la police.

 
Exemple
 
document.getElementById("myDIV").style.fontSizeAdjust = "0.56";
 
Valeur

Valeur d´aspect numérique, sous forme de chaîne entre guillemets, ou none.

 
Par défaut

none

fontStretchNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Fournit l´espacement entre les caractères pour l´élément, selon les largeurs d´espacement disponibles pour la famille de police actuelle. Bien que cette propriété soit un élément de l´objet style dans IE 5 pour Mac et Netscape 6, ni l´attribut style ni les modifications qui lui ont été apportées par script n´affectent l´affichage de la police.

 
Exemple
 
document.getElementById("myDIV").style.fontStretch= "ultra-condensed";
 
Valeur

Chaîne de valeurs constantes autorisées: normal | wider | narrower | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded ou none.

 
Par défaut

none

fontStyleNN 6 IE 4 DOM 2

Lecture/écriture

Indique si l'élément s'affiche avec un style de police normal (roman), italique ou oblique. Si pour la famille de polices fontFamily spécifiée, des styles intitulés Italic et/ou Oblique sont présents dans le navigateur, l'attribut fontStyle utilise ces derniers pour afficher l'élément. Si ces styles de police spécialisés ne sont pas disponibles dans le système, le navigateur applique généralement un algorithme d'inclinaison à la police normale pour produire le style italique. La qualité des documents imprimés avec des styles de police générés électroniquement dépend de la qualité de l'interaction entre l'ordinateur client et l'imprimante. Les logiciels d´ordinateur personnel incluent généralement d´autres types d´affichage de police sous le titre Style. Reportez-vous à fontVariant et fontWeight pour d´autres styles de police.

 
Exemple
 
document.getElementById("emphasis").style.fontStyle = "italic";
 
Valeur

L'une des constantes sous forme de chaîne suivantes: normal | italic | oblique.

 
Par défaut

normal

fontVariantNN 6 IE 4 DOM 2

Lecture/écriture

Détermine si l'élément doit être affiché tout en majuscules, les minuscules du code source étant affichées en majuscules plus petites. Si une famille de polices comprend une variante Petites capitales, le navigateur doit normalement utiliser cette dernière. Dans la plupart des cas, cependant, le navigateur affiche les minuscules du code source en majuscules de plus petite taille que les majuscules normales. En pratique, Internet Explorer 4 restitue le contenu intégral du code source sous forme de majuscules de même taille que la police de l'élément parent, quelle que soit la casse du code source. Les versions de Microsoft Internet Explorer plus récentes et Netscape 6 utilisent deux tailles de majuscules différentes.

 
Exemple
 
document.getElementById("emphasis").style.fontVariant = "small-caps";
 
Valeur

L'une des constantes suivantes, sous forme de chaînes: normal | small-caps.

 
Par défaut

normal

fontWeightNN 6 IE 4 DOM 2

Lecture/écriture

Définit la graisse (épaisseur) de la police de caractères à appliquer à l'élément. Le système de classification des graisses CSS est extrêmement précis et, si la plupart des navigateurs ne sont pas en mesure de reproduire à l'écran les graisses les plus subtiles, celles-ci se justifient lors de l'impression des contenus. Ce système utilise un échelle numérique allant de 100 à 900, par incréments de 100. Par conséquent, une valeur fontWeight de 100 représenterait le minimum et 900 le maximum d'affichage pour le caractère gras. L'attribut normal (graisse par défaut de n'importe quelle police) équivaut à une valeur de graisse (font-weight) de 400; l'attribut standard bold (gras) équivaut à 700. D'autres paramètres (bolder et lighter) vous permettent de spécifier une graisse dont la valeur est relative à celle de l'élément parent.

 
Exemple
 
document.getElementById("hotStuff").style.fontWeight = "bold";
 
Valeur

L'une des constantes suivantes: bold | bolder | lighter | normal | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900.

 
Par défaut

normal

height, widthNN 6 IE 4 DOM 2

Lecture/écriture

Indique la hauteur et la largeur de l'élément (et leurs unités). Les valeurs étant des chaînes contenant les unités affectées, vous ne pouvez pas utiliser ces propriétés pour des calculs. Extrayez des copies des nombres en utilisant parseFloat() sur les valeurs; ou pour IE, utilisez les propriétés pixelHeight, pixelWidth, posHeight et posWidth. Les modifications apportées à ces propriétés ne sont pas nécessairement visibles tant que l'attribut de style position de l'élément n'est pas défini.

 

En mode de compatibilité avec les normes dans IE 6 (où document.compatType == "CSS1Compat"), ces dimensions ne s´appliquent qu´à la partie « contenu » d´un élément, sans tenir compte du remplissage, des bordures ou des marges. Par exemple, si un élément positionné qui est doté de remplissage et de bordures doit être dimensionné à une taille rectangulaire précise, vous devez soustraire l´épaisseur du remplissage et des bordures des valeurs de hauteur et de largeur pour que l´élément ait la taille désirée.

 
Exemple
 
document.getElementById("viewArea").style.height = "450px";
 
Valeur

Chaîne composée d'une valeur numérique et d'une mesure de longueur ou de pourcentage.

 
Par défaut

Aucune.

imeModeNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Contrôle la présence de l´éditeur de méthode de saisie dans IE pour Windows pour les versions de navigateurs et de systèmes qui prennent en charge les langues comme le chinois, le japonais et le coréen.

 
Exemple
 
document.getElementById("nameEntry").style.imeMode = "active";
 
Valeur

Chaîne de valeurs constantes autorisées: active | auto | disabled | inactive.

 
Par défaut

auto

layoutFlowNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Conçue principalement pour les langues qui affichent des caractères dans des phrases verticales , elle contrôle la progression du contenu. Remplacée par la propriété writingMode à partir de IE 5.5 pour Windows.

 
Valeur

L'une des constantes suivantes sous forme de chaîne: horizontal | vertical-ideographic.

 
Par défaut

horizontal

layoutGridNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Forme courte de propriété permettant de définir, en une seule instruction d'affectation, une ou plusieurs propriétés liées à la grille de présentation (layoutGridChar, layoutGridLine, layoutGridMode et layoutGridType). Ces attributs sont utilisés principalement avec le contenu en langues asiatiques.

 
Exemple
 
document.getElementById("subhead").style.layoutGrid = "2em strict";
 
Valeur

Pour la syntaxe et des exemples de types de valeur applicables aux propriétés de grille de présentation, reportez-vous aux sections consacrées aux propriétés en question.

 
Par défaut

Aucune.

layoutGridCharNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Détermine la taille de la grille de caractères des langues asiatiques pour les éléments de niveau bloc.

 
Exemple
 
document.getElementById("subhead").style.layoutGrid Char= "auto";
 
Valeur

Chaîne composée d´une valeur de longueur CSS explicite, d´auto ou de none.

 
Par défaut

none

layoutGridLineNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Détermine la hauteur de ligne de la grille de caractères des langues asiatiques pour les éléments de niveau bloc.

 
Exemple
 
document.getElementById("subhead").style.layoutGrid Line= "120%";
 
Valeur

Chaîne composée d´une valeur de longueur CSS explicite, d´auto ou de none.

 
Par défaut

none

layoutGridModeNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Spécifie si la grille de caractères pour les langues asiatiques doit être uni- ou bi-dimensionnelle.

 
Exemple
 
document.getElementById("subhead").style.layoutGrid Mode= "both";
 
Valeur

Valeurs constantes sous forme de chaîne: both | char (pour les éléments internes) | line (pour les éléments de niveau bloc) | none.

 
Par défaut

both

layoutGridTypeNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Contrôle la façon dont la grille réagit aux caractères de largeur variable.

 
Exemple
 
document.getElementById("subhead").style.layoutGrid Type = "strict";
 
Valeur

Valeurs constantes sous forme de chaîne: fixed | loose | strict.

 
Par défaut

loose

leftNN 6 IE 4 DOM 2

Lecture/écriture

Pour les éléments positionnables, définit la position du bord gauche du cadre d'un élément (contenu plus remplissage, bordure et/ou marge de gauche) par rapport au bord gauche du conteneur père. Dans le cas d'un élément à positionnement relatif, le décalage est calculé par rapport au côté gauche de l'emplacement où l'élément devrait normalement apparaître.

 

Pour effectuer des calculs sur cette valeur, utilisez parseFloat() sur la valeur renvoyée; ou extrayez les propriétés pixelLeft ou posLeft, qui renvoient de véritables valeurs numériques.

 
Exemple
 
document.getElementById("blockD2").style.left = "45px";
 
Valeur

Chaîne composée d'une valeur numérique et d'une unité de mesure de longueur, d'un pourcentage ou d'une valeur auto.

 
Par défaut

auto

letterSpacingNN 6 IE 4 DOM 2

Lecture/écriture

Définit l'espacement entre les caractères à l'intérieur d'un élément. Les navigateurs définissent normalement l'interlettrage en fonction des définitions de police et de la méthode de restitution utilisée par le système d'exploitation. Une valeur négative diminue l'interlettrage; dans ce cas, n'oubliez pas de vérifier le résultat sur différents systèmes d'exploitation.

 
Exemple
 
document.body.style.letterSpacing = "1.1em";
 
Valeur

Chaîne contenant une valeur de longueur (avec unité de mesure) ou normal. Les meilleurs résultats sont obtenus avec des unités basées sur la taille de police affichée (em et ex). L'attribut normal correspond à l'interlettrage appliqué par le navigateur en l'absence d'intervention extérieure.

 
Par défaut

normal

lineBreakNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Contrôle les règles de sauts de ligne pour le texte japonais.

 
Exemple
 
document.body.style.lineBreak = "strict";
 
Valeur

Valeurs constantes sous forme de chaîne: normal | strict.

 
Par défaut

normal

lineHeightNN 6 IE 4 DOM 2

Lecture/écriture

Définit la hauteur de la zone interne (la zone contenant une ligne physique du contenu). Reportez-vous à l´attribut de style line-height dans le chapitre 11 pour plus de détails sur les caprices des navigateurs et les caractéristiques héritées des différents types de valeur.

 
Exemple
 
document.getElementById("tight").style.lineHeight = "1.1em";
 
Valeur

Chaîne contenant une valeur de longueur (avec unité de mesure) ou normal.

 
Par défaut

normal

listStyleNN 6 IE 4 DOM 2

Lecture/écriture

Forme courte de propriété permettant de définir jusqu'à trois propriétés de style de liste dans une seule instruction d'affectation. Les attributs qui ne sont pas explicitement définis adoptent leur valeur par défaut. Ces propriétés définissent les caractéristiques d'affichage des marqueurs de liste des éléments ol et ul. Disponible comme propriété des objets IE style et runtimeStyle uniquement, mais les propriétés de polices individuelles sont disponibles dans currentStyle également.

 
Exemple
 
document.getElementById("itemList").style.listStyle = "square outside none";
 
Valeur

Pour plus de détails sur les valeurs possibles des attributs listStyleType, listStylePosition et listStyleImage, voir la section consacrée à chacun de ces attributs. Vous pouvez spécifier dans la même instruction un, deux ou trois attributs de style de liste, dans n'importe quel ordre.

 
Par défaut

Aucune.

listStyleImageNN 6 IE 4 DOM 2

Lecture/écriture

Spécifie l'adresse URL (Universal Resource Locator) d'une image à utiliser comme marqueur d'élément de liste. Cet attribut pouvant être hérité, sa valeur (y compris none) peut annuler et remplacer la valeur du même attribut ou de la même propriété dans le parent de l'élément de liste auquel il est appliqué.

 
Exemple
 
document.getElementById("itemList").style.listStyleImage = "url(images/3DBullet.gif)";
 
Valeur

La valeur none permet d'annuler une image associée à un élément parent. Sinon, fournissez une adresse URL complète ou relative (au format d´URL CSS) d'un fichier image dont le type MIME est lisible par le navigateur.

 
Par défaut

none

listStylePositionNN 6 IE 4 DOM 2

Lecture/écriture

Indique si le marqueur de liste doit être affiché à l'intérieur ou à l'extérieur (en retrait négatif) du bloc de contenu de l'élément de liste. Lorsque l'attribut listStylePosition a pour valeur inside et que le contenu est un texte, le marqueur fait partie intégrante du bloc de texte. Dans ce cas, l'élément de liste présente un alignement normal et le marqueur n'apparaît pas en retrait négatif.

 
Exemple
 
document.getElementById("itemList").style.listStylePosition = "inside";
 
Valeur

Une des deux constantes suivantes sous forme de chaîne: inside | outside.

 
Par défaut

outside

listStyleTypeNN 6 IE 4 DOM 2

Lecture/écriture

Définit le type de marqueur d'élément de liste à afficher pour chaque élément. Cet attribut s'applique uniquement si la valeur de listStyleImage est none (ou n'est pas spécifiée). Les valeurs constantes disponibles pour cet attribut se divisent en deux catégories. Un ensemble est utilisé avec les éléments ul pour présenter un disque rempli, un cercle vide ou un carré rempli (sauf les carré vides dans IE 4 pour Macintosh). L´autre ensemble est pour les éléments ol, qui ont des éléments de liste pouvant être marqués en séquences de chiffres arabes, de chiffres romains (majuscules et minuscules), de lettres de l´alphabet (majuscules et minuscules) et d´autres séquences de caractères d´autres langues si le navigateur et le système d´exploitation prennent ces langues en charge.

 
Exemple
 
document.getElementById("itemList").style.listStyleType = "circle";
 
Valeur

Constante sous forme de chaîne, adaptée en fonction du type de conteneur de liste. Pour ul: circle | disc | square. Pour ol: decimal | decimal-leading-zero | lower-roman | upper-roman | lower-greek | lower-alpha | lower-latin | upper-alpha | upper-latin | hebrew | armenian | georgian | cjk-ideographic | hiragana | katakana | hiragana-iroha | katakana-iroha. Les séquences de l´élément ol couramment prises en charge sont traitées comme indiqué dans le tableau suivant.

 
TypeExemple
decimal1, 2, 3, ...
decimal-leading-zero01, 02, 03, ...
lower-alphaa, b, c, ...
lower-greek, , , ...
lower-romani, ii, iii, ...
upper-alphaA, B, C, ...
upper-romanI, II, III, ...
 
Par défaut

disc (pour les éléments ul); decimal (pour les élémentsol).

marginNN 6 IE 4 DOM 2

Lecture/écriture

Forme courte de propriété permettant de définir, à l'aide d'une seule instruction, plusieurs marges (jusqu'à quatre) d'un élément. Une marge est un espace vide situé à l'extérieur de la bordure d'un élément et qui sépare ce dernier des éléments avoisinants ou imbriqués, surtout ceux dotés eux-mêmes de bordures. Vous pouvez spécifier entre une et quatre valeurs de marge, séparées par des espaces. Le nombre de valeurs séparées par des espaces détermine à quelles marges ces valeurs doivent être appliquées.

 
Exemple
 
document.getElementById("logoWrapper").style.margin = "5px 8px";
 
Valeur

Cette propriété accepte une, deux, trois ou quatre valeurs séparées par des espaces, en fonction du nombre de marges et de celles que vous voulez définir. Pour plus de détails sur la façon dont le nombre de valeurs affecte cette propriété, consultez la liste d'attributs margin dans le chapitre 11. Les valeurs des marges peuvent être exprimées sous forme d'une longueur, d'un pourcentage de la taille de l'élément père ou de la constante auto.

 
Par défaut

0

marginBottom, marginLeft, marginRight, marginTopNN 6 IE 4 DOM 6

Lecture/écriture

Ces propriétés permettent de définir individuellement les quatre marges d'un élément. Une marge est un espace situé à l'extérieur de la bordure d'un élément et qui n'est pas compté dans la largeur ou la hauteur de ce dernier.

 
Exemple
 
document.getElementById("logoWrapper").style.marginTop = "5px";
document.getElementById("navPanel").style.marginLeft = "10%";
 
Valeur

Les valeurs des largeurs de marges peuvent être exprimées sous forme d'une longueur, d'un pourcentage de la taille de l'élément père ou de la constante auto.

 
Par défaut

0

markerOffsetNN 6 IE s.o. DOM s.o.

Lecture/écriture

Contrôle l´espace entre les marqueurs d´éléments de liste (qui occupent leur propre zone dans le modèle de zone CSS) et la zone qui contient le texte des éléments de liste. Bien que la propriété soit disponible dans Netscape 6, la valeur est une chaîne vide et le contenu affiché ne change pas si vous lui affectez une nouvelle valeur.

 
Valeur

Chaîne contenant une valeur de longueur (avec unité de mesure) ou auto.

 
Par défaut

Aucune.

marksNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Définit le type de marque de détourage pour une règle @page. Bien que la propriété soit disponible dans IE 5 pour Mac et Netscape 6, les valeurs sont des chaînes vides et le contenu affiché ne change pas si vous lui affectez une nouvelle valeur.

 
Valeur

Chaîne insensible à la casse de l'une des constantes suivantes. crop | cross | none.

 
Par défaut

none

maxHeight, maxWidth, minHeight, minWidthNN 6 IE (Voir texte) DOM 2

Lecture/écriture

Définissent les hauteurs et largeurs approximatives pour un élément de façon à ce que, pour les propriétés « max », un élément ne soit pas autorisé à grandir plus dans la dimension désignée, ou pour les valeurs « min », un élément puisse s´étendre dans la dimension désignée pour faire de la place à plus de contenu que prévu ou autres situations d´affichage. Bien que la propriété soit disponible dans IE 5 pour Macintosh et Netscape 6, elle est soit ignorée (IE 5 pour Mac) soit erronée (Netscape 6). IE 6 pour Windows ne prend en charge que la propriété minWidth, qui ne peut être utilisée que pour les éléments tr, th et td.

 
Valeur

Valeur de longueur CSS (reportez-vous au chapitre 11) sous forme de chaîne.

 
Par défaut

Aucune.

MozBindingNN 6 IE s.o. DOM s.o.

Lecture/écriture

Pointe sur l´URL d´un document XML conçu pour améliorer un élément existant ou créer un nouvel élément d´interface. Fondée sur Mozilla XBL (Extensible Bindings Language). Pour plus de détails, visitez http://www.mozilla.org/unix/customizing.html.

 
Valeur

Chaîne de valeur d´URL CSS ou none.

 
Par défaut

Aucune.

MozOpacityNN 6 IE s.o. DOM s.o.

Lecture/écriture

Définit le niveau d´opacité de l'élément. Plus la valeur est petite, plus l´élément est transparent. Il s´agit de la version propriétaire Mozilla du filtre d´opacité propriétaire de Microsoft.

 
Exemple
 
document.getElementById("menuWrapper").style.MozOpacity = "40%";
 
Valeur

Valeur de chaîne numérique entre 0 et 1 ou valeur de pourcentage sous forme de chaîne entre 0% et 100%.

 
Par défaut

100% (complètement opaque)

orphans, widowsNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Pour le contenu d´un élément de niveau bloc qui se répand dans les zones de page, spécifiez le nombre minimum de lignes de l´élément qui doivent apparaître en bas de la page (orphelins) ou en haut de la page suivante (veuves). Bien que ces propriétés soient des éléments de l´objet style dans IE 5 pour Mac et Netscape 6, ni l´attribut style ni les modifications qui lui ont été apportées par script n´affectent la sortie imprimée.

 
Exemple
 
document.getElementById("sec23").style.orphans = "3";
 
Valeur

Nombre entier sous forme de chaîne.

 
Par défaut

Aucune.

outlineNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Fournit la forme courte de propriété utilisée pour obtenir ou définir, en une seule instruction, les propriétés outlineColor, outlineStyle et/ou outlineWidth pour le contour entourant un élément. Vous devez spécifier un style de contour (voir outlineStyle) pour que les modifications apportées à cette propriété affectent l'affichage. Un contour est comme une bordure, mais recouvre l´élément sans occuper d´espace de contenu ou affecter les dimensions de l´élément. Bien que cette propriété soit un élément de l´objet style dans IE 5 pour Mac et Netscape 6, seul IE 5 pour Mac affiche le contour.

 
Exemple
 
document.getElementById("announce").style.outline = "solid blue 4px";
 
Valeur

Chaîne délimitée par des espaces. Pour les valeurs des composants outlineStyle et outlineWidth, consultez la section consacrée aux propriétés respectives dans ce chapitre. Pour plus de détails sur la valeur outlineColor, consultez la section consacrée aux couleurs CSS au début du chapitre 11.

 
Par défaut

Aucune.

outlineColorNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Contrôle la couleur d´un contour.

 
Exemple
 
document.getElementById("announce").style.outlineColor = "rgb(100, 75, 0)";
 
Valeur

Valeur de couleur CSS ou constante invert. Pour plus de détails sur les valeurs de couleur CSS, consultez la section consacrée aux couleurs, au début du chapitre 11.

 
Par défaut

invert

outlineStyleNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Contrôle le type de ligne d´un contour.

 
Exemple
 
document.getElementById("announce").style.outlineStyle = "solid";
 
Valeur

Les valeurs de style sont des constantes insensibles à la casse, associées à des méthodes spécifiques d'affichage des lignes de contour (et de bordures). Les constantes de style CSS sont: dashed, dotted, double, groove, hidden, inset, none, outset, ridge et solid.

 
Par défaut

none

outlineWidthNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Contrôle l´épaisseur des lignes de contour.

 
Exemple
 
document.getElementById("announce").style.outlineWidth = "2px";
 
Valeur

Trois constantes insensibles à la casse (thin | medium | thick) permettent au navigateur de définir précisément le nombre de pixels utilisés pour afficher la bordure. Pour une plus grande précision, vous pouvez spécifier une valeur de longueur (pour en savoir plus sur les valeurs de longueur CSS, reportez-vous au début du chapitre 11).

 
Par défaut

medium

overflowNN 6 IE 4 DOM 2

Lecture/écriture

Indique comment un élément positionné doit afficher un contenu s'étendant au-delà des limites établies dans la règle de feuille de style. Reportez-vous à la section consacrée à l´attribut de feuille de style overflow dans le chapitre 11 pour de plus amples détails.

 
Exemple
 
document.getElementById("myDiv").style.overflow = "scroll";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: auto | hidden | scroll | visible.

 
Par défaut

visible

overflowX, overflowYNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Indique comment un élément positionné doit afficher un contenu s'étendant au-delà des limites horizontales (overflowX) ou verticales (overflowY) établies dans la règle de feuille de style.

 
Exemple
 
document.getElementById("myDiv").style.overflow X= "scroll";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: auto | hidden | scroll | visible.

 
Par défaut

visible

paddingNN 6 IE 4 DOM 2

Lecture/écriture

Forme courte de propriété permettant de définir, à l'aide d'une seule instruction, les largeurs de remplissage de jusqu'à quatre bords d'un élément. Le remplissage est l'espace vide qui entoure la zone de contenu d'un élément; cet espace s'étend jusqu'aux bordures de l'élément, s'il en existe, mais n'inclut pas ces dernières. Le remplissage reprend la couleur ou l'image d'arrière-plan de l'élément. Lorsque vous insérez du remplissage dans un élément, vous augmentez la taille de son rectangle visible sans modifier pour autant la taille du bloc de contenu. Vous pouvez spécifier entre une et quatre valeurs de remplissage, séparées par des espaces. Le nombre de valeurs spécifiées détermine à quels côtés doivent s'appliquer ces valeurs.

 
Exemple
 
document.getElementById("logoWrapper").style.padding = "3px 5px";
 
Valeur

Cette propriété accepte une, deux, trois ou quatre valeurs séparées par des espaces, en fonction du nombre de côtés et de ceux que vous voulez remplir. Pour plus de détails sur la façon dont le nombre de valeurs affecte cette propriété, consultez la liste d'attributs padding dans le chapitre 11. Les valeurs des largeurs de remplissage peuvent être exprimées sous forme d'une longueur, d'un pourcentage de la taille de l'élément père ou de la constante auto.

 
Par défaut

0

paddingBottom, paddingLeft, paddingRight, paddingTopNN 6 IE 4 DOM 2

Lecture/écriture

Ces propriétés permettent de définir individuellement les quatre côtés de remplissage d'un élément. Le remplissage est un espace qui s'étend entre la bordure de l'élément et la zone de contenu. Le remplissage n'est pas calculé comme faisant partie de la largeur ou de la hauteur de l'élément.

 
Exemple
 
document.getElementById("logoWrapper").style.paddingTop = "3px";
document.getElementById("navPanel").style.paddingLeft = "10%";
 
Valeur

Les valeurs des largeurs de remplissage peuvent être exprimées sous forme d'une longueur, d'un pourcentage de la taille de l'élément père ou de la constante auto.

 
Par défaut

0

pageNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Pointe sur le nom d´une règle @page existante (lorsque la règle contient un identificateur, comme @page figures {size: landscape}) afin d´appliquer cette règle à l´élément de niveau bloc courant. Bien que cette propriété soit un élément de l´objet style dans IE 5 pour Mac et Netscape 6, ni l´attribut style ni les modifications qui lui ont été apportées par script n´affectent la sortie imprimée.

 
Valeur

Identificateur sous forme de chaîne.

 
Par défaut

Aucune.

pageBreakAfter, pageBreakBeforeNN 6 IE 4 DOM 2

Lecture/écriture

Définissent l'endroit où doivent être placés les sauts de page lors de l'impression du document. Les sauts de page ne sont pas visibles dans un navigateur visuel comme ils le sont dans les applications de traitement de texte; à l'écran, les contenus longs défilent sans interruption à l´écran. Reportez-vous aussi à la section consacrée à la présentation détaillée des sauts de pages dans la liste relative aux attributs de style page-break-after et page-break-before dans le chapitre 11.

 
Exemple
 
document.getElementById("hardBR").style.pageBreakAfter = "always";
document.getElementById("navPanel").style.paddingLeft = "10%";
 
Valeur

Tous les navigateurs les prenant en charge reconnaissent quatre valeurs constantes (sous forme de chaînes): always | auto | left | right. De plus, IE pour Windows prend en charge une chaîne vide, ce qui a le même effet que la constante avoid du DOM W3C.

 
Par défaut

auto

pageBreakInsideNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Définit si l´élément accepte d´être divisé sur plusieurs pages imprimées. Bien que cette propriété soit un élément de l´objet style dans IE 5 pour Mac et Netscape 6, ni l´attribut style ni les modifications qui lui ont été apportées par script n´affectent la sortie imprimée.

 
Valeur

Une valeur constante (sous forme de chaîne): auto | avoid.

 
Par défaut

auto

pause, pauseAfter, pauseBefore, pitch, pitchRange

Voir azimuth.

pixelBottom, pixelLeft, pixelRight, pixelTopNN s.o. IE 4 DOM s.o.

Lecture/écriture

Pour les éléments positionnables, ces propriétés définissent la position (en pixels) des bords du cadre d'un élément (contenu plus remplissage, bordure et/ou marge) par rapport aux bords correspondants du conteneur père. Dans le cas d'un élément à positionnement relatif, la mesure est définie par rapport aux côtés de l'emplacement interne où l'élément devrait normalement apparaître. Utilisez ces propriétés pour les calculs (notamment pour les animations suivant un trajet) au lieu des propriétés bottom, left, right et top, qui stockent leurs valeurs sous forme de chaînes contenant les noms d'unité. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("myDIV").style.pixelLeft++;
 
Valeur

Nombre entier.

 
Par défaut

Aucune.

pixelHeight, pixelWidthNN s.o. IE 4 DOM s.o.

Lecture/écriture

Fournit la hauteur et la largeur de l'élément en pixels. Utilisez ces propriétés pour les calculs, à la place de propriétés telles que height et width, qui renvoient des chaînes contenant des unités. Les modifications apportées à ces propriétés ne sont pas nécessairement visibles tant que l'attribut de style position de l'élément n'est pas défini. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
var midWidth = document.getElementById("myDIV").style.pixelWidth/2;
 
Valeur

Nombre entier

 
Par défaut

Aucune.

playDuring

Voir azimuth.

posBottom, posLeft, posRight, posTopNN s.o. IE 4 DOM s.o.

Lecture/écriture

Pour les éléments positionnables, ces propriétés définissent la position des bords du cadre d'un élément (contenu plus remplissage, bordure et/ou marge) par rapport aux bords correspondants du conteneur père. Dans le cas d'un élément à positionnement relatif, la mesure est définie par rapport aux côtés de l'emplacement interne où l'élément devrait normalement apparaître. Plus important encore, ces valeurs de propriété sont des valeurs numériques définies dans la même unité de mesure que celle de l'attribut CSS bottom, left, right ou top. Utilisez ces propriétés pour les calculs (notamment pour les animations suivant un trajet) au lieu des propriétés bottom, left, right et top, qui stockent leurs valeurs sous forme de chaînes contenant les noms d'unité. Tous les éléments mathématiques se trouvent dans les unités spécifiées. Faites également la distinction entre ces propriétés et les propriétés pixelBottom, pixelLeft, pixelRight et pixelTop, qui sont des nombres entiers uniquement destinés aux mesures en pixel. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("myDIV").style.posLeft =
  document.getElementById("myDIV").style.posLeft + 1.5;
 
Valeur

Nombre à virgule flottante.

 
Par défaut

Aucune.

posHeight, posWidthNN s.o. IE 4 DOM s.o.

Lecture/écriture

Spécifie la hauteur et la largeur numériques de l'élément, exprimées dans les unités définies par les attributs relatifs au positionnement par feuille de style (CSS). Utilisez ces propriétés pour les calculs, à la place de propriétés telles que height et width, qui renvoient des chaînes contenant des unités. Tous les éléments mathématiques se trouvent dans les unités spécifiées. Faites également la distinction entre ces propriétés et les propriétés pixelHeight et pixelWidth, qui sont des nombres entiers exprimant uniquement des mesures en pixels uniquement. Disponible comme propriété des objets IE style et runtimeStyle uniquement.

 
Exemple
 
document.getElementById("myDIV").style.posWidth = 10.5;
 
Valeur

Nombre à virgule flottante.

 
Par défaut

Aucune.

positionNN 6 IE 4 DOM 2

Lecture seule

Pour les éléments positionnables, renvoie la valeur affectée à l'attribut de feuille de style position. Cette propriété est en lecture/écriture, mais vous ne pouvez pas transformer un élément positionné en élément statique ou vice versa.

 
Exemple
 
var posType = document.getElementById("myDIV").style.position;
 
Valeur

Constante sous forme de chaîne: absolute | fixed | relative | static. La valeur fixed n´est pas prise en charge dans IE pour Windows jusqu´à la version 6.

 
Par défaut

Aucune.

quotesNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Affecte des paires de caractères à utiliser comme guillemets (surtout pour l´élément q). Bien que la propriété soit disponible dans IE 5 pour Macintosh et Netscape 6, seul Netscape 6 répond aux attributs CSS et aucun des deux ne répond à la lecture ou à l´écriture de la valeur de propriété quotes.

 
Valeur

Une chaîne composée de deux ou quatre chaînes entre guillemets (guillemets imbriqués). La première paire fournit des caractères pour les guillemets de premier niveau; la deuxième paire fournit des caractères pour les guillemets imbriqués.

 
Par défaut

Aucune.

richness

Voir azimuth.

rubyAlignNN s.o. IE 5 DOM s.o.

Lecture/écriture

Contrôle l´alignement du contenu dans un élément ruby. Les modifications de cette propriété affectent IE pour Windows uniquement. Les styles Ruby sont définis dans CSS3.

 
Exemple
 
document.getElementById("myRuby").style.rubyAlign = "center";
 
Valeur

Chaîne insensible à la casse de l'une des constantes suivantes. auto | center | distribute-letter | distribute-space | left | line-edge | right.

 
Par défaut

auto

rubyOverhangNN s.o. IE 5 DOM s.o.

Lecture/écriture

Contrôle les caractéristiques de saillie du contenu dans un élément ruby. Les modifications de cette propriété affectent IE pour Windows uniquement. Les style Ruby sont définis dans CSS3.

 
Exemple
 
document.getElementById("myRuby").style.rubyOverhang="whitespace";
 
Valeur

Chaîne insensible à la casse de l'une des constantes suivantes. auto | none | whitespace.

 
Par défaut

auto

rubyPositionNN s.o. IE 5 DOM s.o.

Lecture/écriture

Contrôle si le texte ruby (élément rt) s´affiche sur la même ligne ou au-dessus du texte ruby de base associé (élément rb). Les modifications de cette propriété affectent IE pour Windows uniquement. Les style Ruby sont définis dans CSS3.

 
Exemple
 
document.getElementById("myRuby").style.rubyPosition = "inline";
 
Valeur

Chaîne insensible à la casse de l'une des constantes suivantes. above | inline.

 
Par défaut

above

scrollbar3dLightColor, scrollbarArrowColor, scrollbarBaseColor, scrollbarDarkShadowColor, scrollbarFaceColor, scrollbarHighlightColor, scrollbarShadowColor, scrollbarTrackColorNN s.o. IE 5,5 (Win) DOM s.o.

Lecture/écriture

Contrôle les couleurs pour les composants spécifiques d´un élément d´interface utilisateur de barre de défilement associé à un élément applet, body, div, embed, object ou textarea element. Reportez-vous à la description des attributs CSS du chapitre 11 pour savoir quel composant est contrôlé par chaque propriété.

 
Exemple
 
document.getElementById("comments").style.scrollbarArrowColor = "rgb(100, 75, 0");
 
Valeur

Spécification de couleur CSS non sensible à la casse (reportez-vous à la section qui y est consacrée au début du chapitre 11).

 
Par défaut

Aucune.

runtimeStyleNN s.o. IE 5 DOM s.o.

Lecture/écriture

Renvoie un objet style dont les propriétés de style individuelles ne transmettent des valeurs que si elles sont explicitement définies par les processus de feuilles de style habituels. Contrairement à l´objet currentStyle , les propriétés de feuilles de style par défaut du système ne sont pas reflétées. Vous pouvez définir des propriétés de style individuelles pour cet objet runtimeStyle , mais cela transcende (certains diraient « enfreint ») la hiérarchie de la structure en cascade. Toute propriété que vous affectez par script remplace tous les autres paramètres pour cette propriété de style régissant cet élément, y compris les valeurs affectés à l´attribut style et à la propriété style de la balise de l´élément. Par exemple, si vous affectez la valeur red à la propriété style.color d´un élément et la valeur green à la propriété runtimeStyle.color du même élément, le texte de l´élément s´affiche en vert, bien que la propriété style.color , plus spécifique au style, garde la valeur red . A ce stade, la propriété currentStyle.color de l´élément renvoie aussi green , car il s´agit du style effectif régissant l´élément à ce moment donné.

 

Vous pouvez utiliser l´objet runtimeStyle pour affecter plusieurs propriétés de style en réaffectant une règle de syntaxe CSS à la propriété runtimeStyle.cssText . Affectez une chaîne vide à la propriété cssText pour supprimer toutes les valeurs d´attributs internes, permettant à la cascade de feuilles de style habituelle de contrôler le style effectif de l´élément.

 
Exemple
 
document.getElementById("elementID").runtimeStyle.cssText =
  "border: 5px blue solid";
 
Valeur

Référence de l'objet style .

 
Par défaut

L´objet style effectif et ses valeurs d´attributs de style définies explicitement.

setExpression()NN s.o. IE 5 (Win) DOM s.o.

setExpression("propertyName", "expression", ["scriptLanguage"])

Affecte une expression de script à la propriété d´un objet élément comme façon de calculer dynamiquement une valeur pour la propriété. Cette méthode fonctionne avec les propriétés des objets éléments et de leurs objets style si vous le désirez. L´expression est réévaluée automatiquement pour la plupart des événements axés sur l´utilisateur ou vous pouvez explicitement forcer la réévaluation par le biais de la méthode recalc() à tout moment.

 

L´affectation d´une expression à l´attribut d´un élément peut prendre la place d´un traitement d´événements, tel que la maintenance des relations de position entre les éléments lorsqu´un utilisateur redimensionne la fenêtre du navigateur. Par exemple, pour conserver un élément centré horizontalement dans la fenêtre du navigateur, vous pouvez utiliser l´une des techniques suivantes pour appliquer une expression à la propriété style.left . Le premier exemple illustre la syntaxe (aussi pour IE 5 pour Windows et versions ultérieures) pour l´affectation d´une expression comme attribut interne pour l´élément:

 

Ou, une fonction invoquée au chargement pourrait inclure l´instruction suivante:

 

Dans les deux cas, la même expression calcule la position de coordonnée pour le bord gauche de l´élément par rapport à la largeur visible actuelle de l´élément body . Comme cette expression dépend de la propriété de dimension de l´élément body , le navigateur sait qu´il doit réévaluer toute expression pouvant être affectée par la modification de la taille du corps due au redimensionnement de la fenêtre.

 

Assurez-vous que la valeur résultant de l´expression que vous affectez est du type de données désiré pour l´attribut que vous définissez. Isolez l´expression et effectuez des tests initiaux dessus avant de l´affecter à la méthode setExpression() . Sinon, le débogage sera plus difficile.

 

Si vous voulez qu´une expression affecte une valeur à un attribut et force cette valeur à rester, utilisez la méthode removeExpression() pour empêcher toute autre réévaluation de la valeur de l´attribut.

 
Paramètres
 
  • Le nom de l´attribut contrôlé par l´expression, mais sous la forme du nom de propriété sensible à la casse (par exemple, utilisez le nom de propriété className au lieu du nom d´attribut class correspondant).
  • Une chaîne contenant l´expression de script à évaluer. L´expression doit être évaluée comme une valeur appropriée pour la propriété nommée dans le premier paramètre et les instructions multiples séparées par deux-points ne sont donc pas autorisées. Les références à d´autres éléments doivent être des références complètes. Les anciennes implémentations risquent d´avoir des problèmes avec les références qui comprennent des tableaux.
  • Une des trois constantes sous forme de chaîne: JScript | JavaScript | VBScript . La valeur par défaut est JScript .
 
Valeur renvoyée

Aucune.

sizeNN 6 IE s.o DOM 2

Lecture/écriture

Pour un contexte de page défini par une règle @page, cette propriété contrôle la taille et l´orientation de la page. Bien que la propriété soit disponible dans Netscape 6, la valeur est une chaîne vide et la propriété n´a pas d´influence sur le contexte de la page.

 
Valeur

Valeurs de longueur CSS (sous forme de chaîne) ou chaîne insensible à la casse de l'une des constantes suivantes: auto | landscape | portrait. Pour les valeurs de longueur, une seule valeur est appliquée à la hauteur et la largeur; deux valeurs de longueur délimitées par des espaces sont appliquées respectivement à la largeur et à la hauteur.

 
Par défaut

auto

speak, speakHeader, speakNumeral, speakPunctuation, speechRate, stress

Voir azimuth.

styleFloatNN s.o. IE 4 DOM s.o.

Lecture/écriture

Précise de quel côté du conteneur l'élément doit s'aligner, déterminant ainsi le positionnement des autres contenus par rapport à l'élément. Si sa valeur est none, l'élément apparaît dans le même ordre que dans le code source et une ligne de contenu textuel environnant, au plus, apparaît dans la même bande horizontale. Reportez-vous à la section consacrée à l'attribut de style float dans le chapitre 11 pour de plus amples détails. IE 5 pour Macintosh duplique cette propriété comme cssFloat, la version DOM 2, qui est aussi prise en charge (par elle-même) dans Netscape 6.

 
Exemple
 
document.getElementById("myDIV").style.styleFloat = "right";
 
Valeur

L'une des constantes suivantes (sous forme de chaîne): none | left | right.

 
Par défaut

Aucune.

tableLayoutNN 6 IE 5 DOM 2

Lecture/écriture

Joue le rôle d´un interrupteur au chargement afin d´indiquer au navigateur de commencer à afficher le tableau selon les largeurs de colonne définies par la première ligne ou d´attendre que les données du tableau soient chargées pour que le navigateur puisse calculer les largeurs de colonne optimales d´après le contenu des cellules. Les modifications de cette propriété n´ont aucun effet sur un tableau affiché.

 
Exemple
 
document.getElementById("myTable").style.tableLayout = "fixed";
 
Valeur

L'une des constantes suivantes (sous forme de chaîne): auto | fixed.

 
Par défaut

auto

textAlignNN 6 IE 4 DOM 2

Lecture/écriture

Détermine l'alignement horizontal du texte à l'intérieur de la zone d´un élément.

 
Exemple
 
document.getElementById("myDIV").style.textAlign = "right";
 
Valeur

L'une des quatre constantes (sous forme de chaîne): center | justify | left | right.

 
Par défaut

Dépend de la langue par défaut du navigateur.

textAlignLastNN s.o. IE 5,5 (Win) DOM s.o.

Lecture/écriture

Détermine l'alignement horizontal de la dernière ligne de texte à l'intérieur de la zone d´un élément. Cet attribut de style peut être utile pour obtenir l´apparence désirée si vous utilisez d´autres attributs de style d´alignement de texte propriétaires dans IE 5.5 ou les versions ultérieures pour Windows.

 
Exemple
 
document.getElementById("myDIV").style.textAlignLast = "justify";
 
Valeur

L'une des constantes suivantes (sous forme de chaîne): auto | center | justify | left | right.

 
Par défaut

auto

textAutospaceNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Contrôle l´espacement entre les caractères idéographiques (en général, les langues asiatiques) et les caractères non idéographiques.

 
Exemple
 
document.getElementById("myDIV").style.textAutospace = "ideograph-numeric";
 
Valeur

L'une des constantes suivantes (sous forme de chaîne): ideograph-alpha | ideograph-numeric | ideograph-parenthesis | ideograph-space | none.

 
Par défaut

none

textDecorationNN 6 IE 4 DOM 2

Lecture/écriture

Définit les enrichissements à appliquer au contenu d'un élément (souligné, barré, barre supérieure et (dans Navigator et CSS) clignotement). Les navigateurs utilisent cet attribut de style au niveau interne pour affecter des traits de soulignement par défaut aux éléments a et des « barrés » aux éléments strike, la valeur par défaut varie donc selon le type d´élément. Vous pouvez spécifier plusieurs styles d'enrichissement, en les séparant par des espaces. Les navigateurs acceptent la valeur blink (CSS facultative), mais, heureusement, cela ne fait pas clignoter l´écran. Les enrichissements de texte ont une relation parent/enfant inhabituelle. Les valeurs ne sont pas héritées, mais un enrichissement appliqué à un élément est également appliqué à ses éléments imbriqués dans la plupart des cas. Par conséquent, à moins d'annuler cette fonction par un autre moyen, si un élément p est souligné, l'élément b imbriqué dans ce dernier l'est également. Internet Explorer comprend également des propriétés booléennes pour chaque type de décoration.

 
Exemple
 
document.getElementById("emphasis").style.textDecoration = "underline";
 
Valeur

None ou l´une des quatre constantes suivantes (sous forme de chaîne): blink | line-through | overline | underline. Plusieurs valeurs peuvent être incluses dans la chaîne, séparées par des espaces dans une liste.

 
Par défaut

Dépend des feuilles de style interne et de l´élément.

textDecorationBlink, textDecorationLineThrough, textDecorationNone, textDecorationOverline, textDecorationUnderlineNN s.o. IE 4 DOM s.o.

Lecture/écriture

Indique si la fonction d'enrichissement de texte spécifiée est activée pour l´élément. Chacune de ces propriétés correspond à une valeur qui peut être affectée à l´attribut de style text-decoration dans CSS (reportez-vous au chapitre 11). Internet Explorer ne fait pas clignoter le texte, en sorte que la propriété textDecorationBlink est ignorée. Si la valeur du paramètre textDecorationNone est paramétrée sur true, toutes les propriétés apparentées ont la valeur false. Le paramétrage de ces propriétés dans Internet Explorer pour Macintosh ne modifie pas le contenu. Utilisez plutôt la propriété textDecoration.

 
Exemple
 
document.getElementById("emphasis").style.textDecorationLineThrough = "true";
 
Valeur

Valeur booléenne: true | false.

 
Par défaut

false

textIndentNN 6 IE 4 DOM 2

Lecture/écriture

Définit le retrait à appliquer à la première ligne d'un bloc de texte (tel qu'un élément p). Cet attribut est uniquement appliqué à la première ligne de texte. Vous pouvez utiliser une valeur négative pour appliquer un retrait négatif à la première ligne, mais dans ce cas assurez-vous que le texte ne dépasse pas la limite gauche de la fenêtre ou du cadre du navigateur.

 
Exemple
 
document.getElementById("firstGraph").style.textIndent = "0.5em";
 
Valeur

Valeur de longueur CSS positive ou négative (reportez-vous au chapitre 11) sous forme de chaîne.

 
Par défaut

0px

textJustifyNN s.o. IE 5 DOM s.o.

Lecture/écriture

Spécifie des techniques de distribution de caractères détaillées pour tout élément de niveau bloc dont l´attribut CSS text-align ou la propriété de style textAlign sont définis sur justify.

 
Exemple
 
document.getElementById("inset").style.textJustify = "distribute-center-last";
 
Valeur

L'une des constantes suivantes (sous forme de chaîne): auto | distribute | distribute-all-lines | distribute-center-last | inter-cluster | inter-ideograph | inter-word | kashdia | newspaper. Reportez-vous à l´attribut text-justify dans le chapitre 11 pour de plus amples détails sur ces valeurs.

 
Par défaut

auto

textKashidaSpaceNN s.o. IE 5,5 (Win) DOM s.o.

Lecture/écriture

Pour le texte arabe dans un élément de niveau bloc avec un style d´alignement de texte défini sur justify, contrôle le rapport entre l´expansion kashida et l´expansion d´espace blanc.

 
Exemple
 
document.getElementById("inset").style.textKashidaSpace = "15%";
 
Valeur

Valeur de pourcentage sous forme de chaîne.

 
Par défaut

0%

textOverflowNN s.o. IE 6 (Win) DOM s.o.

Lecture/écriture

Contrôle si le contenu du texte qui dépasse d´une zone fixe doit afficher une ellipse (…) à la fin de la ligne pour indiquer qu´il y a plus de texte disponible. L´attribut de style ou la propriété overflow de l´élément doit être défini sur hidden.

 
Exemple
 
document.getElementById("textBox").style.textOverflow = "ellipsis";
 
Valeur

L'une des valeurs de chaînes constantes autorisées: clip | ellipsis.

 
Par défaut

clip

textShadowNN 6 IE 5(Mac) DOM 2

Lecture/écriture

Contrôle les spécifications pour les effets d´ombre du texte d'un élément. Bien que cette propriété soit un élément de l´objet style dans IE 5 pour Mac et Netscape 6, ni l´attribut ni les modifications qui lui ont été apportées par script n´affectent l´affichage du texte.

 
Valeur

Une chaîne composée d´une ou plusieurs spécifications d´ombres. Chaque spécification d´ombre est composée de valeurs délimitées par des espaces pour une couleur, une longueur pour le décalage sur la droite du texte, une longueur pour le décalage sous le texte et une valeur de rayon de fondu facultative. Plusieurs spécifications d´ombres sont délimitées par des virgules ou une valeur de none pour désactiver l´ombre.

 
Par défaut

none

textTransformNN 6 IE 4 DOM 2

Lecture/écriture

Contrôle la capitalisation du texte d'un élément. Lorsque cet attribut a une valeur autre que none, la casse de toutes les lettres du texte source est déterminée par la feuille de style, annulant ainsi la casse d'origine du texte source.

 
Exemple
 
document.getElementById("heading").style.textTransform = "capitalize";
 
Valeur

La valeur none assure l'affichage de la casse du texte source tel quel. Les autres valeurs constantes disponibles (sous forme de chaînes) sont les suivantes: capitalize | lowercase | uppercase. La valeur capitalize met le premier caractère de chaque mot en majuscules. Les valeurs lowercase et uppercase affichent tous les caractères dans leur casse respective.

 
Par défaut

none

textUnderlinePositionNN s.o. IE 5,5 (Win) DOM s.o.

Lecture/écriture

Contrôle si un trait de soulignement (c´est-à-dire un élément dont le style text-decoration est défini sur underline) est affiché au-dessus ou au-dessous du texte.

 
Exemple
 
document.getElementById("heading").style.textUnderlinePosition = "above";
 
Valeur

IE 5.5 reconnaît deux valeurs constantes: above | below. IE 6 ajoute les valeurs auto et auto-pos (qui semblent faire la même chose). La valeur par défaut a également changé pendant les versions: elle est passée de below à auto. Dans IE 6, la valeur auto souligne le texte japonais vertical « au-dessus » (à droite) des caractères.

 
Par défaut

none (IE 5.5); auto (IE 6).

topNN 6 IE 4 DOM 2

Lecture/écriture

Pour les éléments positionnables, définit la position du bord supérieur du cadre d'un élément (contenu plus remplissage, bordure et/ou marge de gauche) par rapport au bord supérieur du conteneur père. Dans le cas d'un élément à positionnement relatif, le décalage est défini par rapport au côté supérieur de l'emplacement où l'élément devrait normalement apparaître.

 

Pour effectuer des calculs sur cette valeur, utilisez parseFloat() sur la valeur renvoyée; ou extrayez les propriétés pixelTop ou posTop, qui renvoient de véritables valeurs numériques.

 
Exemple
 
document.getElementById("blockD2").style.top = "40px";
 
Valeur

Chaîne composée d'une valeur numérique et d'une unité de mesure de longueur, d'un pourcentage ou d'une valeur auto.

 
Par défaut

auto

unicodeBidiNN 6 IE 5 DOM 2

Lecture/écriture

Contrôle l´incorporation du texte bidirectionnel (un mélange de français et d´arabe par exemple) de concert avec l´attribut de style direction.

 
Exemple
 
document.getElementById("blockD2").style.unicodeBidi = "bidi-override";
 
Valeur

Valeurs constantes sous forme de chaîne: bidi-override | embed | normal.

 
Par défaut

normal

verticalAlignNN 6 IE 4 DOM 2

Lecture/écriture

Spécifie l´alignement vertical de l'élément. Cette propriété fonctionne dans deux domaines, selon la sélection des valeurs utilisées. Reportez-vous à la section présentant la propriété de feuille de style vertical-align dans le chapitre 11 pour de plus amples détails.

 
Exemple
 
document.getElementById("myDIV").style.verticalAlign = "text-top";
 
Valeur

Valeur sous forme de chaîne d'une mesure absolue (avec unités), d'un pourcentage (par rapport à l'élément de cadre extérieur suivant) ou d'une des nombreuses constantes suivantes: bottom | top | baseline | middle | sub | super | text-bottom | text-top.

 
Par défaut

baseline

visibilityNN 6 IE 4 DOM 2

Lecture/écriture

Indique l´état de visibilité de l'élément positionné. Le contenu environnant ne bouche par l'espace laissé par un élément dont la propriété visibility est paramétrée sur la valeur hidden.

 
Exemple
 
document.getElementById("myDIV").style.visibility = "hidden";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: collapse | hidden | inherit | visible.

 
Par défaut

visible

voiceFamily, volume

Voir azimuth.

whiteSpaceNN 6 IE 5(Mac)/5,5(Win) DOM 2

Lecture/écriture

Contrôle l´interprétation de l´espace blanc (tel que les espaces d´ouverture ou les sauts de ligne) du code source.

 
Exemple
 
document.getElementById("myDIV").style.whiteSpace = "pre";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: normal | nowrap | pre. La valeur normal permet aux navigateurs de renvoyer à la ligne dans les éléments de bloc et d´ignorer les espaces d´ouverture. La valeur normal permet aux navigateurs de ne pas renvoyer à la ligne dans les éléments de bloc, mais d´ignorer les espaces d´ouverture. La valeur pre conserve les espaces d´ouverture, les espaces supplémentaires et les retours de chariot dans le code source. Remarque: IE 6 pour Windows ne répond pas à la valeur pre sauf si les valeurs de l´élément DOCTYPE mettent le navigateur en mode de compatibilité avec les normes.

 
Par défaut

normal

widows

Voir orphans.

width

Voir height.

wordBreakNN s.o. IE 5 (Win) DOM s.o.

Lecture/écriture

Spécifie le style de coupure de mots pour les langues idéographiques ou le contenu mélangeant les langues utilisant l´alphabet latin et les langues idéographiques.

 
Exemple
 
document.getElementById("myDIV").style.wordBreak = "keep-all";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: break-all | keep-all | normal.

 
Par défaut

normal

wordSpacingNN 6 IE 4 DOM 2

Lecture/écriture

Détermine la longueur de l´espace entre les mots. Dans IE 5 pour Macintosh, il peut y avoir des problèmes de chevauchement avec l´espacement des mots des éléments imbriqués dans l´élément contrôlé.

 
Exemple
 
document.getElementById("myDIV").style.wordSpacing = "1.0em";
 
Valeur

Valeur de longueur CSS (sous forme de chaîne) ou la constante normal:

 
Par défaut

normal

wordWrapNN s.o. IE 5,5 (Win) DOM s.o.

Lecture/écriture

Spécifie le style de renvoi à la ligne pour les éléments de niveau bloc, spécialement dimensionnés ou positionnés. Si un seul mot (c´est-à-dire sans espace blanc) dépasse la largeur de la zone contenant l´élément, le comportement normal est d´élargir le contenu au-delà de la largeur de la zone normale, sans renvoi à la ligne. Mais vous pouvez forcer un renvoi à la ligne pour ce long mot, au niveau du caractère qui se trouve au bord de la zone.

 
Exemple
 
document.getElementById("myDIV").style.wordWrap = "break-word";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: break-word | normal.

 
Par défaut

normal

writingModeNN s.o. IE 5,5 (Win) DOM s.o.

Lecture/écriture

Conçue principalement pour les langues qui affichent des caractères dans des phrases verticales, cette propriété contrôle la progression du contenu, de gauche à droite ou de droite à gauche.

 
Exemple
 
document.getElementById("myDIV").style.writingMode = "lr-tb";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: lr-tb | tb-rl. Une valeur de tb-rl peut faire pivoter le texte de certaines langues de 90 degrés.

 
Par défaut

lr-tb

zIndexNN 6 IE 4 DOM 2

Lecture/écriture

Pour un élément positionné, définit l'ordre de superposition par rapport à d'autres éléments à l'intérieur du même conteneur père. Reportez-vous au chapitre 4 pour en savoir plus sur les relations de superposition d'éléments à l'intérieur de multiples conteneurs.

 
Exemple
 
document.getElementById("myDIV").style.zIndex = "3"
 
Valeur

Nombre entier. Netscape 6 préfère que cette valeur soit sous forme de chaîne (la façon dont la propriété renvoie sa valeur), mais IE renvoie un nombre.

 
Par défaut

0

zoomNN s.o. IE 5,5 (Win) DOM s.o.

Lecture/écriture

Détermine l´agrandissement du contenu affiché. Particulièrement utile pour les sorties qui risquent d´être affichées sur des moniteurs avec une densité en pixels très élevée. Reportez-vous à la propriété screen.logicalXDPI.

 
Exemple
 
document.body.style.zoom = "200%";
 
Valeur

Valeur de pourcentage (où 100% est normal), multiplicateur à virgule flottante (où 1.0 est normal) ou constante normal.

 
Par défaut

normal

getPropertyCSSValue()NN s.o. IE s.o. DOM 2

getPropertyCSSValue("CSSAttributeName")

Renvoie un objet qui représente une valeur CSS. Dans le DOM W3C, l´objet CSSValue renvoyé par cette méthode a des propriétés qui révèlent le texte de la paire attribut/valeur et une valeur numérique correspondant à une longue liste de types de valeurs de bas (indiquant les types tels que le pourcentage, les longueurs en pixels et la couleur RGB). Bien que cette méthode soit implémentée dans Netscape 6, à l´heure actuelle, elle renvoie un objet vide.

 
Paramètres
 
  • Le nom d´attribut CSS d´une déclaration de style interne (pas la version DOM du nom de la propriété).
 
Valeur renvoyée

Référence à un objet CSSValue.

getPropertyPriority()NN 6 IE 5(Mac) DOM 2

getPropertyPriority("CSSAttributeName")

Renvoie la valeur, sous forme de chaîne, de n´importe quelle priorité (telle que !important) associée à l´attribut CSS interne.

 
Paramètres
 
  • Le nom d´attribut CSS d´une déclaration de style interne (pas la version DOM du nom de la propriété).
 
Valeur renvoyée

Chaîne.

getPropertyValue()NN 6 IE 5(Mac) DOM 2

getPropertyValue("CSSAttributeName")

Renvoie la valeur, sous forme de chaîne, de la paire attribut CSS/valeur.

 
Paramètres
 
  • Le nom d´attribut CSS d´une déclaration de style interne (pas la version DOM du nom de la propriété).
 
Valeur renvoyée

Chaîne.

item()NN 6 IE 5(Mac) DOM 2

item(index)

Renvoie le nom de l´attribut de la paire attribut CSS/valeur correspondant à la valeur d´index de nombre entier dans l´ordre du code source.

 
Paramètres
 
  • Un nombre entier à base zéro correspondant à la paire attribut CSS/valeur spécifiée dans l'ordre du code source.
 
Valeur renvoyée

Chaîne. IE pour Mac renvoie le nom en majuscules et Netscape 6 le renvoie en minuscules.

removeProperty()NN 6 IE s.o DOM 2

removeProperty("CSSAttributeName")

Supprime la paire attribut CSS/valeur et renvoie une chaîne avec la valeur précédente.

 
Paramètres
 
  • Le nom d´attribut CSS d´une déclaration de style interne (pas la version DOM du nom de la propriété).
 
Valeur renvoyée

Chaîne.

setProperty()NN 6 IE 5(Mac) DOM 2

setProperty("CSSAttributeName", "value", "priority")

Définit une paire attribut de style/valeur. Si l´attribut existe déjà, la nouvelle valeur est appliquée à l´attribut existant; sinon, l´attribut et la valeur sont ajoutés à l´élément.

 
Paramètres
 
  • Le nom d´attribut CSS d´une déclaration de style interne (pas la version DOM du nom de la propriété).
  • Chaîne de la valeur au format applicable à l´attribut.
  • Chaîne de l´affectation de priorité (telle que !important) ou chaîne vide.
 
Valeur renvoyée

Aucune.

setExpression()NN s.o. IE 5 (Win) DOM s.o.

setExpression("propertyName", "expression", ["scriptLanguage"])

Affecte une expression de script à la propriété d'un objet élément comme façon de calculer dynamiquement une valeur pour la propriété. Cette méthode fonctionne avec les propriétés des objets éléments et de leurs objets style si vous le désirez. L'expression est réévaluée automatiquement pour la plupart des événements axés sur l'utilisateur ou vous pouvez explicitement forcer la réévaluation par le biais de la méthode recalc() à tout moment.

 

L'affectation d'une expression à l'attribut d'un élément peut prendre la place d'un traitement d'événements, tel que la maintenance des relations de position entre les éléments lorsqu'un utilisateur redimensionne la fenêtre du navigateur. Par exemple, pour conserver un élément centré horizontalement dans la fenêtre du navigateur, vous pouvez utiliser l'une des techniques suivantes pour appliquer une expression à la propriété style.left . Le premier exemple illustre la syntaxe (aussi pour IE 5 pour Windows et versions ultérieures) pour l'affectation d'une expression comme attribut interne pour l'élément:

 

Ou, une fonction invoquée au chargement pourrait inclure l'instruction suivante:

 

Dans les deux cas, la même expression calcule la position de coordonnée pour le bord gauche de l'élément par rapport à la largeur visible actuelle de l'élément body . Comme cette expression dépend de la propriété de dimension de l'élément body , le navigateur sait qu'il doit réévaluer toute expression pouvant être affectée par la modification de la taille du corps due au redimensionnement de la fenêtre.

 

Assurez-vous que la valeur résultant de l'expression que vous affectez est du type de données désiré pour l'attribut que vous définissez. Isolez l'expression et effectuez des tests initiaux dessus avant de l'affecter à la méthode setExpression() . Sinon, le débogage sera plus difficile.

 

Si vous voulez qu'une expression affecte une valeur à un attribut et force cette valeur à rester, utilisez la méthode removeExpression() pour empêcher toute autre réévaluation de la valeur de l'attribut.

<div id="heading" style="position:absolute; left:expression(
  document.body.clientWidth/2-document.getElementById("heading").offsetWidth/2);
 
Paramètres
 
  • Le nom de l'attribut contrôlé par l'expression, mais sous la forme du nom de propriété sensible à la casse (par exemple, utilisez le nom de propriété className au lieu du nom d'attribut class correspondant).
  • Une chaîne contenant l'expression de script à évaluer. L'expression doit être évaluée comme une valeur appropriée pour la propriété nommée dans le premier paramètre et les instructions multiples séparées par deux-points ne sont donc pas autorisées. Les références à d'autres éléments doivent être des références complètes. Les anciennes implémentations risquent d'avoir des problèmes avec les références qui comprennent des tableaux.
  • Une des trois constantes sous forme de chaîne: JScript | JavaScript | VBScript . La valeur par défaut est JScript .
 
Valeur renvoyée

Aucune.

disabledNN 6 IE 4 DOM 1

Lecture/écriture

Détermine si l'élément est disponible pour une action interactive de l'utilisateur. S'il est défini sur la valeur true , l'utilisateur ne peut pas activer ni modifier cet élément, qui apparaît généralement en grisé sur cette page. Cette propriété est disponible pour tous les objets éléments dans IE 5.5 pour Windows et versions ultérieures. Pour IE 4 et IE 5, elle ne s'applique qu'aux contrôles de formulaire, alors que Netscape 6 et versions ultérieures reconnaissent cette propriété pour les contrôles de formulaire et l'objet élément style . La paire désactivée nom  /  valeur d'un contrôle de formulaire n'est pas transmise avec le formulaire.

 
Exemple
 
document.getElementById("myButton").disabled = true;
 
Valeur

Valeur booléenne: true | false .

 
Par défaut

false

readyStateNN s.o. IE 4 DOM s.o.

Lecture seule

Renvoie l'état courant du téléchargement du contenu de l'objet. Si un script (en particulier un script déclenché par un événement utilisateur) peut exécuter certaines actions lors du chargement du document, mais doit en éviter d'autres tant que la page n'est pas complètement chargée, cette propriété fournit des informations intermédiaires sur le processus de chargement. Utilisez sa valeur dans des tests de condition. La valeur de cette propriété change de façon dynamique en fonction du progrès du chargement. Toute modification de la valeur de propriété déclenche un événement onReadyStateChange (l'événement ne remonte pas).

 

Lors de son introduction dans IE 4, la propriété n'était disponible que pour les objets document , embed , img , link , object , script et style . IE 5 a élargi la prise en charge à tous les objets éléments HTML.

 
Exemple
 
if (document.readyState == "loading") {
    //statements for alternate handling while loading
}
 
Valeur

Pour tous les éléments sauf object , une des valeurs suivantes, sous forme de chaîne: uninitialized | loading | loaded | interactive | complete . Certains éléments permettent à l'utilisateur d'interagir avec une partie du contenu. Dans ce cas, la propriété peut renvoyer la valeur interactive jusqu'à ce que le chargement soit terminé. Certains types d'éléments ne renvoient pas toutes les valeurs dans l'ordre pendant le processus de chargement. L'élément object renvoie des valeurs numériques pour ces cinq états. Elles vont de 0 (uninitialized ) à 4 (complete ).

 
Par défaut

Aucune.