CKTIS / HTML
HTML-attribuut width
Het attribuut width geeft de breedte aan van HTML-elementen die het ondersteunen. Het neemt een niet-negatief geheel getal zonder eenheid aan. Op canvas bepaalt het de bitmapbreedte, niet alleen de weergavegrootte die met CSS is ingesteld.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
width="<non-negative integer>"width is geen globaal attribuut. Het geeft de horizontale afmeting in CSS-pixels aan voor img, iframe, embed, object, video, input met type="image" en voor source waarvan het bovenliggende element picture is. De waarde is een niet-negatief geheel getal, zoals width="240", zonder px of %.
Afmetingsattributen zijn aanwijzingen voor de weergave; CSS kan de weergavegrootte aanpassen. Ze zijn niet bedoeld om afbeeldingen uit te rekken: een paar width en height hoort de natuurlijke beeldverhouding te behouden binnen de afrondingstolerantie van de standaard. picture ondersteunt zelf geen width; het bijbehorende img-element geeft de afbeelding weer, en afmetingen kunnen ook op de relevante source-elementen worden opgegeven.
Op canvas bepaalt het attribuut width de bitmapbreedte. Als de waarde ontbreekt of niet kan worden geparseerd, geldt de standaardwaarde 300; de standaardhoogte is 150. Alleen de CSS-grootte wijzigen schaalt de weergave zonder de bitmapafmetingen te veranderen. width instellen met een 2D-context wist de bitmap en herstelt de tekenstatus, zelfs wanneer de bestaande waarde opnieuw wordt toegewezen.
Het voorbeeld houdt de twee grootten uit elkaar: de bitmap is 240 × 120, maar wordt weergegeven op 480 × 240 CSS-pixels.
Voorbeelden
<!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>Resultaat
Bitmap: 240 x 120 CSS width: 480px
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.