CKTIS / JavaScript
HTMLCanvasElement: šířka a výška bitmapy
`canvas.width` a `canvas.height` určují rozměry bitmapy, nikoli velikost zobrazení v CSS. V kontextu 2D i přiřazení stejné hodnoty vymaže kresbu a obnoví výchozí stav kreslení.
Verze: Current web platform; runtime support varies
Syntaxe
canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;canvas.width a canvas.height jsou vlastnosti prvku canvas, které lze číst i měnit. Odrážejí stejnojmenné atributy HTML a určují šířku a výšku bitmapy v pixelech. V atributech HTML uváděj nezáporná celá čísla. Pokud atribut chybí nebo ho nelze načíst jako takové číslo, použije se výchozí hodnota 300 pro šířku nebo 150 pro výšku. Jde o rozhraní webové platformy, nikoli o součást ECMAScriptu.
canvas.style.width a canvas.style.height nastavují velikost prvku v rozvržení stránky, nikoli rozměry bitmapy. Změnou samotného CSS se pixely ani kresba nezmění. Zobrazený obraz se při zvětšení může rozmazat a při roztažení na jiný poměr stran zkreslit.
V kontextu 2d přiřazení do kterékoli ze dvou vlastností určujících rozměr bitmapy vymaže kresbu a vrátí tentýž kontext do výchozího stavu, a to i při přiřazení stávající hodnoty. Obnoví se mimo jiné aktuální cesta, transformace a styly. Rozměry nastav před kreslením. Pokud je změníš později, znovu nastav potřebný stav a překresli obraz.
Nepředpokládej, že WebGL nebo WebGPU obnovuje stav stejně jako 2d. Po volání transferControlToOffscreen() slouží prvek jen jako zástupný prvek pro zobrazení. Přiřazení do jeho width nebo height vyvolá InvalidStateError. Rozměry nastav na objektu OffscreenCanvas.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Canvas bitmap dimensions</title>
</head>
<body>
<script>
(() => {
const canvas = document.createElement('canvas');
console.log(`Default: ${canvas.width} × ${canvas.height}`);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext('2d');
if (!ctx) throw new Error('Canvas 2D is unavailable.');
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const pixelAlpha = () => ctx.getImageData(0, 0, 1, 1).data[3];
canvas.style.width = '40px';
canvas.style.height = '20px';
console.log(`After CSS: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`After assignment: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
})();
</script>
</body>
</html>Výsledek
Default: 300 × 150 After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5 After assignment: 4 × 2; pixel alpha 0; globalAlpha 1
Otevři soubor HTML v prohlížeči a podívej se na výstup v jeho konzoli. Prvek canvas se na stránku nepřidává. Po změně CSS zůstane pixel neprůhledný (`255`). Přiřazení stejné šířky ho vymaže (`0`) a vrátí `globalAlpha` na `1`.
Související lekce
- JavaScript · Lekce 26 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 27 · Středně pokročilá · Verze: 3