el-plus 0.0.113 → 0.0.115

package/docs/components/buttons.md

@@ -1,179 +1,179 @@
-# EpButtons 按钮组
-
-按钮组组件，支持权限控制、确认弹窗等功能。
-
-## 基本用法
-
-```vue
-<template>
-  <EpButtons :list="buttons" />
-</template>
-
-<script setup>
-const buttons = [
-  {
-    name: '新增',
-    prop: 'add',
-    onClick: () => {
-      // 新增逻辑
-    },
-  },
-  {
-    name: '删除',
-    prop: 'delete',
-    onClick: () => {
-      // 删除逻辑
-    },
-  },
-]
-</script>
-```
-
-## 在 Form 中使用
-
-```tsx
-const formItemList = ref<FormProps['formItemList']>([
-  {
-    col: 24,
-    type: 'EpButtons',
-    props: {
-      list: [
-        {
-          name: '提交审批',
-          type: 'primary',
-          onClick: () => {
-            // 提交审批逻辑
-          },
-        },
-        {
-          name: '取消审批',
-          onClick: () => {
-            // 取消审批逻辑
-          },
-        },
-        {
-          name: '作废',
-          onClick: () => {
-            // 作废逻辑
-          },
-        },
-      ],
-    },
-  },
-])
-```
-
-## Props
-
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| list | 按钮列表 | `ButtonProps[]` | `[]` |
-| size | 按钮尺寸 | `'large' \| 'default' \| 'small'` | `'small'` |
-| type | 默认按钮类型 | `string` | `'default'` |
-| disabled | 是否禁用（支持函数） | `boolean \| () => boolean` | `false` |
-
-## ButtonProps 配置
-
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| name | 按钮文本 | `string` | - |
-| prop | 唯一标识 | `string` | - |
-| type | 按钮类型 | `'primary' \| 'success' \| 'warning' \| 'danger' \| 'info'` | - |
-| plain | 朴素按钮 | `boolean` | `false` |
-| disabled | 是否禁用 | `boolean \| () => boolean` | `false` |
-| show | 是否显示（支持函数） | `boolean \| () => boolean` | `true` |
-| hide | 是否隐藏（支持函数） | `boolean \| () => boolean` | `false` |
-| permission | 权限标识 | `string` | - |
-| confirm | 是否需要确认 | `boolean` | `false` |
-| confirmText | 确认提示文本 | `string` | `'确定要${name}吗？'` |
-| confirmBefore | 点击前前置校验 | `() => Promise<void>` | - |
-| onClick | 点击回调 | `(e: MouseEvent \| TableScope) => void` | - |
-
-## 带确认弹窗
-
-```tsx
-const buttons = [
-  {
-    name: '删除',
-    prop: 'delete',
-    confirm: true,
-    onClick: () => {
-      // 删除逻辑
-    },
-  },
-]
-```
-
-## 点击前前置校验
-
-使用 `confirmBefore` 可以在点击后、确认弹窗弹出前执行异步校验逻辑，Promise reject 则阻止后续操作（不弹确认框、不执行 `onClick`）。
-
-```tsx
-const buttons = [
-  {
-    name: '提交',
-    prop: 'submit',
-    confirmBefore: async () => {
-      const valid = await validateForm()
-      if (!valid) {
-        return Promise.reject()
-      }
-    },
-    confirm: true,
-    onClick: () => {
-      // 提交逻辑
-    },
-  },
-]
-```
-
-> **⚠️ 注意：需要确认弹窗时，必须使用 `confirm: true` 属性，禁止手动编写 `ElMessageBox.confirm`**
->
-> **正确做法**：
-> ```tsx
-> { name: '取消审批', confirm: true, onClick: () => { ElMessage.success('成功') } }
-> ```
->
-> **错误做法**：
-> ```tsx
-> { name: '取消审批', onClick: () => { ElMessageBox.confirm(...).then(...) } }
-> ```
-
-## 权限控制
-
-```tsx
-const buttons = [
-  {
-    name: '编辑',
-    prop: 'edit',
-    permission: 'order:edit', // 需要 order:edit 权限才显示
-    onClick: () => {},
-  },
-]
-```
-
-## 动态禁用
-
-```tsx
-const buttons = [
-  {
-    name: '提交',
-    prop: 'submit',
-    disabled: () => formData.status !== 'draft',
-    onClick: () => {},
-  },
-]
-```
-
-## 动态显示
-
-```tsx
-const buttons = [
-  {
-    name: '审核',
-    prop: 'audit',
-    show: () => formData.status === 'pending',
-    onClick: () => {},
-  },
-]
-```
+# EpButtons 按钮组
+
+按钮组组件，支持权限控制、确认弹窗等功能。
+
+## 基本用法
+
+```vue
+<template>
+  <EpButtons :list="buttons" />
+</template>
+
+<script setup>
+const buttons = [
+  {
+    name: '新增',
+    prop: 'add',
+    onClick: () => {
+      // 新增逻辑
+    },
+  },
+  {
+    name: '删除',
+    prop: 'delete',
+    onClick: () => {
+      // 删除逻辑
+    },
+  },
+]
+</script>
+```
+
+## 在 Form 中使用
+
+```tsx
+const formItemList = ref<FormProps['formItemList']>([
+  {
+    col: 24,
+    type: 'EpButtons',
+    props: {
+      list: [
+        {
+          name: '提交审批',
+          type: 'primary',
+          onClick: () => {
+            // 提交审批逻辑
+          },
+        },
+        {
+          name: '取消审批',
+          onClick: () => {
+            // 取消审批逻辑
+          },
+        },
+        {
+          name: '作废',
+          onClick: () => {
+            // 作废逻辑
+          },
+        },
+      ],
+    },
+  },
+])
+```
+
+## Props
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| list | 按钮列表 | `ButtonProps[]` | `[]` |
+| size | 按钮尺寸 | `'large' \| 'default' \| 'small'` | `'small'` |
+| type | 默认按钮类型 | `string` | `'default'` |
+| disabled | 是否禁用（支持函数） | `boolean \| () => boolean` | `false` |
+
+## ButtonProps 配置
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| name | 按钮文本 | `string` | - |
+| prop | 唯一标识 | `string` | - |
+| type | 按钮类型 | `'primary' \| 'success' \| 'warning' \| 'danger' \| 'info'` | - |
+| plain | 朴素按钮 | `boolean` | `false` |
+| disabled | 是否禁用 | `boolean \| () => boolean` | `false` |
+| show | 是否显示（支持函数） | `boolean \| () => boolean` | `true` |
+| hide | 是否隐藏（支持函数） | `boolean \| () => boolean` | `false` |
+| permission | 权限标识 | `string` | - |
+| confirm | 是否需要确认 | `boolean` | `false` |
+| confirmText | 确认提示文本 | `string` | `'确定要${name}吗？'` |
+| confirmBefore | 点击前前置校验 | `() => Promise<void>` | - |
+| onClick | 点击回调 | `(e: MouseEvent \| TableScope) => void` | - |
+
+## 带确认弹窗
+
+```tsx
+const buttons = [
+  {
+    name: '删除',
+    prop: 'delete',
+    confirm: true,
+    onClick: () => {
+      // 删除逻辑
+    },
+  },
+]
+```
+
+## 点击前前置校验
+
+使用 `confirmBefore` 可以在点击后、确认弹窗弹出前执行异步校验逻辑，Promise reject 则阻止后续操作（不弹确认框、不执行 `onClick`）。
+
+```tsx
+const buttons = [
+  {
+    name: '提交',
+    prop: 'submit',
+    confirmBefore: async () => {
+      const valid = await validateForm()
+      if (!valid) {
+        return Promise.reject()
+      }
+    },
+    confirm: true,
+    onClick: () => {
+      // 提交逻辑
+    },
+  },
+]
+```
+
+> **⚠️ 注意：需要确认弹窗时，必须使用 `confirm: true` 属性，禁止手动编写 `ElMessageBox.confirm`**
+>
+> **正确做法**：
+> ```tsx
+> { name: '取消审批', confirm: true, onClick: () => { ElMessage.success('成功') } }
+> ```
+>
+> **错误做法**：
+> ```tsx
+> { name: '取消审批', onClick: () => { ElMessageBox.confirm(...).then(...) } }
+> ```
+
+## 权限控制
+
+```tsx
+const buttons = [
+  {
+    name: '编辑',
+    prop: 'edit',
+    permission: 'order:edit', // 需要 order:edit 权限才显示
+    onClick: () => {},
+  },
+]
+```
+
+## 动态禁用
+
+```tsx
+const buttons = [
+  {
+    name: '提交',
+    prop: 'submit',
+    disabled: () => formData.status !== 'draft',
+    onClick: () => {},
+  },
+]
+```
+
+## 动态显示
+
+```tsx
+const buttons = [
+  {
+    name: '审核',
+    prop: 'audit',
+    show: () => formData.status === 'pending',
+    onClick: () => {},
+  },
+]
+```

package/docs/components/custom-column.md

@@ -1,70 +1,70 @@
-# EpCustomColumn 自定义列配置
-
-用于配置表格显示列的组件，支持拖拽排序和持久化。
-
-## 基本用法
-
-```vue
-<template>
-  <EpCustomColumn
-    ref="customColumn"
-    module="orderList"
-    @confirm="handleConfirm"
-  />
-</template>
-
-<script setup>
-import { useTemplateRef } from 'vue'
-
-const customColumn = useTemplateRef('customColumn')
-
-// 打开配置弹窗
-const openCustomColumn = () => {
-  customColumn.value?.open()
-}
-
-const handleConfirm = (columns) => {
-  console.log('选中的列', columns)
-}
-</script>
-```
-
-## Props
-
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| module | 模块标识 | `string \| number` | - |
-| api | 获取列配置接口 | `string` \| `Function` | `/api-item/api/customizedColumns/find` |
-| saveApi | 保存列配置接口 | `string`\｜ `Function` | `/api-item/api/customizedColumns/save` |
-| showHandler | 显示拖拽手柄 | `boolean` | `true` |
-
-## Events
-
-| 事件名 | 说明 | 回调参数 |
-|--------|------|----------|
-| confirm | 确认配置 | `(columns: TransferDataItem[])` |
-| loaded | 配置加载完成 | `(columns: TransferDataItem[])` |
-
-## 配合 EpSearchListPage 使用
-
-```vue
-<template>
-  <EpSearchListPage
-    :columns="columns"
-    :custom-column-module="11"
-    custom-column-api="/api/columns/find"
-    custom-column-save-api="/api/columns/save"
-  />
-</template>
-```
-
-## 配合 EpTable 使用
-
-```vue
-<template>
-  <EpTable
-    :columns="columns"
-    :custom-column-module="11"
-  />
-</template>
-```
+# EpCustomColumn 自定义列配置
+
+用于配置表格显示列的组件，支持拖拽排序和持久化。
+
+## 基本用法
+
+```vue
+<template>
+  <EpCustomColumn
+    ref="customColumn"
+    module="orderList"
+    @confirm="handleConfirm"
+  />
+</template>
+
+<script setup>
+import { useTemplateRef } from 'vue'
+
+const customColumn = useTemplateRef('customColumn')
+
+// 打开配置弹窗
+const openCustomColumn = () => {
+  customColumn.value?.open()
+}
+
+const handleConfirm = (columns) => {
+  console.log('选中的列', columns)
+}
+</script>
+```
+
+## Props
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| module | 模块标识 | `string \| number` | - |
+| api | 获取列配置接口 | `string` \| `Function` | `/api-item/api/customizedColumns/find` |
+| saveApi | 保存列配置接口 | `string`\｜ `Function` | `/api-item/api/customizedColumns/save` |
+| showHandler | 显示拖拽手柄 | `boolean` | `true` |
+
+## Events
+
+| 事件名 | 说明 | 回调参数 |
+|--------|------|----------|
+| confirm | 确认配置 | `(columns: TransferDataItem[])` |
+| loaded | 配置加载完成 | `(columns: TransferDataItem[])` |
+
+## 配合 EpSearchListPage 使用
+
+```vue
+<template>
+  <EpSearchListPage
+    :columns="columns"
+    :custom-column-module="11"
+    custom-column-api="/api/columns/find"
+    custom-column-save-api="/api/columns/save"
+  />
+</template>
+```
+
+## 配合 EpTable 使用
+
+```vue
+<template>
+  <EpTable
+    :columns="columns"
+    :custom-column-module="11"
+  />
+</template>
+```

package/docs/components/date-picker-range.md

@@ -1,61 +1,61 @@
-# EpDatePickerRange 日期范围选择
-
-基于 el-date-picker 封装的日期范围选择组件，内置快捷选项。
-
-## 基本用法
-
-```vue
-<template>
-  <EpDatePickerRange v-model="dateRange" />
-</template>
-
-<script setup>
-import { ref } from 'vue'
-
-const dateRange = ref([])
-</script>
-```
-
-## Props
-
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| v-model | 绑定值 ^el^ | `[Date, Date] \| [number, number]` | - |
-| type | 类型 ^el^ | `string` | `'daterange'` |
-| valueFormat | 值格式 ^el^ | `string` | `'x'` (时间戳) |
-| rangeSeparator | 分隔符 ^el^ | `string` | `'~'` |
-| startPlaceholder | 开始占位文本 ^el^ | `string` | '开始时间' |
-| endPlaceholder | 结束占位文本 ^el^ | `string` | '结束时间' |
-| size | 尺寸 ^el^ | `'large' \| 'default' \| 'small'` | `'default'` |
-| shortcuts | 快捷选项 ^el^ | `array` | 最近一周/一月/三月 |
-
-> ^el^ 表示继承自 [el-date-picker](https://element-plus.org/zh-CN/component/date-picker.html) 的属性
-
-## 默认快捷选项
-
-- 最近一周
-- 最近一月
-- 最近三月
-
-## 在 Form 中使用
-
-```tsx
-const formItemList = [
-  {
-    prop: 'orderDate',
-    label: '日期范围',
-    type: 'EpDatePickerRange',
-    props: {
-      start: formData.orderDateStart,
-      end: formData.orderDateEnd,
-    },
-    'onUpdate:start': (val) => {
-      formData.orderDateStart = val
-    },
-    'onUpdate:end': (val) => {
-      formData.orderDateEnd = val
-    },
-  }
-]
-```
-
+# EpDatePickerRange 日期范围选择
+
+基于 el-date-picker 封装的日期范围选择组件，内置快捷选项。
+
+## 基本用法
+
+```vue
+<template>
+  <EpDatePickerRange v-model="dateRange" />
+</template>
+
+<script setup>
+import { ref } from 'vue'
+
+const dateRange = ref([])
+</script>
+```
+
+## Props
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| v-model | 绑定值 ^el^ | `[Date, Date] \| [number, number]` | - |
+| type | 类型 ^el^ | `string` | `'daterange'` |
+| valueFormat | 值格式 ^el^ | `string` | `'x'` (时间戳) |
+| rangeSeparator | 分隔符 ^el^ | `string` | `'~'` |
+| startPlaceholder | 开始占位文本 ^el^ | `string` | '开始时间' |
+| endPlaceholder | 结束占位文本 ^el^ | `string` | '结束时间' |
+| size | 尺寸 ^el^ | `'large' \| 'default' \| 'small'` | `'default'` |
+| shortcuts | 快捷选项 ^el^ | `array` | 最近一周/一月/三月 |
+
+> ^el^ 表示继承自 [el-date-picker](https://element-plus.org/zh-CN/component/date-picker.html) 的属性
+
+## 默认快捷选项
+
+- 最近一周
+- 最近一月
+- 最近三月
+
+## 在 Form 中使用
+
+```tsx
+const formItemList = [
+  {
+    prop: 'orderDate',
+    label: '日期范围',
+    type: 'EpDatePickerRange',
+    props: {
+      start: formData.orderDateStart,
+      end: formData.orderDateEnd,
+    },
+    'onUpdate:start': (val) => {
+      formData.orderDateStart = val
+    },
+    'onUpdate:end': (val) => {
+      formData.orderDateEnd = val
+    },
+  }
+]
+```
+