CKTIS / HTML
Atrybut height w HTML
Atrybut height określa pionowy wymiar obsługiwanych elementów HTML. Przyjmuje nieujemną liczbę całkowitą bez jednostki. W canvas steruje wysokością bitmapy, a nie tylko rozmiarem wyświetlania.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
height="N"height nie jest atrybutem globalnym. Dotyczy img, iframe, embed, object, video, input z type="image" oraz source, którego rodzicem jest picture. Wartość to nieujemna liczba całkowita w pikselach CSS: zapisuj height="100", nie height="100px" ani height="50%".
W picture obraz wyświetla element img; height nie należy do samego picture. Wymiary na odpowiednim source opisują wariant obrazu. Atrybuty wymiarów nie służą do zniekształcania proporcji zasobu.
Element canvas również obsługuje height, ale ustala on wysokość bitmapy. Brak atrybutu lub błąd parsowania daje domyślnie 150; domyślna szerokość wynosi 300. Rozmiar wyświetlania ustawiany przez CSS to osobna kwestia.
Dla kontekstu 2d przypisanie canvas.height czyści bitmapę i resetuje stan rysowania, nawet gdy wartość się nie zmienia. Przykład pokazuje zmianę kanału alfa narysowanego piksela z 255 na 0 po takim przypisaniu.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>height</title>
<canvas id="canvas" width="200" height="100"></canvas>
<pre id="output"></pre>
<script>
const canvas = document.getElementById("canvas");
const context = canvas.getContext("2d");
context.fillStyle = "red";
context.fillRect(0, 0, 20, 20);
const before = context.getImageData(0, 0, 1, 1).data[3];
canvas.height = 100;
const after = context.getImageData(0, 0, 1, 1).data[3];
document.getElementById("output").textContent =
`${canvas.width} x ${canvas.height}\n${before} -> ${after}`;
</script>Wynik
200 x 100 255 -> 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.