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.