clickgo 5.12.0 → 5.12.1

package/dist/lib/control.d.ts

@@ -678,6 +678,14 @@ export interface IStepClickedEvent {
         'label': string;
     };
 }
+export interface IFabricLayerchangeEvent {
+    'detail': {
+        /** --- 图层变更前的 name 属性值 --- */
+        'prev': string;
+        /** --- 图层变更后的 name 属性值 --- */
+        'next': string;
+    };
+}
 export interface IObjviewerLine {
     /** -- 可自定义线段的名称 --- */
     'name'?: string;

package/doc/clickgo-rag.md

@@ -1891,7 +1891,7 @@ ECharts 配置选项。
 ## fabric
 ---
 
-封装了 fabric.js 画布，可以对画布上元素进行拖拽、旋转、缩放。
+封装了 fabric.js 画布，可以对画布上元素进行拖拽、旋转、缩放，并支持仿 PS 的图层选择模式。
 
 ### 参数
 
@@ -1899,7 +1899,31 @@ ECharts 配置选项。
 
 `boolean` | `string`
 
-禁用画布交互
+禁用画布交互。
+
+#### autoLayer
+
+`boolean` | `string`
+
+是否允许点击画布对象自动切换激活图层，默认为 `true`。关闭后只有通过 `layer` 属性手动指定的对象才能响应鼠标事件，其他对象完全穿透。
+
+#### transform
+
+`boolean` | `string`
+
+是否显示控制点（自由变换句柄，即缩放/旋转手柄），默认为 `true`。关闭后激活对象仍可拖动，但不能通过控制点进行缩放和旋转。
+
+#### layer
+
+`string`
+
+双向绑定当前激活图层的标识，值为 fabric 对象的 `name` 属性值，无选中时为空字符串。`autoLayer` 为 `false` 时可通过此属性从外部手动切换激活图层。
+
+#### selector
+
+`boolean` | `string`
+
+是否显示框选矩形（拖拽空白区域来多选对象的虚线选框），默认为 `true`。
 
 ### 事件
 
@@ -1907,7 +1931,13 @@ ECharts 配置选项。
 
 `(canvas: fabric.Canvas) => void`
 
-加载成功并初始化 fabric js 的 canvas 对象后触发，利用此抛出对象可执行原生的所有绘图和操作方法。
+加载成功并初始化 fabric.js Canvas 对象后触发，可通过此对象调用所有原生 API。
+
+#### layerchange
+
+`(event: { detail: { prev: string; next: string } }) => void`
+
+激活图层变更时触发（仅 `autoLayer` 为 `true` 时）。`event.detail.prev` 为变更前的图层 name，`event.detail.next` 为变更后的图层 name，取消选中时为空字符串。多选状态下 `event.detail.next` 同样为空字符串。
 
 ### 方法
 
@@ -1924,7 +1954,17 @@ ECharts 配置选项。
 ## 示例
 
 ```xml
-<fabric @init="init"></fabric>
+<!-- 默认：自动切换图层 + 显示控制点 -->
+<fabric v-model:layer="activeLayer" @init="init" @layerchange="onLayerChange"></fabric>
+
+<!-- 仿 PS 普通模式：自动切换图层，但不显示控制点（只能拖动） -->
+<fabric :transform="false" v-model:layer="activeLayer" @init="init" @layerchange="onLayerChange"></fabric>
+
+<!-- 手动指定图层（外部面板切换），显示控制点 -->
+<fabric :auto-layer="false" :layer="activeLayer" @init="init"></fabric>
+
+<!-- 关闭框选矩形 -->
+<fabric :selector="false" @init="init"></fabric>
 ```
 
 
@@ -9751,6 +9791,7 @@ lib/control/index.md
 - [IDatepanelChangedEvent](interfaces/IDatepanelChangedEvent.md)
 - [IDatepanelRangeEvent](interfaces/IDatepanelRangeEvent.md)
 - [IDatepanelSelectedEvent](interfaces/IDatepanelSelectedEvent.md)
+- [IFabricLayerchangeEvent](interfaces/IFabricLayerchangeEvent.md)
 - [IFormCloseEvent](interfaces/IFormCloseEvent.md)
 - [IFormMaxEvent](interfaces/IFormMaxEvent.md)
 - [IFormMinEvent](interfaces/IFormMinEvent.md)
@@ -10582,6 +10623,39 @@ Defined in: [lib/control.ts:981](https://github.com/maiyun/clickgo/blob/master/d
 
 > **year**: `number`
 
+lib/control/interfaces/IFabricLayerchangeEvent.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IFabricLayerchangeEvent
+
+# Interface: IFabricLayerchangeEvent
+
+Defined in: [lib/control.ts:1487](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1487)
+
+## Properties
+
+### detail
+
+> **detail**: `object`
+
+Defined in: [lib/control.ts:1488](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1488)
+
+#### next
+
+> **next**: `string`
+
+图层变更后的 name 属性值
+
+#### prev
+
+> **prev**: `string`
+
+图层变更前的 name 属性值
+
 lib/control/interfaces/IFormCloseEvent.md
 ---
 
@@ -11937,7 +12011,7 @@ lib/control/interfaces/IObjviewerLine.md
 
 # Interface: IObjviewerLine
 
-Defined in: [lib/control.ts:1487](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1487)
+Defined in: [lib/control.ts:1498](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1498)
 
 ## Properties
 
@@ -11945,7 +12019,7 @@ Defined in: [lib/control.ts:1487](https://github.com/maiyun/clickgo/blob/master/
 
 > **end**: [`IObjviewerLineObj`](IObjviewerLineObj.md)
 
-Defined in: [lib/control.ts:1491](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1491)
+Defined in: [lib/control.ts:1502](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1502)
 
 ***
 
@@ -11953,7 +12027,7 @@ Defined in: [lib/control.ts:1491](https://github.com/maiyun/clickgo/blob/master/
 
 > `optional` **hue**: `string`
 
-Defined in: [lib/control.ts:1493](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1493)
+Defined in: [lib/control.ts:1504](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1504)
 
 默认 255
 
@@ -11963,7 +12037,7 @@ Defined in: [lib/control.ts:1493](https://github.com/maiyun/clickgo/blob/master/
 
 > `optional` **name**: `string`
 
-Defined in: [lib/control.ts:1489](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1489)
+Defined in: [lib/control.ts:1500](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1500)
 
 -- 可自定义线段的名称
 
@@ -11973,7 +12047,7 @@ Defined in: [lib/control.ts:1489](https://github.com/maiyun/clickgo/blob/master/
 
 > `optional` **path**: `string`
 
-Defined in: [lib/control.ts:1494](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1494)
+Defined in: [lib/control.ts:1505](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1505)
 
 ***
 
@@ -11981,7 +12055,7 @@ Defined in: [lib/control.ts:1494](https://github.com/maiyun/clickgo/blob/master/
 
 > **start**: [`IObjviewerLineObj`](IObjviewerLineObj.md)
 
-Defined in: [lib/control.ts:1490](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1490)
+Defined in: [lib/control.ts:1501](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1501)
 
 ***
 
@@ -11989,7 +12063,7 @@ Defined in: [lib/control.ts:1490](https://github.com/maiyun/clickgo/blob/master/
 
 > `optional` **stroke**: `"down"` \| `"solid"` \| `"dashed"` \| `"up"`
 
-Defined in: [lib/control.ts:1496](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1496)
+Defined in: [lib/control.ts:1507](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1507)
 
 默认 solid
 
@@ -12004,7 +12078,7 @@ lib/control/interfaces/IObjviewerLineObj.md
 
 # Interface: IObjviewerLineObj
 
-Defined in: [lib/control.ts:1499](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1499)
+Defined in: [lib/control.ts:1510](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1510)
 
 ## Properties
 
@@ -12012,7 +12086,7 @@ Defined in: [lib/control.ts:1499](https://github.com/maiyun/clickgo/blob/master/
 
 > **obj**: `HTMLElement` \| [`AbstractControl`](../classes/AbstractControl.md)
 
-Defined in: [lib/control.ts:1500](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1500)
+Defined in: [lib/control.ts:1511](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1511)
 
 ***
 
@@ -12020,7 +12094,7 @@ Defined in: [lib/control.ts:1500](https://github.com/maiyun/clickgo/blob/master/
 
 > **pos**: `"b"` \| `"tr"` \| `"lt"` \| `"t"` \| `"r"` \| `"rb"` \| `"bl"` \| `"l"`
 
-Defined in: [lib/control.ts:1501](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1501)
+Defined in: [lib/control.ts:1512](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1512)
 
 lib/control/interfaces/IPaletteChangedEvent.md
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickgo",
-  "version": "5.12.0",
+  "version": "5.12.1",
   "description": "Background interface, software interface, mobile phone APP interface operation library.",
   "type": "module",
   "keywords": [