CKTIS / JavaScript
Canvas 2D: štýl výplne, štýl obrysu a hrúbka čiary
`fillStyle` určuje vzhľad výplne, `strokeStyle` vzhľad obrysu a `lineWidth` jeho hrúbku. Sú to tri samostatné vlastnosti stavu kreslenia v kontexte Canvas 2D.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 sú vlastnosti inštancie kontextu Canvas 2D, napríklad ctx získaného volaním canvas.getContext("2d"). Patria k API webovej platformy, nie k ECMAScriptu, preto ich neposkytuje každé prostredie JavaScriptu. Samotné priradenie nič nevykreslí.
fillStyle určuje výplň pre fill(), fillRect() a fillText(). strokeStyle určuje štýl obrysu pre stroke(), strokeRect() a strokeText(). Oba štýly sú spočiatku čierne a prijímajú reťazec s farbou CSS, objekt CanvasGradient alebo CanvasPattern. Neplatný reťazec s farbou ponechá predchádzajúcu hodnotu. Pri čítaní dostaneš serializovanú farbu (nie nevyhnutne pôvodný reťazec) alebo priradený objekt. Zmeny tohto objektu ovplyvnia ďalšie kreslenie.
lineWidth udáva celkovú hrúbku obrysu v jednotkách súradnicového priestoru, nie nevyhnutne v pixeloch obrazovky. Obrys je vycentrovaný vzhľadom na cestu a zmena mierky kontextu môže zmeniť jeho viditeľnú hrúbku. Počiatočná hodnota je 1. Použi konečné číslo väčšie ako nula: 0, záporné čísla, Infinity, -Infinity a NaN sa ignorujú.
Vlastnosti platia pre ďalšie kreslenie, kým sa nezmenia alebo kým sa stav neobnoví či nenastaví na predvolené hodnoty. save() a restore() ukladajú a obnovujú stav kreslenia, nie aktuálnu cestu ani pixely. Priradenie vzoru z obrázka iného pôvodu bez povolenia CORS môže zablokovať čítanie pixelov: getImageData() potom vyvolá SecurityError.
Prí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ýsledok
width: 6 fill: 255, 0, 0, 255 stroke: 0, 0, 255, 255 outside: 0, 0, 0, 0
Ulož príklad ako súbor HTML a otvor ho v prehliadači. Plátno sa nepridá na stránku: kód vypíše do konzoly prehliadača hrúbku a hodnoty RGBA vo výplni, na obryse a mimo kresby. Priradenie `0` ponechá hrúbku na hodnote `6`.
Súvisiace lekcie
- JavaScript · Lekcia 12 · Pokročilá · Verzia: 4