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

CKTIS / JavaScript

Canvas 2D: obrys, výplň, písmo a účaří

Nastavte tloušťku a styl obrysu, styl výplně, písmo a svislý referenční bod textu v kontextu Canvas 2D.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const ctx = canvas.getContext("2d");
// After checking that ctx is not null:
ctx.lineWidth = 4;
ctx.strokeStyle = "#1d4ed8";
ctx.fillStyle = "#dbeafe";
ctx.font = "20px sans-serif";
ctx.textBaseline = "top";
// Read any of these properties with ctx.propertyName.

lineWidth, strokeStyle, fillStyle, font a textBaseline jsou vlastnosti kontextu, který vrací canvas.getContext("2d"), nikoli samotného prvku canvas. Patří do webového API, ne do ECMAScriptu. Dostupnost závisí na běhovém prostředí a getContext() může vrátit null. Přiřazení mění stav pro další kreslení, nikoli již vykreslené pixely. save() stav uloží a restore() jej obnoví, aniž by vrátilo zpět kresbu nebo změny aktuální cesty.

lineWidth určuje tloušťku obrysu v jednotkách souřadnicového systému canvasu. Změna měřítka může změnit viditelnou tloušťku. Tah je vystředěný na cestě. Počáteční hodnota je 1. Nula, záporná čísla, Infinity, -Infinity a NaN se ignorují.

strokeStyle určuje styl obrysu například pro strokeRect() a strokeText(). fillStyle určuje styl výplně například pro fillRect() a fillText(). Obě vlastnosti přijímají řetězec s barvou CSS, objekt CanvasGradient nebo objekt CanvasPattern. Počáteční hodnota obou je černá. Neplatný řetězec s barvou ponechá předchozí hodnotu.

font přijímá řetězec ve zkrácené syntaxi vlastnosti CSS font, například "bold 20px sans-serif". Počáteční hodnota je "10px sans-serif". Neplatné řetězce se ignorují a line-height zde nemá vliv. Není-li písmo dostupné nebo se ještě nenačetlo, prohlížeč použije jiné; vzhled glyfů se může v různých prostředích lišit.

textBaseline určuje svislou referenci, kterou fillText() a strokeText() umístí na souřadnici y. "top", "middle" a "bottom" označují horní okraj, střed a dolní okraj čtverce em daného písma, nikoli okraje viditelných glyfů. Další možnosti jsou "hanging" (závěsné účaří), "alphabetic" (abecední účaří, výchozí) a "ideographic" (dolní ideografické účaří). Jiné řetězce se ignorují. Vodorovné zarovnání se nastavuje samostatně pomocí textAlign.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Canvas 2D drawing styles</title>
</head>
<body>
  <canvas id="demo" width="240" height="80"></canvas>
  <script>
    const canvas = document.getElementById("demo");
    const ctx = canvas.getContext("2d");
    if (!ctx) throw new Error("Canvas 2D is unavailable");

    const readStyles = () => [
      ctx.lineWidth, ctx.strokeStyle, ctx.fillStyle, ctx.font, ctx.textBaseline
    ].join(" | ");

    ctx.save();
    ctx.lineWidth = 4;
    ctx.lineWidth = 0;
    ctx.strokeStyle = "#1d4ed8";
    ctx.fillStyle = "#dbeafe";
    ctx.fillRect(10, 10, 220, 60);
    ctx.strokeRect(10, 10, 220, 60);

    ctx.fillStyle = "#172554";
    ctx.font = "20px sans-serif";
    ctx.textBaseline = "top";
    ctx.fillText("Canvas 2D", 22, 20);
    console.log(readStyles());

    ctx.restore();
    console.log(readStyles());
  </script>
</body>
</html>

Výsledek

4 | #1d4ed8 | #172554 | 20px sans-serif | top
1 | #000000 | #000000 | 10px sans-serif | alphabetic

Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a podívejte se do vývojářské konzole. První řádek ukazuje hodnoty pěti vlastností kontextu před voláním `restore()`. Tloušťka zůstává `4` i po přiřazení `0`. Z pěti vypsaných vlastností používá `strokeRect()` pro obrys obdélníku `lineWidth` a `strokeStyle`, zatímco `fillText()` používá `fillStyle`, `font` a `textBaseline`. Druhý řádek ukazuje obnovené počáteční hodnoty. Světle modrý obdélník s modrým obrysem a tmavým textem zůstává viditelný.

Související lekce

  • JavaScript · Lekce 26 · Středně pokročilá · Verze: 3

Zdroje