CKTIS / JavaScript
HTMLCanvasElement: kontekst renderowania i wymiary bitmapy
Wybierz kontekst za pomocą `getContext()` i ustaw wymiary bitmapy przez `width` i `height`. Zapis tych właściwości różni się od zmiany rozmiaru w CSS i w trybie 2D zeruje stan rysowania.
Wersja: Current web platform; runtime support varies
Składnia
canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeightHTMLCanvasElement to interfejs elementu <canvas>, zdefiniowany w standardzie HTML i udostępniany globalnie przez Window. Nie jest częścią ECMAScript 2024. Metoda canvas.getContext(contextId, options) przyjmuje identyfikator w postaci ciągu znaków i opcjonalne ustawienia zależne od trybu. "2d" wybiera CanvasRenderingContext2D, "bitmaprenderer" — ImageBitmapRenderingContext, "webgl" — WebGLRenderingContext, "webgl2" — WebGL2RenderingContext, a "webgpu" — GPUCanvasContext. Dostępność trybów i opcji zależy od środowiska.
Pierwsze udane wywołanie ustala tryb elementu. Ponowne wywołanie z tym samym identyfikatorem zwraca ten sam obiekt i nie nakłada nowych ustawień. Nieobsługiwany lub niedostępny tryb albo żądanie innego trybu zwraca null. Po udanym transferControlToOffscreen() element jest tylko zastępnikiem: wywołanie getContext() i zapis width lub height zgłaszają InvalidStateError.
canvas.width i canvas.height to właściwości odzwierciedlające atrybuty HTML o tych samych nazwach. Określają szerokość i wysokość bitmapy jako nieujemne liczby całkowite; brak atrybutu lub błąd jego parsowania daje odpowiednio 300 lub 150. Same canvas.style.width i canvas.style.height zmieniają rozmiar wyświetlania, nie rozdzielczość bitmapy; skalowanie może rozmyć obraz.
W trybie 2D zapis któregokolwiek wymiaru, nawet tej samej wartości, czyści bitmapę i przywraca domyślny stan rysowania, w tym bieżącą ścieżkę, transformację i style, bez wymiany obiektu kontekstu. Ustawiaj wymiary przed rysowaniem; po zmianie przywróć potrzebny stan i narysuj scenę ponownie. Nie zakładaj takiego samego resetu w innych trybach.
Narysowanie obrazu z innego źródła bez odpowiedniego zezwolenia CORS może sprawić, że bitmapa przestanie być origin-clean. Wtedy getImageData() zgłasza SecurityError; zmiana wymiarów bitmapy 2D usuwa jej zawartość, a nie udostępnia zablokowane piksele.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D resize reset</title>
<script>
(() => {
const canvas = document.createElement("canvas");
console.log(`${canvas.width}x${canvas.height}`);
canvas.width = 4;
canvas.height = 3;
console.log(`${canvas.width}x${canvas.height}`);
const ctx = canvas.getContext("2d");
if (ctx === null) throw new Error("2D canvas context unavailable");
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const alphaAtOrigin = () => ctx.getImageData(0, 0, 1, 1).data[3];
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
console.log(canvas.getContext("2d") === ctx);
console.log(canvas.getContext("bitmaprenderer") === null);
})();
</script>Wynik
300x150 4x3 255 0.5 0 1 true true
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i odczytaj wyniki w konsoli deweloperskiej. Pierwsze dwa wiersze pokazują wymiary. Zapis tej samej szerokości zmienia alfę piksela z `255` na `0` i przywraca `globalAlpha` z `0.5` do `1`. Oba wyniki `true` potwierdzają zachowanie tego samego kontekstu i odrzucenie innego trybu.
Powiązane lekcje
- JavaScript · Lekcja 12 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 33 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 34 · Zaawansowany · Wersja: 4