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