CKTIS / JavaScript
Canvas 2D: obris, polnilo, pisava in osnovnica
Nastavite debelino in slog obrisa, slog polnila, pisavo in navpično referenčno točko besedila v kontekstu Canvas 2D.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 in textBaseline so lastnosti konteksta, ki ga vrne canvas.getContext("2d"), ne pa samega elementa canvas. Spadajo v spletni API, ne v ECMAScript. Razpoložljivost je odvisna od izvajalnega okolja, getContext() pa lahko vrne null. Prireditve spremenijo stanje za naslednje risanje, ne že narisanih slikovnih pik. save() shrani stanje, restore() pa ga obnovi, ne da bi razveljavil risbo ali spremembe trenutne poti.
lineWidth določa debelino obrisa v enotah koordinatnega sistema platna. Sprememba merila lahko spremeni vidno debelino. Poteza je sredinsko poravnana s potjo. Začetna vrednost je 1. Ničla, negativna števila, Infinity, -Infinity in NaN se prezrejo.
strokeStyle določa slog obrisa, na primer pri strokeRect() in strokeText(). fillStyle določa slog polnila, na primer pri fillRect() in fillText(). Obe lastnosti sprejmeta niz z barvo CSS, objekt CanvasGradient ali objekt CanvasPattern. Začetna barva obeh je črna. Neveljaven barvni niz ohrani prejšnjo vrednost.
font sprejme niz v skrajšani sintaksi lastnosti CSS font, na primer "bold 20px sans-serif". Začetna vrednost je "10px sans-serif". Neveljavni nizi se prezrejo, line-height pa tu nima učinka. Če pisava ni na voljo ali še ni naložena, brskalnik uporabi nadomestno pisavo; videz glifov se lahko med okolji razlikuje.
textBaseline izbere navpično referenco, ki jo fillText() in strokeText() postavita na koordinato y. "top", "middle" in "bottom" označujejo vrh, sredino in dno kvadrata em pisave, ne robov vidnih glifov. Druge možnosti so "hanging" (viseča osnovnica), "alphabetic" (abecedna osnovnica, privzeta) in "ideographic" (spodnja ideografska osnovnica). Drugi nizi se prezrejo. Vodoravna poravnava se nastavi ločeno z textAlign.
Primeri
<!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>Rezultat
4 | #1d4ed8 | #172554 | 20px sans-serif | top 1 | #000000 | #000000 | 10px sans-serif | alphabetic
Shranite primer kot datoteko HTML, odprite jo v brskalniku in preverite razvojno konzolo. Prva vrstica izpiše vrednosti petih lastnosti konteksta pred klicem `restore()`. Debelina ostane `4` kljub prireditvi `0`. Od petih izpisanih lastnosti `strokeRect()` za obris pravokotnika uporabi `lineWidth` in `strokeStyle`, `fillText()` pa uporabi `fillStyle`, `font` in `textBaseline`. Druga vrstica izpiše obnovljene začetne vrednosti. Svetlo moder pravokotnik z modrim obrisom in temnim besedilom ostane viden.
Povezane lekcije
- JavaScript · Lekcija 26 · Srednja · Različica: 3