300 feature support select cell range

common/changes/@visactor/vtable/300-feature-support-select-cell-range_2023-09-11-02-57.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "feat: add api selectCells #300\n\n",
+      "type": "patch",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "892739385@qq.com"
+}

docs/assets/api/en/event/event.md

@@ -313,6 +313,15 @@ Legend item hover to unhover events. **Legend exclusive event**
 
 The parameter type of the event callback function:
 
+```
+   { model: any; value: any; event: PointerEvent };
+```
+## LEGEND_CHANGE
+
+Color legend, size legend, this event is triggered after the user operates the legend range. **Legend exclusive event**
+
+Parameter types of event callback function:
+
 ```
    { model: any; value: any; event: PointerEvent };
 ```

docs/assets/api/en/methods.md

@@ -116,6 +116,31 @@ Listen to VChart chart events
 
 Unlisten to VChart chart events
 
+## selectCell(Function)
+
+Select a cell
+
+```
+  /**
+   * The effect of selecting a cell is the same as that of a cell selected by the mouse.
+   * @param col
+   * @param row
+   */
+  selectCell(col: number, row: number): void
+```
+
+## selectCells(Function)
+
+Select one or more cell ranges
+
+```
+  /**
+   * Select a cell area, and you can set multiple areas to be selected at the same time
+   * @param cellRanges: CellRange[]
+   */
+  selectCells(cellRanges: CellRange[]): void
+```
+
 ## getCellStyle(Function)
 
 Getting the style of a cell

docs/assets/api/zh/event/event.md

@@ -342,6 +342,15 @@ icon 图标点击事件。
    { model: any; value: any; event: PointerEvent };
 ```
 
+## LEGEND_CHANGE
+
+颜色图例，尺寸图例，用户操作图例范围后触发该事件。**图例专有事件**
+
+事件回调函数的参数类型:
+
+```
+   { model: any; value: any; event: PointerEvent };
+```
 ## MOUSEENTER_AXIS
 
 鼠标进入到坐标轴上事件。**坐标轴专有事件**

docs/assets/api/zh/methods.md

@@ -114,6 +114,30 @@ tableInstance.renderWithRecreateCells();
 ## offVChartEvent(Function)
 
 解除监听 VChart 图表事件
+## selectCell(Function)
+
+选中某个单元格
+
+```
+  /**
+   * 选中单元格  和鼠标选中单元格效果一致
+   * @param col
+   * @param row
+   */
+  selectCell(col: number, row: number): void
+```
+
+## selectCells(Function)
+
+选中一个或者多个单元格区域
+
+```
+  /**
+   * 选中单元格区域，可设置多个区域同时选中
+   * @param cellRanges: CellRange[]
+   */
+  selectCells(cellRanges: CellRange[]): void
+```
 
 ## getCellStyle(Function)
 

docs/assets/examples/menu.json

@@ -751,6 +751,38 @@
             "link": "",
             "option": ""
           }
+        },
+        {
+          "path": "legend-color",
+          "title": {
+            "zh": "颜色图例",
+            "en": "legend-color"
+          },
+          "meta": {
+            "title": "color legend",
+            "keywords": "",
+            "category": "examples",
+            "group": "Component",
+            "cover": "https://lf9-dp-fe-cms-tos.byteorg.com/obj/bit-cloud/VTable/preview/color-legend.png",
+            "link": "",
+            "option": ""
+          }
+        },
+        {
+          "path": "legend-size",
+          "title": {
+            "zh": "尺寸图例",
+            "en": "legend-size"
+          },
+          "meta": {
+            "title": "size legend",
+            "keywords": "",
+            "category": "examples",
+            "group": "Component",
+            "cover": "https://lf9-dp-fe-cms-tos.byteorg.com/obj/bit-cloud/VTable/preview/size-legend.png",
+            "link": "",
+            "option": ""
+          }
         }
       ]
     },