feat: add executeLocationArea api #940

docs/en/guide/command-execute.md

@@ -1051,3 +1051,13 @@ Usage:
 ```javascript
 instance.command.executeSetAreaProperties(payload: ISetAreaPropertiesOption)
 ```
+
+## executeLocationArea
+
+Feature: positioning area position
+
+Usage:
+
+```javascript
+instance.command.executeLocationArea(areaId: string)
+```

docs/guide/command-execute.md

@@ -1047,3 +1047,11 @@ const areaId = instance.command.executeInsertArea(payload: IInsertAreaOption)
 ```js
 instance.command.executeSetAreaProperties(payload: ISetAreaPropertiesOption)
 ```
+
+## executeLocationArea
+
+功能：定位区域位置
+
+```js
+instance.command.executeLocationArea(areaId: string)
+```

src/editor/core/command/Command.ts

@@ -83,6 +83,7 @@ export class Command {
   public executeInsertElementList: CommandAdapt['insertElementList']
   public executeInsertArea: CommandAdapt['insertArea']
   public executeSetAreaProperties: CommandAdapt['setAreaProperties']
+  public executeLocationArea: CommandAdapt['locationArea']
   public executeAppendElementList: CommandAdapt['appendElementList']
   public executeUpdateElementById: CommandAdapt['updateElementById']
   public executeSetValue: CommandAdapt['setValue']
@@ -224,6 +225,7 @@ export class Command {
     this.getAreaValue = adapt.getAreaValue.bind(adapt)
     this.executeInsertArea = adapt.insertArea.bind(adapt)
     this.executeSetAreaProperties = adapt.setAreaProperties.bind(adapt)
+    this.executeLocationArea = adapt.locationArea.bind(adapt)
     // 通用
     this.executeInsertElementList = adapt.insertElementList.bind(adapt)
     this.executeAppendElementList = adapt.appendElementList.bind(adapt)

src/editor/core/command/CommandAdapt.ts

@@ -2297,4 +2297,32 @@ export class CommandAdapt {
   public setAreaProperties(payload: ISetAreaPropertiesOption) {
     this.draw.getArea().setAreaProperties(payload)
   }
+
+  public locationArea(areaId: string) {
+    const context = this.draw.getArea().getContextByAreaId(areaId)
+    if (!context) return
+    const {
+      range: { endIndex },
+      elementPosition
+    } = context
+    this.position.setPositionContext({
+      isTable: false
+    })
+    this.range.setRange(endIndex, endIndex)
+    this.draw.render({
+      isSetCursor: false,
+      isCompute: false,
+      isSubmitHistory: false
+    })
+    // 移动到可见区域
+    const cursor = this.draw.getCursor()
+    this.position.setCursorPosition(elementPosition)
+    cursor.drawCursor({
+      hitLineStartIndex: endIndex
+    })
+    cursor.moveCursorToVisible({
+      cursorPosition: elementPosition,
+      direction: MoveDirection.UP
+    })
+  }
 }

src/editor/core/draw/interactive/Area.ts

@@ -15,6 +15,8 @@ import { Zone } from '../../zone/Zone'
 import { Position } from '../../position/Position'
 import { zipElementList } from '../../../utils/element'
 import { AreaMode } from '../../../dataset/enum/Area'
+import { IRange } from '../../../interface/Range'
+import { IElementPosition } from '../../../interface/Element'
 
 export class Area {
   private draw: Draw
@@ -165,6 +167,26 @@ export class Area {
     }
   }
 
+  public getContextByAreaId(
+    areaId: string
+  ): { range: IRange; elementPosition: IElementPosition } | null {
+    const elementList = this.draw.getOriginalMainElementList()
+    for (let e = 0; e < elementList.length; e++) {
+      const element = elementList[e]
+      if (element.areaId === areaId) {
+        const positionList = this.position.getOriginalMainPositionList()
+        return {
+          range: {
+            startIndex: e,
+            endIndex: e
+          },
+          elementPosition: positionList[e]
+        }
+      }
+    }
+    return null
+  }
+
   public setAreaProperties(payload: ISetAreaPropertiesOption) {
     const areaId = payload.id || this.getActiveAreaId()
     if (!areaId) return

src/editor/utils/element.ts

@@ -164,7 +164,7 @@ export function formatElementList(
       const valueList = el?.valueList || []
       formatElementList(valueList, {
         ...options,
-        isHandleFirstElement: false,
+        isHandleFirstElement: true,
         isForceCompensation: false
       })
       if (valueList.length) {