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

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

Източници