Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła