Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 units

fillStyle, 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

Zdroje