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 unitsfillStyle, 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