Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLCanvasElement: kontekst za crtanje i dimenzije

HTMLCanvasElement pruža površinu za crtanje u pregledniku. Saznajte kako upotrebljavati getContext(), width i height. U 2D kontekstu dodjela vrijednosti bilo kojem od tih svojstava briše crtež i vraća kontekst u zadano stanje, čak i kada se vrijednost ne promijeni.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

canvas.getContext(contextType, contextAttributes)
canvas.width = width;
canvas.height = height;

HTMLCanvasElement predstavlja element canvas u pregledniku. Sam element sadrži površinu za crtanje; kontekst omogućuje operacije crtanja. To je web API, a ne dio ECMAScripta. Prisutnost Nodea 24 u repozitoriju ne potvrđuje dostupnost ovog API-ja.

Pozovite HTMLCanvasElement.getContext na instanci kao canvas.getContext("2d") da biste dobili CanvasRenderingContext2D. Neobavezni drugi argument određuje postavke konteksta. Provjerite rezultat: metoda vraća null ako tip nije podržan, ako element već ima drugi način rada konteksta ili ako stvaranje konteksta ne uspije. Primjerice, čak i ako je tip konteksta WebGL podržan, poziv s uključenom opcijom failIfMajorPerformanceCaveat može vratiti null, a ponovni poziv na istom elementu s isključenom opcijom može uspjeti. Nakon što je kontekst uspješno stvoren, daljnji pozivi na istom elementu s istim tipom konteksta vraćaju isti objekt. Nakon prijenosa kontrole putem transferControlToOffscreen() metoda izbacuje InvalidStateError.

HTMLCanvasElement.width i HTMLCanvasElement.height odražavaju atribute dimenzija i određuju veličinu unutarnje površine za crtanje. Zadane vrijednosti su 300 i 150. Veličina prikaza postavljena CSS-om zasebna je: ona skalira sliku, zbog čega ona može postati mutna ili izobličena.

U 2D kontekstu dodjela vrijednosti svojstvu width ili height briše površinu, uklanja trenutačnu putanju i vraća postavke konteksta, uključujući fillStyle, na zadane vrijednosti. To vrijedi i kada dodijelite trenutačnu vrijednost. Postavite dimenzije prije konfiguriranja 2D konteksta i crtanja; nakon promjene veličine vratite stanje i ponovno nacrtajte sadržaj. Promjena veličine međuspremnika za crtanje u WebGL-u ne vraća kontekst WebGL-a u zadano stanje. Nakon prijenosa kontrole na OffscreenCanvas putem transferControlToOffscreen(), dodjela vrijednosti svojstvu width ili height na izvornom elementu izaziva iznimku InvalidStateError. Osnovni API široko je dostupan u preglednicima, ali podrška za pojedine tipove konteksta i opcije razlikuje se.

Primjeri

(() => {
  const canvas = document.createElement("canvas");
  console.log(canvas.width, canvas.height);
  canvas.width = 4;
  canvas.height = 2;

  const ctx = canvas.getContext("2d");
  if (ctx === null) {
    throw new Error("2D context unavailable");
  }
  console.log(canvas.getContext("2d") === ctx);

  ctx.fillStyle = "#ff0000";
  ctx.fillRect(0, 0, canvas.width, canvas.height);
  canvas.width = canvas.width;
  console.log(canvas.width, canvas.height, ctx.fillStyle);
})();

Rezultat

300 150
true
4 2 #000000

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori