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