如何在 FabricJS 中仅当对象完全包含在选择区域中时才启用对象选择?

fabricjsjavascripthtml5 canvas更新于 2025/1/28 5:00:17

在本文中，我们将学习如何使用 FabricJS 仅当对象完全包含在选择区域中时才启用对象选择。我们可以使用 choiceFullyContained 属性来实现这一点。

语法

new fabric.Canvas(element: HTMLElement|String, { choiceFullyContained: Boolean }: Object)

参数

element − 此参数是 <canvas> 元素本身，可以使用 Document.getElementById() 或 <canvas> 元素本身的 id 派生。 FabricJS 画布将在此元素上初始化。
选项(可选) − 此参数是一个对象，它为我们的画布提供额外的自定义。使用此参数，可以更改与画布相关的属性(例如颜色、光标、边框宽度和许多其他属性)，其中selectionFullyContained 是一个属性。它接受一个布尔值，该值确定是否仅当对象完全包含在选择区域中时才应选择该对象。它的默认值为 False。

示例 1

传递具有 False 值的selectionFullyContained键

让我们看一个 FabricJS 中默认行为的代码示例，即尽管对象未完全包含在选择区域中，但仍被选中。在此示例中，我们将selectionFullyContained的值传递为False。

<!DOCTYPE html>
<html>
<head>
   <!-- 添加 Fabric JS 库-->
   <script src="https://cdnjs.cloudflare.com/ajax/libs/fabric.js/510/fabric.min.js"></script>
</head>
<body>
   <h2>仅当对象完全包含在选择区域中时才启用对对象的选择</h2>
   <p>选择对象周围的部分区域。即使选择包含对象的部分区域，也会选择整个对象。</p>
   <canvas id="canvas"></canvas>
   <script>
      // 启动一个canvas实例
      var canvas = new fabric.Canvas("canvas", {
         selectionFullyContained: false
      });
      // 创建 fabric.Rect 类的实例
      var circle = new fabric.Circle({
         left: 215,
         top: 100,
         radius: 50,
         fill: "orange",
      });
      // 将其添加到画布
      canvas.add(circle);
      canvas.setWidth(document.body.scrollWidth);
      canvas.setHeight(250);
   </script>
</body>
</html>

示例 2

将selectionFullyContained键传递给值为True的类

让我们看一个代码示例，其中selectionFullyContained属性的值已设置为True。我们可以看到，只有当对象完全包含在选择区域中时，才会选择该对象。

<!DOCTYPE html>
<html>
<head>
   <!-- 添加Fabric JS库-->
   <script src="https://cdnjs.cloudflare.com/ajax/libs/fabric.js/510/fabric.min.js"></script>
</head>
<body>
   <h2>仅当对象完全包含在选择区域中时才允许选择对象</h2>
   <p>此处您无法通过选择对象周围的部分区域来选择对象。对象必须完全包含在选择区域内。</p>
   <canvas id="canvas"></canvas>
   <script>
      // 启动一个canvas实例
      var canvas = new fabric.Canvas("canvas", {
         selectionFullyContained: true
      });
      // 创建 fabric.Rect 类的实例
      var circle = new fabric.Circle({
         left: 215,
         top: 100,
         radius: 50,
         fill: "orange"
      });
      // 将其添加到画布
      canvas.add(circle);
      canvas.setWidth(document.body.scrollWidth);
      canvas.setHeight(250);
   </script>
</body>
</html>