Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLCanvasElement: širina in višina bitne slike

`canvas.width` in `canvas.height` določata velikost bitne slike, ne velikosti prikaza v CSS. V kontekstu 2D tudi ponovna dodelitev iste vrednosti izbriše risbo in ponastavi stanje risanja.

Različica: Current web platform; runtime support varies

Sintaksa

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

canvas.width in canvas.height sta lastnosti elementa canvas, ki ju lahko bereš in spreminjaš. Odražata istoimenska atributa HTML ter določata širino in višino bitne slike v slikovnih pikah. V atributih HTML uporabi nenegativna cela števila. Če atribut manjka ali ga ni mogoče razčleniti kot tako število, se uporabi privzeta vrednost 300 za širino oziroma 150 za višino. Lastnosti sta del spletne platforme, ne ECMAScripta.

canvas.style.width in canvas.style.height določata velikost elementa v postavitvi strani, ne velikosti bitne slike. Sprememba samo v CSS ne spremeni slikovnih pik ali risbe. Prikazana slika je lahko ob povečavi zamegljena ali ob raztezanju v drugo razmerje stranic popačena.

V kontekstu 2d dodelitev vrednosti kateri koli od obeh lastnosti za velikost bitne slike izbriše risbo in povrne isti kontekst v privzeto stanje, tudi če dodeliš trenutno vrednost. Ponastavijo se med drugim trenutna pot, transformacija in slogi. Velikost nastavi pred risanjem; če jo pozneje spremeniš, ponovno nastavi potrebno stanje in znova nariši vsebino.

Ne predpostavljaj, da se WebGL ali WebGPU ponastavita enako kot 2d. Po klicu transferControlToOffscreen() element služi le kot mesto prikaza. Dodelitev vrednosti njegovi lastnosti width ali height sproži InvalidStateError. Velikost nastavi na objektu OffscreenCanvas.

Primeri

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

Rezultat

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

Odpri datoteko HTML v brskalniku in preberi izpis v njegovi konzoli. Element canvas ni dodan na stran. Po spremembi CSS slikovna pika ostane neprosojna (`255`); ponovna dodelitev iste širine jo izbriše (`0`) in vrne `globalAlpha` na `1`.

Povezane lekcije

  • JavaScript · Lekcija 26 · Srednja · Različica: 3
  • JavaScript · Lekcija 27 · Srednja · Različica: 3

Viri