From 0bf580ed444a3cbf6615fbc204bffb656a6651eb Mon Sep 17 00:00:00 2001
From: "X.Mo" <root@imoi.cn>
Date: Sun, 3 Nov 2024 15:21:19 +0800
Subject: [PATCH] feat: ma-pro-table

---
 .vitepress/config.mts                   |   1 +
 .vitepress/theme/styles/element.css     |   8 +
 docs/demos/ma-pro-table/TestTool.vue    |  20 ++
 docs/demos/ma-pro-table/index.vue       | 170 +++++++++++++++-
 docs/zh/front/component/ma-pro-table.md | 252 +++++++++++++++++++++---
 docs/zh/front/high/plugins.md           |   2 +-
 6 files changed, 423 insertions(+), 30 deletions(-)
 create mode 100644 docs/demos/ma-pro-table/TestTool.vue

diff --git a/.vitepress/config.mts b/.vitepress/config.mts
index 79dfb03..7b94296 100644
--- a/.vitepress/config.mts
+++ b/.vitepress/config.mts
@@ -124,6 +124,7 @@ export default defineConfigWithTheme ({
   },
   srcDir: 'docs',
   markdown:{
+    lineNumbers: true,
     config:(md:MarkdownRenderer)=>{
       md.use(demoPreviewPlugin)
       md.use(plantuml,{
diff --git a/.vitepress/theme/styles/element.css b/.vitepress/theme/styles/element.css
index 1ee3c46..882c4f5 100644
--- a/.vitepress/theme/styles/element.css
+++ b/.vitepress/theme/styles/element.css
@@ -32,4 +32,12 @@
 
 .el-table tr:nth-child(2n) {
   background-color: transparent;
+}
+
+.theme-blog-popover, .theme-blog-popover-close {
+  top: 120px !important;
+}
+
+.VPDoc.has-aside .content-container {
+  max-width: max-content !important;
 }
\ No newline at end of file
diff --git a/docs/demos/ma-pro-table/TestTool.vue b/docs/demos/ma-pro-table/TestTool.vue
new file mode 100644
index 0000000..2cbe506
--- /dev/null
+++ b/docs/demos/ma-pro-table/TestTool.vue
@@ -0,0 +1,20 @@
+<script setup lang="ts">
+import { MaProTableExpose } from '@mineadmin/pro-table'
+import { ElMessage } from 'element-plus'
+
+const { proxy } = defineProps<{ proxy: MaProTableExpose }>()
+
+const execute = async () => {
+  ElMessage.success('我是扩展出来的，哈哈哈')
+}
+</script>
+
+<template>
+  <el-tooltip content="我是扩展出来的，哈哈哈哈">
+    <el-button circle @click="execute">扩</el-button>
+  </el-tooltip>
+</template>
+
+<style scoped>
+
+</style>
\ No newline at end of file
diff --git a/docs/demos/ma-pro-table/index.vue b/docs/demos/ma-pro-table/index.vue
index 96c0baf..bfa6cad 100644
--- a/docs/demos/ma-pro-table/index.vue
+++ b/docs/demos/ma-pro-table/index.vue
@@ -1,9 +1,175 @@
-<script setup lang="ts">
+<script setup lang="tsx">
+import {onMounted, reactive, ref, inject, h} from 'vue'
+import { MaProTableSchema, MaProTableOptions, MaProTableExpose, useProTableToolbar } from '@mineadmin/pro-table'
+import {ElMessage} from "element-plus";
+import TestTool from './TestTool.vue'
 
+useProTableToolbar().add({
+  name: 'test',
+  order: 0,
+  render: () => TestTool
+})
+
+
+const tableRef = ref<MaProTableExpose>()
+
+const originData = [
+  { name: '石昊', dept: '研发部', xinshui: 12365, date: '2021-08-04' },
+  { name: '叶凡', dept: '销售部', xinshui: 13984, date: '2022-03-31' },
+  { name: '罗峰', dept: '运营部', xinshui: 11288, date: '2022-04-05' },
+  { name: '白小纯', dept: '研发部', xinshui: 9989, date: '2022-05-05' },
+  { name: '林七夜', dept: '销售部', xinshui: 10258, date: '2022-06-05' },
+  { name: '萧炎', dept: '销售部', xinshui: 13069, date: '2022-07-05' },
+  { name: '陈平安', dept: '运营部', xinshui: 8750, date: '2022-08-05' },
+  { name: '王林', dept: '研发部', xinshui: 11369, date: '2022-09-05' },
+  { name: '黑皇', dept: '销售部', xinshui: 11111, date: '2022-10-05' },
+  { name: '秦羽', dept: '运营部', xinshui: 13333, date: '2022-11-05' },
+]
+
+const getPageList = (params = {}): Promise<any> => {
+  return new Promise((resolve, reject) => {
+    const data = []
+    const { page = 1 } = params
+    originData.map((item, idx) =>{
+      data.push({
+        name: item.name + (page * idx),
+        dept: item.dept + (page * idx),
+        xinshui: item.xinshui,
+        date: item.date,
+      })
+    })
+    resolve({
+      data: {
+        total: 1000,
+        list: data,
+      }
+    })
+  })
+}
+
+const options = reactive<MaProTableOptions>({
+  requestOptions: {
+    api: getPageList,
+    requestParams: {page: 1},
+    responseDataHandler: (response): any[] => {
+      return response.list
+    },
+  },
+
+  tableOptions: {
+    pagination: {
+      total: 1000,
+    }
+  },
+
+  rowContextMenu: {
+    enabled: true,
+    items: [{
+      label: '自定义鼠标右键',
+      disabled: false,
+      divider: true,
+      onMenuClick: (data, event) => {
+        ElMessage.success('选择的这行数据: ' + JSON.stringify(data))
+      },
+    },{
+      label: '哈哈哈',
+      disabled: false,
+      onMenuClick: () => {
+        ElMessage.success('点击了哈哈哈')
+      },
+    }
+    ]
+  },
+})
+
+const schema = reactive<MaProTableSchema>({
+  searchItems: [
+    { label: '姓名', prop: 'name', render: 'input' },
+  ],
+
+  tableColumns: [
+    {
+      type: 'selection',
+      showOverflowTooltip: false,
+    },
+    {
+      width: '80px',
+      type: 'sort'
+    },
+    {
+      label: '人员信息', prop: 'base',
+      children: [
+        { label: '姓名', prop: 'name', cellRenderTo: { name: 'tag' } },
+        { label: '所在部门', prop: 'dept' }
+      ]
+    },
+    {
+      label: '应发薪资', prop: 'xinshui',
+      sortable: true,
+      // 使用插件
+      cellRenderTo: { name: 'tag', props: { type: 'danger' } }
+    },
+    { label: '入职时间', prop: 'date' },
+    {
+      type: 'operation',
+      operationConfigure: {
+        type: 'tile',
+        actions: [
+          {
+            name: 'edit',
+            text: () => {
+              return '编辑'
+            },
+            disabled: (data) => {
+              return data.row.name === '叶凡1'
+            },
+            show: (data) => {
+              return data.row.name !== '石昊0'
+            },
+            onClick: (data, proxy) => {
+              ElMessage.success('编辑的数据标题是: ' + data.row.name)
+            }
+          },
+          {
+            name: 'ok',
+            text: () => 'OK',
+            onClick: () => {
+              ElMessage.success('OK')
+            }
+          },
+        ]
+      },
+    },
+  ]
+})
+
+onMounted(() => {
+  // tableRef.value.getMaTableRef().setData(getPageList(1).data.list)
+  tableRef.value.setSearchForm({
+    username: '123',
+  })
+})
 </script>
 
 <template>
-
+  <ma-pro-table
+    ref="tableRef"
+    :options="options"
+    :schema="schema"
+    @row-drag-sort="(v: any[]) => {
+       ElMessage.success('排序完成：' + v)
+    }"
+  >
+    <template #headerRight>
+      <el-button>头部右边扩展</el-button>
+    </template>
+    <template #toolbarLeft>
+      <el-button>工具栏左边扩展</el-button>
+    </template>
+    <template #pageLeft>
+      <el-button>分页左边扩展</el-button>
+    </template>
+  </ma-pro-table>
 </template>
 
 <style scoped>
diff --git a/docs/zh/front/component/ma-pro-table.md b/docs/zh/front/component/ma-pro-table.md
index a2293f2..d41ccb1 100644
--- a/docs/zh/front/component/ma-pro-table.md
+++ b/docs/zh/front/component/ma-pro-table.md
@@ -3,16 +3,173 @@
 
 :::tip 提示
 系统内自带的 **用户、角色管理** 都是 `ma-pro-table` CRUD的最佳实践，文档和实际案例参考，才能快速掌握这个组件。
+
+注意：本组件不再像 `2.0 ma-crud` 那样直接内置支持 `新增` 和 `编辑` 功能，这些需要自己来实现。
 :::
 
 ## 使用
 <DemoPreview dir="demos/ma-pro-table" />
 
 ## cellRenderTo 单元格渲染插件
+::: tip 为什么要存在 cellRenderTo 插件？
+首先，单元格渲染不同内容是使用非常非常频繁的场景，很多代码可能都一样，只是参数不一样，字段名不一样。所以在构建 `ma-pro-table` 时就在考虑如何解决这个问题。
+
+`ma-pro-table` 虽然可以内置针对不同内容的渲染，比如 `url`, `image`, `video`，再比如 `switch` 渲染。但问题是需求多变的，
+内置的功能也永远满足不了业务需求的增长，但同时为了避免代码冗余，所以有了这个插件机制。
+
+大家可以把自己常用的、或者某些专属业务封装的单元格渲染插件，分享出来，分享到应用市场，来丰富单元格渲染，这样大家都不需要再写同样的东西了。
+:::
+
+### 使用单元格插件
+
+```vue 
+<script setup lang="ts">
+import { ref } from 'vue'
+import { MaProTableSchema } from "@mineadmin/pro-table";
+
+const schema = ref<MaProTableSchema>({
+  tableColumns: [
+    {
+      title: '单元格渲染示例',
+      prop: 'title',
+      // 调用单元格渲染插件 // [!code focus:9]
+      cellRenderTo: {
+        // 插件名，此插件将字符串以 el-tag 形式渲染，ma-pro-table 内置这唯一一个。
+        name: 'tag', 
+        // 可以传入插件所需的参数
+        props: {
+          // 该插件非必须传入参数，就不传了、
+        }
+      }
+    }
+  ]
+})
+</script>
+
+<template>
+  <ma-pro-table :schema="schema"/>
+</template>
+
+```
+
+### 注册单元格插件
+注册插件需要导入 `useProTableRenderPlugin()` 方法，然后使用此方法注册、移除插件。
+```ts
+import { useProTableRenderPlugin } from '@mineadmin/pro-table'
+```
+`useProTableRenderPlugin()` 返回了以下几个方法：
+
+- `addPlugin(plugin: MaProTableRenderPlugin): void`: 注册插件
+- `removePlugin(pluginName: string): void`: 移除插件
+- `getPlugins(): MaProTableRenderPlugin[]`: 获取 **ma-pro-table** 已注册的所有插件
+- `getPluginByName(pluginName: string): MaProTableRenderPlugin`: 按插件名获取某个插件信息
+
+
+::: details 点击查看 `MaProTableRenderPlugin` 类型说明
+| 参数       | 说明                  | 类型         |
+|----------|---------------------|-------------------|
+| `name` | 单元格渲染插件名称，唯一标识符 | `string`|
+| `render`  | 渲染函数，支持 `组件, jsx, tsx` 等 | `Function` |
+
+`render` 函数参数说明：
+- `data` 类型: `TableColumnRenderer` 包含 `el-table` 的 `scope` 原生参数，以及 `ma-table` 扩展参数
+- `props`，调用插件时通过 `props` 参数传入的外部参数。
+- `proxy` 类型: `MaProTableExpose` 可查看此章节最下面的 `Expose` 节点说明。
+:::
+
+文档就只说明如何注册插件，我们需要用到 `addPlugin` 函数来注册。
+
+内置 `tag` 插件原型如下：
+```ts
+import { h } from 'vue'
+import { useProTableRenderPlugin } from '@mineadmin/pro-table'
+import { ElTag } from 'element-plus'
+
+const { addPlugin } = useProTableRenderPlugin()
+
+// 注册插件
+addPlugin({
+  // 插件名，唯一标识符，如果需要上传应用市场，请带上专属前缀
+  name: 'tag',
+  // 插件渲染函数，支持指定其他vue组件或者直接编写 tsx 与 jsx 都可以
+  render: (data: TableColumnRenderer, props: any, proxy: MaProTableExpose) => {
+    return h(
+      ElTag,  // 使用 el-tag 来渲染
+      props,  // 透传外部调用插件时传入的 props 参数
+      {
+        default: () => data.row[props?.prop] // 使用 el-tag 默认插槽
+      }
+    )
+  }
+})
 
+```
 
 ## ToolbarPlugin 工具栏插件
+![表格工具栏](https://s21.ax1x.com/2024/11/03/pArlfRU.png)
 
+::: tip 说明
+`ma-pro-table` 也有[插槽](#slot)可以扩展这里，如果某些一次性的功能可使用插槽，如果整个系统都有需求，则建议使用 `api` 来扩展了。
+:::
+
+`useProTableToolbar()` 返回了以下几个方法：
+- `get: (name: string) => MaProTableToolbar` 获取某个工具信息
+- `getAll: () => MaProTableToolbar[]` 获取所有工具信息
+- `add: (toolbar: MaProTableToolbar) => void` 添加新工具
+- `remove: (name: string) => void` 移除一个工具
+- `hide: (name: string) => void` 设置一个工具为不渲染状态
+- `show: (name: string) => void` 设置一个工具为正常渲染状态
+
+::: details 点击查看 `MaProTableToolbar` 类型说明
+| 参数       | 说明                  | 类型         |
+|----------|---------------------|-------------------|
+| `name` | 工具名称，唯一标识符 | `string`|
+| `render`  | 渲染函数，支持 `组件, jsx, tsx` 等 | `Function` |
+| `show`  | 默认是否显示 | `boolean` |
+| `order`  | 工具渲染顺序，数字越小，越靠前 | `number` |
+  :::
+
+### 扩展工具栏
+
+::: code-group 
+```ts [index.vue]
+import { useProTableToolbar } from '@mineadmin/pro-table'
+import CustomerTool from './CustomerTool.vue'
+
+const { add } = useProTableToolbar()
+
+add({
+  // 工具名称
+  name: 'heihei',
+  // 指定渲染组件，会向组件传入一个 proxy 参数，组件内部需要定义 props 来接收
+  render: CustomerTool,
+  show: true,
+  order: 99,
+})
+```
+
+```vue [CustomerTool.vue]
+
+<script setup lang="ts">
+  // 定义 props 来接收 `ma-pro-table` 传入的 proxy 参数
+  import { MaProTableExpose } from "@mineadmin/pro-table"
+  import { ElMessage } from 'element-plus'
+
+  const { proxy } = defineProps<{ proxy: MaProTableExpose }>()
+  
+  const execute = async () => {
+    // 执行刷新表格
+    await proxy?.refresh?.()
+    ElMessage.success('表格刷新成功')
+  }
+</script>
+
+<template>
+  <!-- 加入 circle 属性成为圆按钮，与系统的保持统一 -->
+  <el-button circle @click="execute">😀</el-button>
+</template>
+```
+:::
 
 ## Props
 | 参数       | 说明                  | 类型         | 版本    |
@@ -21,19 +178,19 @@
 | `schema`  | `ma-pro-table` 架构配置 | `MaProTableSchema` | 1.0.0 |
 
 ### MaProTableOptions
-| 参数                  | 说明                                        | 类型                         | 默认值    | 版本    |
-|---------------------|-------------------------------------------|----------------------------|--------|-------|
-| `tableOptions`      | `ma-table` 参数                             | `MaTableOptions`           | -      | 1.0.0 |
-| `searchOptions`     | `ma-search` 参数                            | `MaSearchOptions`          | -      | 1.0.0 |
-| `searchFormOptions` | `ma-form` 参数                              | `MaFormOptions`            | -      | 1.0.0 |
-| ------------------  | --------------------         | -----------------          | -      | -     |
-| `id`                | 当前id，全局唯一，不指定则随机生成一个                      | `string`                   | -      | 1.0.0 |
-| `adaptionOffsetBottom`  | 距离底部偏移量                                   | `number`                   | 0      | 1.0.0 |
-| `actionBtnPosition`  | 动作按钮放置位置，自动模式下，如果开启标题栏，则显示在标题栏，否则显示在表格左上方 | `auto, header, table`      | `auto` | 1.0.0 |
-| `header`  | 头部配置                                      | 查看 [参数配置](#headerconfig)   | -      | 1.0.0 |
-| `toolbar`  | 工具栏是否显示                                   | `boolean, (() => boolean)` | `true` | 1.0.0 |
-| `rowContextMenu`  | 右键配置                                      | 查看 [参数配置](#rowcontextmenu) | -      | 1.0.0 |
-| `requestOptions`  | 列表网络请求配置                                  | 查看 [参数配置](#requestoptions) | -      | 1.0.0 |
+| 参数                     | 说明                                        | 类型                         | 默认值    | 版本    |
+|------------------------|-------------------------------------------|----------------------------|--------|-------|
+| `tableOptions`         | `ma-table` 参数                             | `MaTableOptions`           | -      | 1.0.0 |
+| `searchOptions`        | `ma-search` 参数                            | `MaSearchOptions`          | -      | 1.0.0 |
+| `searchFormOptions`    | `ma-form` 参数                              | `MaFormOptions`            | -      | 1.0.0 |
+| -                      | -                                         | -                          | -      | -     |
+| `id`                   | 当前id，全局唯一，不指定则随机生成一个                      | `string`                   | -      | 1.0.0 |
+| `adaptionOffsetBottom` | 距离底部偏移量                                   | `number`                   | 0      | 1.0.0 |
+| `actionBtnPosition`    | 动作按钮放置位置，自动模式下，如果开启标题栏，则显示在标题栏，否则显示在表格左上方 | `auto, header, table`      | `auto` | 1.0.0 |
+| `header`               | 头部配置                                      | 查看 [参数配置](#headerconfig)   | -      | 1.0.0 |
+| `toolbar`              | 工具栏是否显示                                   | `boolean, (() => boolean)` | `true` | 1.0.0 |
+| `rowContextMenu`       | 右键配置                                      | 查看 [参数配置](#rowcontextmenu) | -      | 1.0.0 |
+| `requestOptions`       | 列表网络请求配置                                  | 查看 [参数配置](#requestoptions) | -      | 1.0.0 |
 
 
 #### HeaderConfig
@@ -44,17 +201,17 @@
 | `subTitle` | 子标题  | `string, (() => string)`                   | -       | 1.0.0 |
 
 #### rowContextMenu
-| 参数                   | 说明                     | 类型                       | 默认值     | 版本    |
-|----------------------|------------------------|--------------------------|---------|-------|
-| `enabled`            | 是否开启行右键菜单              | `boolean`                | `false` | 1.0.0 |
-| `items`              | 右键菜单列表                 | `ContextMenuItem[]`      | -       | 1.0.0 |
-| -------------        | ----- | ----------               | -      | -     |
-| `ContextMenuItem`  | 说明                     | 菜单列表配置说明                        | -      | -     |
-| `label`              | 菜单显示文案                 | `string, (() => string)` | -       | 1.0.0 |
-| `icon`              | 菜单显示图标                 | `string, (() => string)` | -       | 1.0.0 |
-| `disabled`              | 是否禁用                   | `boolean`                | -       | 1.0.0 |
-| `divided`              | 是否显示分割线                | `boolean`                | -       | 1.0.0 |
-| `onMenuClick`              | 菜单项点击事件                | `(data: { row: any, column: any, proxy: MaProTableExpose }, event: Event) => void`                | -       | 1.0.0 |
+| 参数                | 说明        | 类型                                                                                 | 默认值     | 版本    |
+|-------------------|-----------|------------------------------------------------------------------------------------|---------|-------|
+| `enabled`         | 是否开启行右键菜单 | `boolean`                                                                          | `false` | 1.0.0 |
+| `items`           | 右键菜单列表    | `ContextMenuItem[]`                                                                | -       | 1.0.0 |
+| -                 | -         | -                                                                                  | -      | -     |
+| `ContextMenuItem` | 说明        | 菜单列表配置说明                                                                           | -      | -     |
+| `label`           | 菜单显示文案    | `string, (() => string)`                                                           | -       | 1.0.0 |
+| `icon`            | 菜单显示图标    | `string, (() => string)`                                                           | -       | 1.0.0 |
+| `disabled`        | 是否禁用      | `boolean`                                                                          | -       | 1.0.0 |
+| `divided`         | 是否显示分割线   | `boolean`                                                                          | -       | 1.0.0 |
+| `onMenuClick`     | 菜单项点击事件   | `(data: { row: any, column: any, proxy: MaProTableExpose }, event: Event) => void` | -       | 1.0.0 |
 
 #### requestOptions
 | 参数                    | 说明                    | 类型                                                        | 默认值                                                    | 版本    |
@@ -69,9 +226,50 @@
 
 
 ### MaProTableSchema
-| 参数   | 说明           | 类型       | 默认值 | 版本    |
-|------|--------------|----------|-----|-------|
+| 参数   | 说明       | 类型                                                | 默认值 | 版本    |
+|------|----------|---------------------------------------------------|-----|-------|
+|`searchItems`| 搜索项列表配置  | `MaSearchItem[]` [配置项](ma-search#searchitems) | -   | 1.0.0 |
+|`tableColumns`| 表格列表配置 | `MaProTableColumns[]`                             | -   | 1.0.0 |
+
+#### MaProTableColumns
+::: tip
+继承于 `el-table-columns` 和 `ma-table` 的 [扩展columns配置](ma-table#columnextraprops) ，以下是扩展参数
+:::
+| 参数   | 说明                         | 类型                                                 | 默认值 | 版本    |
+|------|----------------------------|----------------------------------------------------|-----|-------|
+|`type`| `el-table` 原生基础上，增加 `operation`, `sort`，第一个为操作栏，可通过 `API 扩展`，第二个为`行拖动排序` | `string` | -   | 1.0.0 |
+|`cellRenderTo`| 渲染单元格为表格注册的插件                     | [查看下方类型](#cellrenderto-使用渲染插件)    | -   | 1.0.0 |
+|`operationConfigure`| 操作栏配置，只有 `type` 为 `operation` 生效  | [查看下方类型](#operationconfigure-操作栏)    | -   | 1.0.0 |
+
+##### cellRenderTo 使用渲染插件
+::: info 
+`ma-pro-table` 单元格渲染插件，得先必须注册了插件后才可使用。
+:::
+| 参数      | 说明        | 类型           | 默认值 | 版本    |
+|---------|-----------|--------------|-----|-------|
+| `name`  | 单元格渲染插件名  | `string`     | -   | 1.0.0 |
+| `props` | 插件所需的额外参数 | `any, any[]` | -   | 1.0.0 |
+
+##### operationConfigure 操作栏
+::: info 
+`操作栏` 只能通过 `api` 来设置操作项，如果觉着麻烦，可自己在 `columns` 增加一个普通列，自己使用插槽来实现。
+:::
+| 参数      | 说明        | 类型           | 默认值 | 版本    |
+|---------|-----------|--------------|-----|-------|
+| `type`  | 显示方式，下拉菜单：`dropdown`, 平铺：`tile`  | `string`     | `dropdown`   | 1.0.0 |
+| `actions` | 操作栏配置列表 | `OperationAction[]` | -   | 1.0.0 |
 
+###### OperationAction 操作栏列表配置
+| 参数         | 说明                        | 类型                                                             | 默认值 | 版本    |
+|------------|---------------------------|----------------------------------------------------------------|-----|-------|
+| `name`     | 操作标识                      | `string`                                                       | -  | 1.0.0 |
+| `text`     | 文本配置                      | `string, ((data: TableColumnRenderer) => string)`              | -  | 1.0.0 |
+| `icon`     | 图标配置，内部用 `ma-svg-icon` 渲染 | `string, ((data: TableColumnRenderer) => string)`              | -  | 1.0.0 |
+| `order`    | 排序，越小越靠前                  | `number`                                                       | -   | 1.0.0 |
+| `disabled` | 是否禁用                      | `((data: TableColumnRenderer) => boolean)`                     | -   | 1.0.0 |
+| `show`     | 是否显示                      | `((data: TableColumnRenderer) => boolean)`                     | -   | 1.0.0 |
+| `onClick`  | 点击事件                      | `(data: TableColumnRenderer, proxy: MaProTableExpose) => void` | -   | 1.0.0 |
+| `linkProps`  | `el-link` 的 `props` 参数      | [LinkProps 文档](https://element-plus.org/zh-CN/component/link.html#attributes)                                               | -   | 1.0.0 |
 
 ## Event
 
@@ -116,4 +314,4 @@
 | `getSearchForm()`    | 获取搜索表单数据              | `() => Record<string, any>`                                     | `Record<string, any>`                |
 | `getProTableOptions()`    | 获取 `ma-pro-table` 的参数 | `() => Record<string, any>`                                     | `Record<string, any>`                |
 | `resizeHeight()`    | 重置表格高度                | `() => Promise<void>`                                           | `Promise<void>`                |
-| `getCurrentId()`    | 获取当前组件ID              | -                                                               | `string`                |
+| `getCurrentId()`    | 获取当前组件ID              | -                                                               | `string`                |**
diff --git a/docs/zh/front/high/plugins.md b/docs/zh/front/high/plugins.md
index 937c354..f2b27da 100644
--- a/docs/zh/front/high/plugins.md
+++ b/docs/zh/front/high/plugins.md
@@ -121,7 +121,7 @@ const pluginConfig: Plugin.PluginConfig = {
   },
   // 插件基础信息，必须配置
   config: {
-    // 是否启用，也可以根据 import.meta.env 环境变量来确定是否启用，必须打包后不可使用。
+    // 是否启用，也可以根据 import.meta.env 环境变量来确定是否启用，比如打包后不可使用。
     enable: true, 
     // 基础信息
     info: {