CKTIS / JavaScript
HTMLCanvasElement: kontext kreslení a rozměry
HTMLCanvasElement poskytuje v prohlížeči kreslicí plochu. Seznamte se s metodou getContext() a vlastnostmi width a height. V kontextu 2D přiřazení hodnoty jedné z těchto vlastností smaže kresbu a nastaví stav kontextu na výchozí hodnoty, i když se přiřazovaná hodnota nezmění.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
canvas.getContext(contextType, contextAttributes)
canvas.width = width;
canvas.height = height;HTMLCanvasElement představuje prvek canvas v prohlížeči. Samotný prvek obsahuje kreslicí plochu; kontext poskytuje kreslicí operace. Jde o webové API, nikoli o součást ECMAScriptu. Přítomnost Node 24 v repozitáři nedokládá dostupnost tohoto API.
Pro získání CanvasRenderingContext2D zavolejte na instanci HTMLCanvasElement.getContext jako canvas.getContext("2d"). Volitelný druhý argument určuje nastavení kontextu. Zkontrolujte výsledek: metoda vrací null, pokud typ není podporován, prvek již má jiný režim kontextu nebo se kontext nepodaří vytvořit. Například i u podporovaného typu kontextu WebGL může volání se zapnutou volbou failIfMajorPerformanceCaveat vrátit null, zatímco další pokus na stejném prvku s vypnutou volbou může uspět. Po úspěšném vytvoření kontextu vracejí další volání na stejném prvku se stejným typem kontextu tentýž objekt. Po předání řízení pomocí transferControlToOffscreen() metoda vyvolá InvalidStateError.
HTMLCanvasElement.width a HTMLCanvasElement.height odpovídají atributům rozměrů a určují velikost interní kreslicí plochy. Výchozí hodnoty jsou 300 a 150. Velikost zobrazení nastavená pomocí CSS je odlišná: obrázek škáluje, což může způsobit jeho rozmazání nebo zkreslení.
V kontextu 2D přiřazení hodnoty vlastnosti width nebo height vymaže plochu, odstraní aktuální cestu a vrátí nastavení kontextu, například fillStyle, na výchozí hodnoty. Platí to i při přiřazení aktuální hodnoty. Nastavte rozměry před konfigurací kontextu 2D a kreslením; po změně velikosti obnovte stav a kreslete znovu. Změna velikosti vykreslovacího bufferu WebGL nevrátí stav kontextu WebGL do výchozího stavu. Po předání řízení objektu OffscreenCanvas pomocí transferControlToOffscreen() vyvolá přiřazení hodnoty vlastnosti width nebo height původního prvku výjimku InvalidStateError. Základní API je v prohlížečích široce dostupné, podpora jednotlivých typů kontextů a možností se však liší.
Pří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ýsledek
300 150 true 4 2 #000000
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.