Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła