CKTIS / HTML
Atrybut HTML width
Atrybut width określa szerokość obsługiwanych elementów HTML. Przyjmuje liczbę całkowitą nieujemną bez jednostki. W canvas steruje szerokością bitmapy, a nie tylko rozmiarem wyświetlania ustalanym przez CSS.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
width="<non-negative integer>"width nie jest atrybutem globalnym. Określa wymiar poziomy w pikselach CSS na img, iframe, embed, object, video, input z type="image" oraz source będącym dzieckiem picture. Wartością jest liczba całkowita nieujemna, np. width="240", bez px i %.
Atrybuty wymiarów są wskazówkami dla renderowania; CSS może zmienić rozmiar wyświetlania. Nie służą do rozciągania obrazu: para width i height powinna zachowywać naturalne proporcje z tolerancją zaokrągleń określoną w standardzie. Sam picture nie obsługuje width; obrazy wyświetla jego img, a wymiary można także podać na odpowiednich elementach source.
Na canvas atrybut width steruje szerokością bitmapy. Brak wartości lub błąd jej parsowania oznacza domyślnie 300; domyślna wysokość wynosi 150. Zmiana samego rozmiaru CSS skaluje prezentację, nie zmieniając wymiarów bitmapy. Ustawienie width w kontekście 2D czyści bitmapę i resetuje stan rysowania, nawet gdy przypisano dotychczasową wartość.
Przykład rozdziela oba rozmiary: bitmapa ma 240 × 120, lecz jest wyświetlana w rozmiarze 480 × 240 pikseli CSS.
Przykłady
<!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>Wynik
Bitmap: 240 x 120 CSS width: 480px
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.