Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 = bitmapHeight

HTMLCanvasElement 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

Źródła