База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Canvas 2D: стил на запълване, стил на контур и дебелина на линията

`fillStyle` определя запълването, `strokeStyle` — вида на контура, а `lineWidth` — дебелината му. Това са три отделни свойства на състоянието за рисуване в Canvas 2D.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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 и lineWidth са свойства на екземпляр на контекст Canvas 2D, например ctx, получен чрез canvas.getContext("2d"). Те са част от API на уеб платформата, а не от ECMAScript, затова не са налични във всяка среда за изпълнение на JavaScript. Самото присвояване не рисува нищо.

fillStyle задава запълването за fill(), fillRect() и fillText(). strokeStyle задава стила на контура за stroke(), strokeRect() и strokeText(). И двата стила първоначално са черни и приемат низ с цвят в CSS, обект CanvasGradient или CanvasPattern. Невалиден низ за цвят оставя предишната стойност непроменена. При прочитане се връща сериализираният цвят (не непременно първоначалният низ) или присвоеният обект. Промените в този обект влияят на следващите операции по рисуване.

lineWidth определя пълната дебелина на контура в единици от координатната система, не непременно в екранни пиксели. Контурът е центриран спрямо пътя, а мащабирането на контекста може да промени видимата му дебелина. Началната стойност е 1. Задай крайно число, по-голямо от нула: 0, отрицателните числа, Infinity, -Infinity и NaN се игнорират.

Свойствата важат за следващите операции по рисуване, докато не се променят или докато състоянието не бъде възстановено или върнато към началните стойности. save() и restore() запазват и възстановяват състоянието за рисуване, но не текущия път или пикселите. Присвояването на шарка от изображение с друг произход без разрешение чрез CORS може да блокира четенето на пикселите: тогава getImageData() хвърля SecurityError.

Примери

<!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>

Резултат

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

Запази примера като HTML файл и го отвори в браузър. Кодът не добавя платното към страницата, а извежда в конзолата на браузъра дебелината и стойностите RGBA в запълнената област, върху контура и извън рисунката. Присвояването на `0` оставя дебелината `6`.

Свързани уроци

  • JavaScript · Урок 12 · Напреднало · Версия: 4

Източници