CKTIS / JavaScript
Canvas 2D: styl výplně, styl obrysu a tloušťka čáry
`fillStyle` určuje vzhled výplně, `strokeStyle` vzhled obrysu a `lineWidth` jeho tloušťku. Jde o tři samostatné vlastnosti stavu kreslení kontextu Canvas 2D.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
ctx.fillStyle = paint;
ctx.strokeStyle = paint;
ctx.lineWidth = width;
// paint: CSS color string, CanvasGradient, or CanvasPattern
// width: finite number greater than 0, in canvas coordinate-space unitsfillStyle, strokeStyle a lineWidth jsou vlastnosti instance kontextu Canvas 2D, například ctx získaného voláním canvas.getContext("2d"). Patří k API webové platformy, nikoli k ECMAScriptu, takže je neposkytuje každé prostředí JavaScriptu. Samotné přiřazení nic nevykreslí.
fillStyle určuje výplň pro fill(), fillRect() a fillText(). strokeStyle určuje styl obrysu pro stroke(), strokeRect() a strokeText(). Oba styly jsou zpočátku černé a přijímají řetězec s barvou CSS, objekt CanvasGradient nebo CanvasPattern. Neplatný řetězec s barvou ponechá předchozí hodnotu. Při čtení dostaneš serializovanou barvu (ne nutně původní řetězec) nebo přiřazený objekt. Změny tohoto objektu ovlivní další kreslení.
lineWidth udává celkovou tloušťku obrysu v jednotkách souřadnicového prostoru, ne nutně v pixelech obrazovky. Obrys je vystředěný vůči cestě a změna měřítka kontextu může změnit jeho viditelnou tloušťku. Počáteční hodnota je 1. Použij konečné číslo větší než nula: 0, záporná čísla, Infinity, -Infinity a NaN se ignorují.
Vlastnosti platí pro další kreslení, dokud se nezmění nebo dokud se stav neobnoví či nevynuluje na výchozí hodnoty. save() a restore() ukládají a obnovují stav kreslení, nikoli aktuální cestu ani pixely. Přiřazení vzoru z obrázku jiného původu bez povolení CORS může zablokovat čtení pixelů: getImageData() pak vyvolá SecurityError.
Příklady
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D fill and stroke</title>
<script>
(() => {
const canvas = document.createElement("canvas");
canvas.width = canvas.height = 32;
const ctx = canvas.getContext("2d");
if (!ctx) throw new Error("Canvas 2D is unavailable");
ctx.fillStyle = "#ff0000";
ctx.strokeStyle = "#0000ff";
ctx.lineWidth = 6;
ctx.lineWidth = 0;
ctx.fillRect(8, 8, 16, 16);
ctx.strokeRect(8, 8, 16, 16);
const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(", ");
console.log(`width: ${ctx.lineWidth}`);
console.log(`fill: ${rgba(16, 16)}`);
console.log(`stroke: ${rgba(6, 16)}`);
console.log(`outside: ${rgba(2, 16)}`);
})();
</script>Výsledek
width: 6 fill: 255, 0, 0, 255 stroke: 0, 0, 255, 255 outside: 0, 0, 0, 0
Ulož příklad jako soubor HTML a otevři ho v prohlížeči. Plátno se nepřidá na stránku: kód vypíše do konzole prohlížeče tloušťku a hodnoty RGBA uvnitř výplně, na obrysu a mimo kresbu. Přiřazení `0` ponechá tloušťku na hodnotě `6`.
Související lekce
- JavaScript · Lekce 12 · Pokročilá · Verze: 4