Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła