WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen