Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

CSSStyleDeclaration : épaisseurs de bordure et transform

Réglez l’épaisseur de chaque côté de la bordure et une transformation CSS avec `element.style`. Distinguez les déclarations en ligne des valeurs résolues par le navigateur après application de la cascade.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const style = element.style;
style.borderStyle = "solid";
style.borderWidth = "2px 4px 6px 8px";
style.borderTopWidth = "3px";
style.borderRightWidth = "4px";
style.borderBottomWidth = "6px";
style.borderLeftWidth = "8px";
style.transform = "translateX(12px)";
style.setProperty("border-top-width", "3px");
style.getPropertyValue("border-top-width");
getComputedStyle(element).borderTopWidth;

element.style donne accès à un objet qui se met à jour automatiquement et dont les propriétés permettent de lire et de modifier les déclarations de l’attribut style d’un élément. Dans le CSSOM actuel, il s’agit d’un objet CSSStyleProperties, qui hérite de CSSStyleDeclaration ; les anciennes documentations peuvent citer l’interface de base. Cette API du navigateur ne fait pas partie d’ECMAScript 2024.

borderWidth correspond à la propriété raccourcie border-width. Une valeur s’applique aux quatre côtés ; deux s’appliquent au haut/bas, puis à droite/gauche ; trois s’appliquent au haut, à droite/gauche, puis au bas ; quatre suivent l’ordre haut, droite, bas, gauche. Pour un seul côté, utilisez borderTopWidth, borderRightWidth, borderBottomWidth ou borderLeftWidth. Donnez des valeurs CSS sous forme de chaînes, comme "3px", "0" ou "thin" ; le nombre 3 ne signifie pas trois pixels. L’épaisseur seule ne rend pas la bordure visible : avec none ou hidden, elle se résout à zéro. Définissez un style, par exemple borderStyle = "solid".

style.transform = "translateX(12px)" remplace toute la déclaration en ligne transform. Si l’élément est transformable et que cette déclaration l’emporte dans la cascade, son rendu se décale de 12 pixels CSS vers la droite sans changer la place qu’il occupe dans le flux normal. Une déclaration !important applicable dans une feuille de style de l’auteur peut l’emporter sur la déclaration en ligne. Pour combiner des fonctions, placez-les dans une même chaîne en les séparant par des espaces ; leur ordre compte.

setProperty("border-top-width", "3px") et getPropertyValue("border-top-width") utilisent le nom CSS avec des tirets, contrairement à style.borderTopWidth. Sans déclaration en ligne pour ce côté, style.borderTopWidth renvoie "". Pour connaître la valeur résolue après application de la cascade pour un élément dans le document, utilisez getComputedStyle(element) ; le résultat se met à jour automatiquement, mais il est en lecture seule.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Border widths and transform</title>
</head>
<body>
  <script>
    {
      const box = document.createElement("div");
      const style = box.style;

      style.borderStyle = "solid";
      style.borderWidth = "2px 4px 6px 8px";
      style.setProperty("border-top-width", "3px");
      style.transform = "translateX(12px)";

      console.log([
        style.borderTopWidth,
        style.borderRightWidth,
        style.borderBottomWidth,
        style.borderLeftWidth,
      ].join(" "));
      console.log(style.getPropertyValue("border-top-width"));
      console.log(style.transform);
    }
  </script>
</body>
</html>

Résultat

3px 4px 6px 8px
3px
translateX(12px)

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console de développement. La propriété raccourcie définit les quatre épaisseurs ; `setProperty()` ne change que celle du haut. L’élément n’est pas ajouté au document : la sortie montre les déclarations en ligne, pas le rendu.

Leçons associées

  • JavaScript · Leçon 35 · Intermédiaire · Version : 3

Sources