Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Canvas 2D: obrys, výplň, písmo a základná čiara

Nastavte hrúbku a štýl obrysu, štýl výplne, písmo a zvislý referenčný bod textu v kontexte Canvas 2D.

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

Syntax

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 sú vlastnosti kontextu, ktorý vracia canvas.getContext("2d"), nie samotného prvku canvas. Patria do webového API, nie do ECMAScriptu. Dostupnosť závisí od prostredia vykonávania a getContext() môže vrátiť null. Priradenia menia stav pre ďalšie kreslenie, nie už vykreslené pixely. save() uloží stav a restore() ho obnoví bez toho, aby vrátilo späť kresbu alebo zmeny aktuálnej cesty.

lineWidth určuje hrúbku obrysu v jednotkách súradnicového systému plátna. Zmena mierky môže ovplyvniť viditeľnú hrúbku. Ťah je vycentrovaný na ceste. Počiatočná hodnota je 1. Nula, záporné čísla, Infinity, -Infinity a NaN sa ignorujú.

strokeStyle určuje štýl obrysu, napríklad pre strokeRect() a strokeText(). fillStyle určuje štýl výplne, napríklad pre fillRect() a fillText(). Obe vlastnosti prijímajú reťazec s farbou CSS, objekt CanvasGradient alebo objekt CanvasPattern. Počiatočná hodnota oboch je čierna. Neplatný reťazec s farbou ponechá predchádzajúcu hodnotu.

font prijíma reťazec v skrátenej syntaxi vlastnosti CSS font, napríklad "bold 20px sans-serif". Počiatočná hodnota je "10px sans-serif". Neplatné reťazce sa ignorujú a line-height tu nemá účinok. Ak písmo nie je dostupné alebo sa ešte nenačítalo, prehliadač použije iné; vzhľad glyfov sa môže medzi prostrediami líšiť.

textBaseline vyberá zvislú referenciu, ktorú fillText() a strokeText() umiestnia na súradnicu y. "top", "middle" a "bottom" označujú horný okraj, stred a dolný okraj štvorca em daného písma, nie okraje viditeľných glyfov. Ďalšie možnosti sú "hanging" (závesná základná čiara), "alphabetic" (abecedná základná čiara, predvolená) a "ideographic" (dolná ideografická základná čiara). Iné reťazce sa ignorujú. Vodorovné zarovnanie sa nastavuje samostatne cez textAlign.

Prí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ýsledok

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

Uložte príklad ako súbor HTML, otvorte ho v prehliadači a pozrite sa do vývojárskej konzoly. Prvý riadok zobrazuje hodnoty piatich vlastností kontextu pred volaním `restore()`. Hrúbka zostane `4` napriek priradeniu `0`. Z piatich vypísaných vlastností používa `strokeRect()` na obrys obdĺžnika `lineWidth` a `strokeStyle`, zatiaľ čo `fillText()` používa `fillStyle`, `font` a `textBaseline`. Druhý riadok ukazuje obnovené počiatočné hodnoty. Svetlomodrý obdĺžnik s modrým obrysom a tmavým textom zostáva viditeľný.

Súvisiace lekcie

  • JavaScript · Lekcia 26 · Stredne pokročilá · Verzia: 3

Zdroje