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

CKTIS / JavaScript

HTMLCanvasElement: kontext kreslenia a rozmery

HTMLCanvasElement poskytuje v prehliadači plochu na kreslenie. Zoznámte sa s metódou getContext() a vlastnosťami width a height. V kontexte 2D priradenie hodnoty jednej z týchto vlastností vymaže kresbu a vráti kontext do predvoleného stavu, aj keď sa priraďovaná hodnota nezmení.

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

Syntax

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

HTMLCanvasElement predstavuje prvok canvas v prehliadači. Samotný prvok obsahuje plochu na kreslenie; kontext poskytuje operácie kreslenia. Ide o webové API, nie o súčasť ECMAScriptu. Prítomnosť Node 24 v repozitári nepotvrdzuje dostupnosť tohto API.

Na získanie CanvasRenderingContext2D zavolajte na inštancii HTMLCanvasElement.getContext ako canvas.getContext("2d"). Voliteľný druhý argument určuje nastavenia kontextu. Skontrolujte výsledok: metóda vráti null, ak typ nie je podporovaný, prvok už má iný režim kontextu alebo sa kontext nepodarí vytvoriť. Napríklad aj pri podporovanom type kontextu WebGL môže volanie so zapnutou voľbou failIfMajorPerformanceCaveat vrátiť null, kým ďalší pokus na tom istom prvku s vypnutou voľbou môže uspieť. Po úspešnom vytvorení kontextu ďalšie volania na tom istom prvku s rovnakým typom kontextu vracajú ten istý objekt. Po odovzdaní riadenia pomocou transferControlToOffscreen() metóda vyvolá InvalidStateError.

HTMLCanvasElement.width a HTMLCanvasElement.height zodpovedajú atribútom rozmerov a určujú veľkosť internej plochy na kreslenie. Predvolené hodnoty sú 300 a 150. Veľkosť zobrazenia nastavená cez CSS je odlišná: obrázok škáluje, čo môže spôsobiť jeho rozmazanie alebo skreslenie.

V kontexte 2D priradenie hodnoty vlastnosti width alebo height vymaže plochu, odstráni aktuálnu cestu a vráti nastavenia kontextu vrátane fillStyle na predvolené hodnoty. Platí to aj pri priradení aktuálnej hodnoty. Rozmery nastavte pred konfiguráciou kontextu 2D a kreslením; po zmene veľkosti obnovte stav a kreslite znova. Zmena veľkosti vykresľovacej vyrovnávacej pamäte WebGL nevráti kontext WebGL do predvoleného stavu. Po odovzdaní riadenia objektu OffscreenCanvas pomocou transferControlToOffscreen() vyvolá priradenie hodnoty vlastnosti width alebo height pôvodného prvku výnimku InvalidStateError. Základné API je v prehliadačoch široko dostupné, podpora jednotlivých typov kontextov a možností sa však líši.

Príklady

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

Výsledok

300 150
true
4 2 #000000

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje