CKTIS / JavaScript
Canvas 2D: obrys, wypełnienie, font i linia bazowa
Ustaw grubość i styl obrysu, styl wypełnienia, font oraz pionowy punkt odniesienia tekstu w kontekście Canvas 2D.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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 i textBaseline to właściwości kontekstu zwracanego przez canvas.getContext("2d"), a nie samego elementu canvas. Należą do Web API, nie do ECMAScript; dostępność zależy od środowiska, a getContext() może zwrócić null. Przypisanie zmienia stan kolejnych operacji rysowania, nie gotowe piksele. save() zapisuje stan, a restore() go przywraca, nie cofając rysunku ani zmian bieżącej ścieżki.
lineWidth określa grubość obrysu w jednostkach układu współrzędnych canvas; transformacja skalująca może zmienić widoczną grubość. Obrys jest wyśrodkowany względem ścieżki. Wartość początkowa to 1. Zero, liczby ujemne, Infinity, -Infinity i NaN są ignorowane.
strokeStyle określa styl obrysu, np. dla strokeRect() i strokeText(), a fillStyle określa styl wypełnienia, np. dla fillRect() i fillText(). Obie właściwości przyjmują ciąg z kolorem CSS, obiekt CanvasGradient lub CanvasPattern. Początkowo obie mają kolor czarny. Niepoprawny ciąg koloru pozostawia poprzednią wartość.
font przyjmuje ciąg w składni skróconej właściwości CSS font, np. "bold 20px sans-serif". Wartość początkowa to "10px sans-serif". Niepoprawne ciągi są ignorowane, a ustawienie line-height nie ma tu zastosowania. Jeśli font jest niedostępny lub jeszcze się nie załadował, przeglądarka dobierze zastępczy; wygląd glifów może się różnić między środowiskami.
textBaseline wybiera pionowy punkt odniesienia, który fillText() i strokeText() umieszczają na współrzędnej y. "top", "middle" i "bottom" oznaczają górę, środek i dół pola em fontu, a nie granice widocznych glifów. Pozostałe opcje to "hanging" (linia wisząca), "alphabetic" (linia alfabetyczna, domyślna) i "ideographic" (dolna linia ideograficzna). Inne ciągi są ignorowane. Wyrównanie poziome ustawia osobna właściwość textAlign.
Przykłady
<!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>Wynik
4 | #1d4ed8 | #172554 | 20px sans-serif | top 1 | #000000 | #000000 | 10px sans-serif | alphabetic
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź konsolę deweloperską. Pierwszy wiersz pokazuje stan pięciu właściwości kontekstu przed `restore()`. Grubość pozostaje równa `4` mimo przypisania `0`. `strokeRect()` używa `lineWidth` i `strokeStyle` do obrysu prostokąta. Z pięciu wypisanych właściwości `fillText()` korzysta tylko z `fillStyle`, `font` i `textBaseline`. Drugi wiersz pokazuje przywrócone wartości początkowe. Jasnoniebieski prostokąt z niebieskim obrysem i ciemnym tekstem pozostaje widoczny.
Powiązane lekcje
- JavaScript · Lekcja 26 · Średniozaawansowany · Wersja: 3