Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Canvas 2D: styl wypełnienia, styl obrysu i grubość linii

`fillStyle` określa wygląd wnętrza kształtu, `strokeStyle` wygląd obrysu, a `lineWidth` jego grubość. Te niezależne właściwości należą do stanu kontekstu Canvas 2D.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

ctx.fillStyle = paint;
ctx.strokeStyle = paint;
ctx.lineWidth = width;
// paint: CSS color string, CanvasGradient, or CanvasPattern
// width: finite number greater than 0, in canvas coordinate-space units

fillStyle, strokeStyle i lineWidth to właściwości instancji kontekstu Canvas 2D, np. ctx uzyskanego przez canvas.getContext("2d"). Są częścią API platformy webowej, a nie ECMAScript; nie każde środowisko JavaScript je udostępnia. Samo przypisanie niczego nie rysuje.

fillStyle określa wygląd wypełnienia przy fill(), fillRect() i fillText(). strokeStyle określa wygląd obrysu przy stroke(), strokeRect() i strokeText(). Oba style są początkowo czarne i przyjmują kolor CSS zapisany jako tekst, obiekt CanvasGradient lub CanvasPattern. Niepoprawny zapis koloru pozostawia poprzednią wartość. Odczyt zwraca serializację koloru (niekoniecznie wpisany tekst) albo przypisany obiekt. Zmiany tego obiektu wpływają na kolejne operacje rysowania.

lineWidth określa pełną grubość obrysu w jednostkach układu współrzędnych, niekoniecznie w pikselach ekranu. Obrys jest wyśrodkowany względem ścieżki, a skalowanie kontekstu może zmienić jego widoczną grubość. Wartość początkowa to 1. Ustawiaj skończoną liczbę większą od zera: 0, liczby ujemne, Infinity, -Infinity i NaN są ignorowane.

Właściwości obowiązują przy kolejnych operacjach rysowania, aż je zmienisz lub stan zostanie przywrócony bądź zresetowany. save() i restore() zapisują i przywracają stan rysowania, ale nie bieżącą ścieżkę ani piksele. Przypisanie wzoru z obrazu z innego źródła bez zgody CORS może zablokować odczyt pikseli: getImageData() zgłosi wtedy SecurityError.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D fill and stroke</title>
<script>
(() => {
  const canvas = document.createElement("canvas");
  canvas.width = canvas.height = 32;
  const ctx = canvas.getContext("2d");
  if (!ctx) throw new Error("Canvas 2D is unavailable");

  ctx.fillStyle = "#ff0000";
  ctx.strokeStyle = "#0000ff";
  ctx.lineWidth = 6;
  ctx.lineWidth = 0;
  ctx.fillRect(8, 8, 16, 16);
  ctx.strokeRect(8, 8, 16, 16);

  const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(", ");
  console.log(`width: ${ctx.lineWidth}`);
  console.log(`fill: ${rgba(16, 16)}`);
  console.log(`stroke: ${rgba(6, 16)}`);
  console.log(`outside: ${rgba(2, 16)}`);
})();
</script>

Wynik

width: 6
fill: 255, 0, 0, 255
stroke: 0, 0, 255, 255
outside: 0, 0, 0, 0

Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Kod nie dołącza płótna do strony: w konsoli przeglądarki wypisuje grubość oraz wartości RGBA wewnątrz wypełnienia, na obrysie i poza rysunkiem. Przypisanie `0` nie zmienia grubości `6`.

Powiązane lekcje

  • JavaScript · Lekcja 12 · Zaawansowany · Wersja: 4

Źródła