CKTIS / HTML
HTML-Attribut width
Das Attribut width gibt die Breite unterstützter HTML-Elemente an. Es nimmt eine nichtnegative Ganzzahl ohne Einheit entgegen. Bei canvas steuert es die Bitmapbreite und nicht nur die mit CSS festgelegte Anzeigegröße.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
width="<non-negative integer>"width ist kein globales Attribut. Es gibt die horizontale Abmessung in CSS-Pixeln für img, iframe, embed, object, video, input mit type="image" sowie für source-Elemente an, deren übergeordnetes Element picture ist. Der Wert ist eine nichtnegative Ganzzahl, zum Beispiel width="240", ohne px oder %.
Abmessungsattribute dienen als Hinweise für die Darstellung; CSS kann die Anzeigegröße ändern. Sie sind nicht dazu gedacht, Bilder zu strecken: Ein Paar aus width und height sollte das natürliche Seitenverhältnis innerhalb der im Standard festgelegten Rundungstoleranz beibehalten. picture selbst unterstützt width nicht; das Bild wird durch sein img-Element angezeigt, und Abmessungen können auch auf den entsprechenden source-Elementen angegeben werden.
Bei canvas steuert das Attribut width die Bitmapbreite. Ein fehlender Wert oder ein Fehler beim Parsen führt zum Standardwert 300; die Standardhöhe beträgt 150. Wird nur die CSS-Größe geändert, skaliert dies die Darstellung, ohne die Bitmapabmessungen zu ändern. Das Setzen von width bei einem 2D-Kontext löscht die Bitmap und setzt den Zeichenstatus zurück, selbst wenn der vorhandene Wert erneut zugewiesen wird.
Das Beispiel zeigt die beiden Größen getrennt: Die Bitmap ist 240 × 120 groß, wird aber mit 480 × 240 CSS-Pixeln angezeigt.
Beispiele
<!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>Ergebnis
Bitmap: 240 x 120 CSS width: 480px
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.