CKTIS / JavaScript
HTMLCanvasElement: szerokość i wysokość bitmapy
`canvas.width` i `canvas.height` określają rozmiar bitmapy, nie rozmiar wyświetlania w CSS. W kontekście 2D nawet przypisanie tej samej wartości czyści obraz i resetuje stan rysowania.
Wersja: Current web platform; runtime support varies
Składnia
canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;canvas.width i canvas.height to właściwości elementu canvas dostępne do odczytu i zapisu. Odzwierciedlają atrybuty HTML o tych samych nazwach i określają szerokość oraz wysokość bitmapy w pikselach. W atrybutach HTML należy podawać nieujemne liczby całkowite. Jeśli atrybutu brakuje lub nie da się go odczytać jako takiej liczby, szerokość wynosi domyślnie 300, a wysokość 150. To API platformy webowej, a nie część ECMAScriptu.
canvas.style.width i canvas.style.height ustawiają wymiary elementu w układzie strony, a nie wymiary bitmapy. Sama zmiana CSS nie dodaje pikseli ani nie usuwa rysunku. Wyświetlany obraz może się rozmyć po powiększeniu lub zniekształcić, jeśli zostanie rozciągnięty do innych proporcji.
W kontekście 2d zapis do dowolnej z tych dwóch właściwości bitmapy usuwa dotychczasowy rysunek i przywraca domyślny stan tego samego kontekstu, nawet gdy przypisujesz bieżącą wartość. Reset obejmuje między innymi bieżącą ścieżkę, transformację i style. Ustaw wymiary przed rysowaniem; jeśli zmienisz je później, ponownie ustaw potrzebny stan i narysuj obraz od nowa.
Nie zakładaj, że WebGL i WebGPU resetują się tak samo jak 2d. Po wywołaniu transferControlToOffscreen() element jest tylko miejscem wyświetlania obrazu: przypisanie do jego width lub height zgłasza InvalidStateError. Wymiary ustawiaj wtedy na obiekcie OffscreenCanvas.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Canvas bitmap dimensions</title>
</head>
<body>
<script>
(() => {
const canvas = document.createElement('canvas');
console.log(`Default: ${canvas.width} × ${canvas.height}`);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext('2d');
if (!ctx) throw new Error('Canvas 2D is unavailable.');
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const pixelAlpha = () => ctx.getImageData(0, 0, 1, 1).data[3];
canvas.style.width = '40px';
canvas.style.height = '20px';
console.log(`After CSS: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`After assignment: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
})();
</script>
</body>
</html>Wynik
Default: 300 × 150 After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5 After assignment: 4 × 2; pixel alpha 0; globalAlpha 1
Otwórz plik HTML w przeglądarce i odczytaj wynik w konsoli. Element `canvas` nie jest dodawany do strony. Po zmianie CSS piksel pozostaje nieprzezroczysty (`255`). Ponowne przypisanie tej samej szerokości ustawia alfę piksela na `0` i przywraca `globalAlpha` do `1`, nie zmieniając położenia piksela ani wymiarów bitmapy.
Powiązane lekcje
- JavaScript · Lekcja 26 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 27 · Średniozaawansowany · Wersja: 3