Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLCanvasElement: širina i visina bitmape

`canvas.width` i `canvas.height` određuju veličinu bitmape, a ne veličinu prikaza u CSS-u. U 2D kontekstu i dodjela iste vrijednosti briše crtež i vraća stanje crtanja na zadane postavke.

Verzija: Current web platform; runtime support varies

Sintaksa

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

canvas.width i canvas.height svojstva su elementa canvas koja možeš čitati i mijenjati. Odražavaju istoimene atribute HTML-a i određuju širinu i visinu bitmape u pikselima. U atributima HTML-a navedi nenegativne cijele brojeve. Ako atribut nedostaje ili se ne može protumačiti kao takav broj, primjenjuje se zadana vrijednost 300 za širinu ili 150 za visinu. To su svojstva web-platforme, a ne ECMAScripta.

canvas.style.width i canvas.style.height određuju veličinu elementa u rasporedu stranice, a ne dimenzije bitmape. Promjena samo CSS-a ne mijenja piksele ni crtež. Prikazana slika može se zamutiti pri povećanju ili izobličiti pri rastezanju u drugi omjer stranica.

U kontekstu 2d, dodjela bilo koje od dviju dimenzija bitmape briše crtež i vraća isti kontekst u zadano stanje, čak i kad dodijeliš trenutačnu vrijednost. To obuhvaća trenutačnu putanju, transformaciju i stilove. Postavi dimenzije prije crtanja. Ako ih poslije promijeniš, ponovno postavi potrebno stanje i ponovno iscrtaj sadržaj.

Nemoj pretpostaviti da se WebGL ili WebGPU ponašaju kao 2d. Nakon poziva transferControlToOffscreen() element služi samo kao mjesto prikaza. Dodjela njegovu svojstvu width ili height izaziva InvalidStateError. Dimenzije postavi na objektu OffscreenCanvas.

Primjeri

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

Otvori HTML datoteku u pregledniku i pročitaj ispis u njegovoj konzoli. Element canvas ne dodaje se na stranicu. Promjena CSS-a ostavlja piksel neprozirnim (`255`); ponovna dodjela iste širine briše ga (`0`) i vraća `globalAlpha` na `1`.

Povezane lekcije

  • JavaScript · Lekcija 26 · Srednje · Verzija: 3
  • JavaScript · Lekcija 27 · Srednje · Verzija: 3

Izvori