CKTIS / JavaScript
Canvas 2D: контур, запълване, шрифт и базова линия
Задайте дебелината и стила на контура, запълването, шрифта и вертикалната опорна точка за текст в контекст Canvas 2D.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
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 и textBaseline са свойства на контекста, върнат от canvas.getContext("2d"), а не на самия елемент canvas. Те са част от уеб API, а не от ECMAScript. Наличността им зависи от средата за изпълнение, а getContext() може да върне null. Присвояването променя състоянието за следващите операции по рисуване, а не вече нарисуваните пиксели. save() запазва състоянието, а restore() го възстановява, без да отменя нарисуваното или промените в текущия път.
lineWidth задава дебелината на контура в единици от координатната система на платното. Мащабираща трансформация може да промени видимата дебелина. Контурът е центриран върху пътя. Началната стойност е 1. Нула, отрицателни числа, Infinity, -Infinity и NaN се игнорират.
strokeStyle задава стила на контура, например при strokeRect() и strokeText(). fillStyle задава стила на запълването, например при fillRect() и fillText(). И двете свойства приемат низ с CSS цвят, обект CanvasGradient или обект CanvasPattern. Началният цвят и за двете е черен. Невалиден низ за цвят оставя предишната стойност непроменена.
font приема низ в съкратения синтаксис на CSS свойството font, например "bold 20px sans-serif". Началната стойност е "10px sans-serif". Невалидните низове се игнорират, а line-height няма ефект тук. Ако шрифтът не е наличен или още не е зареден, браузърът използва друг; видът на глифовете може да се различава между средите.
textBaseline избира вертикалната опорна точка, която fillText() и strokeText() поставят на координатата y. "top", "middle" и "bottom" означават горния ръб, средата и долния ръб на em-квадрата на шрифта, а не границите на видимите глифове. Другите възможности са "hanging" (висяща базова линия), "alphabetic" (азбучна базова линия, по подразбиране) и "ideographic" (долна идеографска базова линия). Други низове се игнорират. Хоризонталното подравняване се задава отделно с textAlign.
Примери
<!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>Резултат
4 | #1d4ed8 | #172554 | 20px sans-serif | top 1 | #000000 | #000000 | 10px sans-serif | alphabetic
Запазете примера като HTML файл, отворете го в браузър и проверете конзолата за разработчици. Първият ред показва стойностите на пет свойства на контекста преди извикването на `restore()`. Дебелината остава `4` въпреки присвояването на `0`. От петте изведени свойства `strokeRect()` използва `lineWidth` и `strokeStyle` за контура на правоъгълника, а `fillText()` използва `fillStyle`, `font` и `textBaseline`. Вторият ред показва възстановените начални стойности. Светлосиният правоъгълник със син контур и тъмен текст остава видим.
Свързани уроци
- JavaScript · Урок 26 · Средно · Версия: 3