CKTIS / HTML
Attribut HTML width
L’attribut width indique la largeur des éléments HTML qui le prennent en charge. Il accepte un entier non négatif sans unité. Sur canvas, il contrôle la largeur du bitmap, et pas seulement la taille d’affichage définie par CSS.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
width="<non-negative integer>"width n’est pas un attribut global. Il indique la dimension horizontale en pixels CSS pour img, iframe, embed, object, video, input avec type="image", ainsi que pour source lorsque son parent est picture. Sa valeur est un entier non négatif, par exemple width="240", sans px ni %.
Les attributs de dimension sont des indications pour le rendu ; CSS peut modifier la taille d’affichage. Ils ne servent pas à étirer les images : une paire width et height doit préserver les proportions naturelles, dans la tolérance d’arrondi définie par la norme. picture ne prend pas lui-même en charge width ; c’est son élément img qui affiche l’image, et les dimensions peuvent aussi être indiquées sur les éléments source concernés.
Sur canvas, l’attribut width contrôle la largeur du bitmap. Une valeur absente ou une erreur d’analyse donne la valeur par défaut 300 ; la hauteur par défaut est 150. Modifier uniquement la taille CSS met à l’échelle l’affichage sans changer les dimensions du bitmap. Définir width avec un contexte 2D efface le bitmap et réinitialise l’état de dessin, même si la valeur existante est réaffectée.
L’exemple distingue les deux tailles : le bitmap mesure 240 × 120, mais il est affiché en 480 × 240 pixels CSS.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>width attribute</title>
<canvas id="drawing" width="240" height="120" style="width: 480px; height: 240px">Canvas demonstration</canvas>
<pre id="result"></pre>
<script>
const canvas = document.getElementById('drawing');
document.getElementById('result').textContent =
`Bitmap: ${canvas.width} x ${canvas.height}\n` +
`CSS width: ${getComputedStyle(canvas).width}`;
</script>
</html>Résultat
Bitmap: 240 x 120 CSS width: 480px
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.