如何使用 FabricJS 移动 IText 中单个字符的基线?

fabricjsjavascripthtml5 canvas更新于 2025/4/24 4:28:17

在本教程中，我们将学习如何使用 FabricJS 移动 IText 中单个字符的基线。IText 类是在 FabricJS 版本 1.4 中引入的，扩展了 fabric.Text 并用于创建 IText 实例。IText 实例让我们可以自由地选择、剪切、粘贴或添加新文本，而无需进行其他配置。还有各种支持的按键组合和鼠标/触摸组合，这些组合使文本具有交互性，而 Text 中没有提供这些功能。

但是，基于 IText 的文本框允许我们调整文本矩形的大小并自动换行。对于 IText 来说，情况并非如此，因为高度不会根据换行进行调整。我们可以使用各种属性来操纵我们的 IText 对象。同样，我们也可以使用 deltaY 属性来移动单个字符的基线。

语法

new fabric.IText(text: String , { style: { deltaY: Number }:Object }: Object)

参数

text − 此参数接受 String，即我们要显示的文本字符串。
options (可选) − 此参数是一个对象，它为我们的 IText 对象提供额外的自定义。使用此参数，可以更改与样式属性相关的对象的颜色、光标、边框宽度和许多其他属性。

选项键

styles - 此属性接受 Object 值，允许我们向单个字符添加样式。
deltaY - 此属性接受 Number 值，允许我们仅为样式移动基线。

示例 1

仅将样式属性作为键传递

在此示例中，我们可以看到如何使用样式属性向字符添加单个样式。正如我们在此示例中所看到的，只有第 0 个字符的 fontSize 为 55、fontWeight 为粗体和 fontStyle 为"oblique"。第一级属性是行号，第二级属性是字符数。这里我们对两者都使用 0，表示第一行和第一个字符。


<!DOCTYPE html>
<html>
<head>
   <!-- Adding the Fabric JS Library-->
   <script src="https://cdnjs.cloudflare.com/ajax/libs/fabric.js/510/fabric.min.js"></script>
</head>
<body>
   <h2>Passing only the styles property as key</h2>
   <p>You can see that the first character looks different now</p>
   <canvas id="canvas"></canvas>
   
   <script>
      // 启动一个canvas实例
      var canvas = new fabric.Canvas("canvas");
      canvas.setWidth(document.body.scrollWidth);
      canvas.setHeight(250);

      // 启动一个 itext 对象
      var itext = new fabric.IText("Add sample text here.", {
         width: 300,
         left: 310,
         top: 70,
         fill: "#9455da",
         styles: {
            0: {
               0: {
                  fontSize: 55,
                  fontWeight: "bold",
                  fontStyle: "oblique",
               },
            },
         },
      });

      // 将其添加到画布
      canvas.add(itext);
   </script>
</body>
</html>

示例 2

将样式属性作为键与 deltaY 属性一起传递

在此示例中，我们将了解如何使用 deltaY 属性为字符添加不同的基线。在这种情况下，由于指定了 deltaY，第二行(第一个索引)中的第二个数字(第一个索引)与其相邻字符的基线不同。


<!DOCTYPE html>
<html>
<head>
   <!-- Adding the Fabric JS Library-->
   <script src="https://cdnjs.cloudflare.com/ajax/libs/fabric.js/510/fabric.min.js"></script>
</head>
<body>
   <h2>Passing the styles property as key along with deltaY property</h2>
   <p>You can see that the second number in the second line has a different baseline</p>
   <canvas id="canvas"></canvas>

   <script>
      // 启动一个canvas实例
      var canvas = new fabric.Canvas("canvas");
      canvas.setWidth(document.body.scrollWidth);
      canvas.setHeight(250);

      // 启动一个 itext 对象
      var itext = new fabric.IText("Add sample text here.
H2O", {
         width: 300,
         left: 310,
         top: 70,
         fill: "#9455da",
         styles: {
            1: {
               0: {
                  fontSize: 55,
                  fontWeight: "bold",
                  fill: "red",
               },
               1: {
                  deltaY: 15,
                  fill: "blue",
               },
               2: {
                  fontSize: 55,
                  fontWeight: "bold",
                  fill: "red",
               },
            },
         },
      });

      // 将其添加到画布
      canvas.add(itext);
   </script>
</body>
</html>