Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLCanvasElement: šírka a výška bitovej mapy

`canvas.width` a `canvas.height` určujú rozmery bitovej mapy, nie veľkosť zobrazenia v CSS. V kontexte 2D aj priradenie rovnakej hodnoty vymaže kresbu a obnoví predvolený stav kreslenia.

Verzia: Current web platform; runtime support varies

Syntax

canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;

canvas.width a canvas.height sú vlastnosti prvku canvas, ktoré možno čítať aj meniť. Odrážajú rovnomenné atribúty HTML a určujú šírku a výšku bitovej mapy v pixeloch. V atribútoch HTML uvádzaj nezáporné celé čísla. Ak atribút chýba alebo ho nemožno načítať ako takéto číslo, použije sa predvolená hodnota 300 pre šírku alebo 150 pre výšku. Tieto vlastnosti patria do webovej platformy, nie do ECMAScriptu.

canvas.style.width a canvas.style.height nastavujú veľkosť prvku v rozložení stránky, nie rozmery bitovej mapy. Samotná zmena CSS nemení pixely ani kresbu. Zobrazený obraz môže po zväčšení vyzerať rozmazane a pri roztiahnutí na iný pomer strán sa môže zdeformovať.

V kontexte 2d priradenie do ktorejkoľvek z dvoch vlastností určujúcich rozmer bitovej mapy vymaže kresbu a obnoví predvolený stav toho istého kontextu, aj keď priradíš aktuálnu hodnotu. Týka sa to okrem iného aktuálnej cesty, transformácie a štýlov. Rozmery nastav pred kreslením. Ak ich zmeníš neskôr, znova nastav potrebný stav a obraz prekresli.

Nepredpokladaj, že WebGL alebo WebGPU obnovujú stav rovnako ako 2d. Po volaní transferControlToOffscreen() prvok slúži iba na zobrazenie výsledku. Priradenie do jeho width alebo height vyvolá InvalidStateError. Rozmery nastav na objekte OffscreenCanvas.

Príklady

<!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>

Výsledok

Default: 300 × 150
After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5
After assignment: 4 × 2; pixel alpha 0; globalAlpha 1

Otvor súbor HTML v prehliadači a pozri si výstup v jeho konzole. Prvok canvas sa na stránku nepridáva. Po zmene CSS zostane pixel nepriehľadný (`255`). Priradenie rovnakej šírky ho vymaže (`0`) a vráti `globalAlpha` na `1`.

Súvisiace lekcie

  • JavaScript · Lekcia 26 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 27 · Stredne pokročilá · Verzia: 3

Zdroje