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

CKTIS / JavaScript

HTMLCanvasElement: kontekst za risanje in mere

HTMLCanvasElement v brskalniku zagotavlja risalno površino. Spoznajte metodo getContext() ter lastnosti width in height. V kontekstu 2D nastavitev ene od teh lastnosti izbriše risbo in ponastavi stanje konteksta, tudi če se vrednost ne spremeni.

Različica: 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 v brskalniku. Element sam vsebuje risalno površino; kontekst zagotavlja operacije risanja. To je spletni API in ni del ECMAScripta. Prisotnost Node 24 v repozitoriju ne potrjuje razpoložljivosti tega API-ja.

Za pridobitev CanvasRenderingContext2D na primerku pokličite HTMLCanvasElement.getContext kot canvas.getContext("2d"). Izbirni drugi argument določa nastavitve konteksta. Preverite rezultat: metoda vrne null, če tip ni podprt, če ima element že drug način konteksta ali če ustvarjanje konteksta ne uspe. Tudi pri podprtem tipu konteksta WebGL lahko na primer klic z omogočeno možnostjo failIfMajorPerformanceCaveat vrne null, ponovni klic na istem elementu z onemogočeno možnostjo pa lahko uspe. Ko je kontekst uspešno ustvarjen, nadaljnji klici na istem elementu z istim tipom konteksta vrnejo isti objekt. Po prenosu nadzora prek transferControlToOffscreen() metoda sproži InvalidStateError.

HTMLCanvasElement.width in HTMLCanvasElement.height odražata atributa mer in določata velikost notranje risalne površine. Privzeti vrednosti sta 300 in 150. Velikost prikaza, nastavljena s CSS, je ločena: sliko pomanjša ali poveča, zaradi česar je lahko zamegljena ali popačena.

V kontekstu 2D nastavitev lastnosti width ali height počisti risalno površino, izbriše trenutno pot in povrne nastavitve konteksta, vključno s fillStyle, na privzete vrednosti. To velja tudi, če dodelite trenutno vrednost. Mere nastavite pred konfiguriranjem konteksta 2D in risanjem; po spremembi velikosti obnovite stanje in znova narišite vsebino. Sprememba velikosti risalnega medpomnilnika WebGL ne ponastavi stanja konteksta WebGL. Ko z transferControlToOffscreen() prenesete nadzor na OffscreenCanvas, dodelitev vrednosti lastnosti width ali height na prvotnem elementu sproži InvalidStateError. Osnovni API je v brskalnikih široko dostopen, podpora za posamezne tipe kontekstov in možnosti pa se razlikuje.

Primeri

(() => {
  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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri