CKTIS / JavaScript
HTMLCanvasElement: kontekst rysowania i wymiary
HTMLCanvasElement udostępnia powierzchnię do rysowania w przeglądarce. Poznaj getContext() oraz właściwości width i height. W kontekście 2D przypisanie do dowolnej z tych właściwości usuwa rysunek i resetuje stan kontekstu, nawet gdy wartość się nie zmienia.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
canvas.getContext(contextType, contextAttributes)
canvas.width = width;
canvas.height = height;HTMLCanvasElement reprezentuje element canvas w przeglądarce. Sam element przechowuje powierzchnię rysowania; operacje rysowania udostępnia kontekst. Jest to Web API, a nie część ECMAScript. Obecność Node 24 w repozytorium nie potwierdza dostępności tego API.
HTMLCanvasElement.getContext wywołuje się na instancji jako canvas.getContext("2d"), aby otrzymać CanvasRenderingContext2D. Opcjonalny drugi argument określa ustawienia kontekstu. Sprawdź wynik: metoda zwraca null, gdy typ nie jest obsługiwany, element ma już inny tryb kontekstu lub nie uda się utworzyć kontekstu. Na przykład nawet gdy typ kontekstu WebGL jest obsługiwany, wywołanie z włączoną opcją failIfMajorPerformanceCaveat może zwrócić null, a ponowne wywołanie na tym samym elemencie z wyłączoną opcją może się powieść. Po pomyślnym utworzeniu kontekstu kolejne wywołania na tym samym elemencie z tym samym typem zwracają ten sam obiekt. Po przekazaniu kontroli przez transferControlToOffscreen() metoda zgłasza InvalidStateError.
HTMLCanvasElement.width i HTMLCanvasElement.height odzwierciedlają atrybuty wymiarów i określają rozmiar wewnętrznej powierzchni rysowania. Domyślne wartości to odpowiednio 300 i 150. Rozmiar wyświetlania ustawiony przez CSS jest czymś innym: skaluje obraz, co może go rozmyć lub zniekształcić.
W kontekście 2D przypisanie do width lub height czyści powierzchnię, usuwa bieżącą ścieżkę i przywraca domyślne ustawienia kontekstu, w tym fillStyle, nawet przy przypisaniu bieżącej wartości. Ustaw wymiary przed konfiguracją kontekstu 2D i rysowaniem; po zmianie rozmiaru odtwórz stan i rysunek. W WebGL zmiana rozmiaru bufora rysowania nie resetuje stanu kontekstu. Po przekazaniu kontroli do OffscreenCanvas przez transferControlToOffscreen() przypisanie do width lub height na pierwotnym elemencie zgłasza InvalidStateError. Podstawowe API jest szeroko dostępne w przeglądarkach, ale obsługa poszczególnych typów i opcji kontekstu jest różna.
Przykłady
(() => {
const canvas = document.createElement("canvas");
console.log(canvas.width, canvas.height);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext("2d");
if (ctx === null) {
throw new Error("2D context unavailable");
}
console.log(canvas.getContext("2d") === ctx);
ctx.fillStyle = "#ff0000";
ctx.fillRect(0, 0, canvas.width, canvas.height);
canvas.width = canvas.width;
console.log(canvas.width, canvas.height, ctx.fillStyle);
})();Wynik
300 150 true 4 2 #000000
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.