el-plus 0.0.113 → 0.0.115

package/docs/components/input.md

@@ -1,111 +1,111 @@
-# EpInput 输入框
-
-基于 el-input 封装，增加数字格式化等功能。
-
-## 基本用法
-
-```vue
-<template>
-  <EpInput v-model="value" />
-</template>
-
-<script setup>
-import { ref } from 'vue'
-
-const value = ref('')
-</script>
-```
-
-## Props
-
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| v-model | 绑定值 ^el^ | `string \| number` | - |
-| placeholder | 占位文本 ^el^ | `string` | '请输入' |
-| clearable | 是否可清空 ^el^ | `boolean` | `true` |
-| max | 最大值（数字模式） | `number` | - |
-| min | 最小值（数字模式） | `number` | - |
-| radix | 小数位数 | `number` | - |
-| nonzero | 不允许为零 | `boolean` | `false` |
-| thousand | 千分位格式化 | `boolean` | `true` |
-
-> ^el^ 表示继承自 [el-input](https://element-plus.org/zh-CN/component/input.html) 的属性
-
-## 注意事项
-
-### 属性默认值
-- 有默认值的属性无需显式设置，只有需要修改默认值时才需要配置。
- 如：`clearable` 默认为 `true`，无需显式设置。只有需要 `clearable: false` 时才需设置。
-- 数值相关属性（`max`、`min`、`radix`、`nonzero`）默认不设置，只有明确需要时才添加。
-
-```json
-// ❌ 错误：无需设置默认值属性
-{ "prop": "name", "props": { "clearable": true } }
-// ✅ 正确：使用默认值
-{ "prop": "name" }
-
-// ❌ 错误：数值文本框默认不加数值相关属性
-{ "prop": "amount", "label": "金额", "props": { "thousand": true } }
-// ✅ 正确：数值文本框无需设置数值相关属性
-{ "prop": "amount", "label": "金额" }
-// ✅ 正确：有特殊需求时才设置
-{ "prop": "amount", "label": "金额", "props": { "radix": 2, "max": 999999 } }
-```
-
-## 在 Form 中使用
-
-```tsx
-const formItemList = [
-  {
-    prop: 'name',
-    label: '名称',
-  },
-  {
-    prop: 'number',
-    label: '数字',
-  },
-  {
-    prop: 'remark',
-    label: '备注',
-    col: 24,
-    props: {
-      type: 'textarea',
-      rows: 4,
-      maxlength: 200,
-      showWordLimit: true,
-    },
-  },
-]
-```
-
-## 数字输入
-
-```tsx
-const formItemList = [
-  {
-    prop: 'amount',
-    label: '金额',
-    props: {
-      max: 999999,
-      min: 0,
-      radix: 2, // 保留2位小数
-      thousand: true, // 千分位
-    },
-  },
-]
-```
-
-## 格式化显示
-
-通过 `formatter` 属性自定义显示格式：
-
-```tsx
-{
-  prop: 'value',
-  label: '值',
-  disabled: true,
-  props: {
-    formatter: (value) => `${value} 元`,
-  },
-}
-```
+# EpInput 输入框
+
+基于 el-input 封装，增加数字格式化等功能。
+
+## 基本用法
+
+```vue
+<template>
+  <EpInput v-model="value" />
+</template>
+
+<script setup>
+import { ref } from 'vue'
+
+const value = ref('')
+</script>
+```
+
+## Props
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| v-model | 绑定值 ^el^ | `string \| number` | - |
+| placeholder | 占位文本 ^el^ | `string` | '请输入' |
+| clearable | 是否可清空 ^el^ | `boolean` | `true` |
+| max | 最大值（数字模式） | `number` | - |
+| min | 最小值（数字模式） | `number` | - |
+| radix | 小数位数 | `number` | - |
+| nonzero | 不允许为零 | `boolean` | `false` |
+| thousand | 千分位格式化 | `boolean` | `true` |
+
+> ^el^ 表示继承自 [el-input](https://element-plus.org/zh-CN/component/input.html) 的属性
+
+## 注意事项
+
+### 属性默认值
+- 有默认值的属性无需显式设置，只有需要修改默认值时才需要配置。
+ 如：`clearable` 默认为 `true`，无需显式设置。只有需要 `clearable: false` 时才需设置。
+- 数值相关属性（`max`、`min`、`radix`、`nonzero`）默认不设置，只有明确需要时才添加。
+
+```json
+// ❌ 错误：无需设置默认值属性
+{ "prop": "name", "props": { "clearable": true } }
+// ✅ 正确：使用默认值
+{ "prop": "name" }
+
+// ❌ 错误：数值文本框默认不加数值相关属性
+{ "prop": "amount", "label": "金额", "props": { "thousand": true } }
+// ✅ 正确：数值文本框无需设置数值相关属性
+{ "prop": "amount", "label": "金额" }
+// ✅ 正确：有特殊需求时才设置
+{ "prop": "amount", "label": "金额", "props": { "radix": 2, "max": 999999 } }
+```
+
+## 在 Form 中使用
+
+```tsx
+const formItemList = [
+  {
+    prop: 'name',
+    label: '名称',
+  },
+  {
+    prop: 'number',
+    label: '数字',
+  },
+  {
+    prop: 'remark',
+    label: '备注',
+    col: 24,
+    props: {
+      type: 'textarea',
+      rows: 4,
+      maxlength: 200,
+      showWordLimit: true,
+    },
+  },
+]
+```
+
+## 数字输入
+
+```tsx
+const formItemList = [
+  {
+    prop: 'amount',
+    label: '金额',
+    props: {
+      max: 999999,
+      min: 0,
+      radix: 2, // 保留2位小数
+      thousand: true, // 千分位
+    },
+  },
+]
+```
+
+## 格式化显示
+
+通过 `formatter` 属性自定义显示格式：
+
+```tsx
+{
+  prop: 'value',
+  label: '值',
+  disabled: true,
+  props: {
+    formatter: (value) => `${value} 元`,
+  },
+}
+```

package/docs/components/link.md

@@ -1,63 +1,63 @@
-# EpLink 链接
-
-基于 el-link 封装的链接组件。
-
-## 基本用法
-
-```vue
-<template>
-  <EpLink content="查看详情" @click="handleClick" />
-</template>
-
-<script setup>
-const handleClick = () => {
-  console.log('点击')
-}
-</script>
-```
-
-## Props
-
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| content | 链接文本 | `string` | - |
-| type | 类型 ^el^ | `'primary' \| 'success' \| 'warning' \| 'danger' \| 'info'` | `'primary'` |
-| underline | 下划线 ^el^ | `'always' \| 'hover' \| 'never'` | `'never'` |
-| disabled | 是否禁用 ^el^ | `boolean` | `false` |
-| href | 链接地址 ^el^ | `string` | - |
-
-> ^el^ 表示继承自 [el-link](https://element-plus.org/zh-CN/component/link.html) 的属性
-
-## 在表格中使用
-
-```tsx
-const columns = [
-  {
-    prop: 'orderNo',
-    label: '订单号',
-    type: 'EpLink',
-    props: {
-      onClick: (row) => {
-        // 跳转详情
-      },
-    },
-  },
-]
-```
-
-## 在 Form 中使用
-
-```tsx
-const formItemList = [
-  {
-    prop: 'relatedNo',
-    label: '关联单号',
-    type: 'EpLink',
-    props: {
-      onClick: () => {
-        // 跳转关联单据
-      },
-    },
-  },
-]
-```
+# EpLink 链接
+
+基于 el-link 封装的链接组件。
+
+## 基本用法
+
+```vue
+<template>
+  <EpLink content="查看详情" @click="handleClick" />
+</template>
+
+<script setup>
+const handleClick = () => {
+  console.log('点击')
+}
+</script>
+```
+
+## Props
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| content | 链接文本 | `string` | - |
+| type | 类型 ^el^ | `'primary' \| 'success' \| 'warning' \| 'danger' \| 'info'` | `'primary'` |
+| underline | 下划线 ^el^ | `'always' \| 'hover' \| 'never'` | `'never'` |
+| disabled | 是否禁用 ^el^ | `boolean` | `false` |
+| href | 链接地址 ^el^ | `string` | - |
+
+> ^el^ 表示继承自 [el-link](https://element-plus.org/zh-CN/component/link.html) 的属性
+
+## 在表格中使用
+
+```tsx
+const columns = [
+  {
+    prop: 'orderNo',
+    label: '订单号',
+    type: 'EpLink',
+    props: {
+      onClick: (row) => {
+        // 跳转详情
+      },
+    },
+  },
+]
+```
+
+## 在 Form 中使用
+
+```tsx
+const formItemList = [
+  {
+    prop: 'relatedNo',
+    label: '关联单号',
+    type: 'EpLink',
+    props: {
+      onClick: () => {
+        // 跳转关联单据
+      },
+    },
+  },
+]
+```

package/docs/components/search-list-page.md

@@ -1,91 +1,91 @@
-# EpSearchListPage 搜索列表页
-
-集成搜索表单和数据表格的列表页容器组件。
-
-## 基本用法
-
-```vue
-<template>
-  <EpSearchListPage
-    :form-item-list="formItemList"
-    :form-data="formData"
-    :columns="columns"
-    :left-buttons="leftButtons"
-    api="/api/list/page"
-    :add="handleAdd"
-    show-selection-col
-    :action-buttons="actionButtons"
-  />
-</template>
-
-<script setup lang="tsx">
-import { ref, reactive } from 'vue'
-import type { SearchListPageProps } from 'el-plus'
-
-const formData = reactive({})
-
-const formItemList = ref<SearchListPageProps['formItemList']>([
-  { prop: 'name', label: '名称' },
-  { prop: 'status', label: '状态', type: 'EpSelect', props: { options: [] } },
-])
-// 如果有自定义列，就不需要定义 columns
-const columns = [
-  { prop: 'name', label: '名称' },
-  { prop: 'status', label: '状态' },
-]
-
-const leftButtons = ref<SearchListPageProps['leftButtons']>([
-  { name: '删除', prop: 'delete', type: 'danger' },
-])
-
-const actionButtons = ref<SearchListPageProps['actionButtons']>([
-  { name: '编辑', prop: 'edit', onClick: (row) => {} },
-  { name: '删除', prop: 'delete', onClick: (row) => {} },
-])
-
-const handleAdd = () => {}
-</script>
-```
-
-## Props
-
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| api | 列表接口地址 | `string \| (reqData) => Promise` | - |
-| method | 请求方法 | `string` | `'post'` |
-| reqData | 请求体数据 | `object` | `{}` |
-| reqParams | URL 参数 | `object` | `{}` |
-| reqBefore | 请求前处理 | `(reqData) => reqData` | - |
-| reqAfter | 响应后处理 | `(res) => data` | - |
-| formData | 表单数据，参考 [EpForm 表单数据说明](./form.md#表单数据) | `object` | `{}` |
-| formItemList | 搜索表单配置 | [`FormItemProps[]`](./form.md#formitemprops-配置) | `[]` |
-| columns | 表格列配置（有customColumnModule就不需要定义列） | [`TableColumn[]`](./table.md#tablecolumn-配置) | `[]` |
-| leftButtons | 左侧按钮 | [`ButtonProps[]`](./buttons.md#buttonprops-配置) | `[]` |
-| actionButtons | 操作列按钮 | [`ButtonProps[]`](./buttons.md#buttonprops-配置) | `[]` |
-| add | 新增按钮回调 | `Function` | - |
-| showSelectionCol | 显示多选列 | `boolean` | `false` |
-| showSingleSelectionCol | 显示单选列 | `boolean` | `false` |
-| showIndexCol | 显示序号列 | `boolean` | `true` |
-| showOperationColumn | 显示操作列 | `boolean` | - |
-| minWidth | 列最小宽度 | `number \| string` | - |
-| actionColWidth | 操作列宽度 | `number \| string` | `200` |
-| formatColumns | 格式化列配置 | [`TableColumn[]`](./table.md#tablecolumn-配置) | `[]` |
-| offsetTop | 表格额外距离 | `number` | `0` |
-| isInitSearch | 是否初始化加载 | `boolean` | `true` |
-| tableProps | 表格额外属性 | `object` | - |
-| formProps | 表单额外属性 | `object` | - |
-| buttonsProps | 按钮组额外属性 | `object` | - |
-| name | 权限前缀 | `string` | - |
-| customColumnModule | 自定义列模块 | `string \| number` | - |
-
-::: warning 互斥关系
-`customColumnModule` 和以下配置是**互斥**的：
-- `columns`：设置了 `customColumnModule` 后会忽略 `columns`
-- `leftButtons` 中的"自定义列设置"按钮：组件会自动内置该按钮
-
-**正确用法**：
-- 启用自定义列：`customColumnModule: "moduleName"`（无需配 columns 和自定义列按钮）
-- 固定列模式：不设置 `customColumnModule`，使用 `columns` 配置
-:::
-| customColumnApi | 自定义列接口 | `string` | - |
-| customColumnSaveApi | 自定义列保存接口 | `string` | - |
+# EpSearchListPage 搜索列表页
+
+集成搜索表单和数据表格的列表页容器组件。
+
+## 基本用法
+
+```vue
+<template>
+  <EpSearchListPage
+    :form-item-list="formItemList"
+    :form-data="formData"
+    :columns="columns"
+    :left-buttons="leftButtons"
+    api="/api/list/page"
+    :add="handleAdd"
+    show-selection-col
+    :action-buttons="actionButtons"
+  />
+</template>
+
+<script setup lang="tsx">
+import { ref, reactive } from 'vue'
+import type { SearchListPageProps } from 'el-plus'
+
+const formData = reactive({})
+
+const formItemList = ref<SearchListPageProps['formItemList']>([
+  { prop: 'name', label: '名称' },
+  { prop: 'status', label: '状态', type: 'EpSelect', props: { options: [] } },
+])
+// 如果有自定义列，就不需要定义 columns
+const columns = [
+  { prop: 'name', label: '名称' },
+  { prop: 'status', label: '状态' },
+]
+
+const leftButtons = ref<SearchListPageProps['leftButtons']>([
+  { name: '删除', prop: 'delete', type: 'danger' },
+])
+
+const actionButtons = ref<SearchListPageProps['actionButtons']>([
+  { name: '编辑', prop: 'edit', onClick: (row) => {} },
+  { name: '删除', prop: 'delete', onClick: (row) => {} },
+])
+
+const handleAdd = () => {}
+</script>
+```
+
+## Props
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| api | 列表接口地址 | `string \| (reqData) => Promise` | - |
+| method | 请求方法 | `string` | `'post'` |
+| reqData | 请求体数据 | `object` | `{}` |
+| reqParams | URL 参数 | `object` | `{}` |
+| reqBefore | 请求前处理 | `(reqData) => reqData` | - |
+| reqAfter | 响应后处理 | `(res) => data` | - |
+| formData | 表单数据，参考 [EpForm 表单数据说明](./form.md#表单数据) | `object` | `{}` |
+| formItemList | 搜索表单配置 | [`FormItemProps[]`](./form.md#formitemprops-配置) | `[]` |
+| columns | 表格列配置（有customColumnModule就不需要定义列） | [`TableColumn[]`](./table.md#tablecolumn-配置) | `[]` |
+| leftButtons | 左侧按钮 | [`ButtonProps[]`](./buttons.md#buttonprops-配置) | `[]` |
+| actionButtons | 操作列按钮 | [`ButtonProps[]`](./buttons.md#buttonprops-配置) | `[]` |
+| add | 新增按钮回调 | `Function` | - |
+| showSelectionCol | 显示多选列 | `boolean` | `false` |
+| showSingleSelectionCol | 显示单选列 | `boolean` | `false` |
+| showIndexCol | 显示序号列 | `boolean` | `true` |
+| showOperationColumn | 显示操作列 | `boolean` | - |
+| minWidth | 列最小宽度 | `number \| string` | - |
+| actionColWidth | 操作列宽度 | `number \| string` | `200` |
+| formatColumns | 格式化列配置 | [`TableColumn[]`](./table.md#tablecolumn-配置) | `[]` |
+| offsetTop | 表格额外距离 | `number` | `0` |
+| isInitSearch | 是否初始化加载 | `boolean` | `true` |
+| tableProps | 表格额外属性 | `object` | - |
+| formProps | 表单额外属性 | `object` | - |
+| buttonsProps | 按钮组额外属性 | `object` | - |
+| name | 权限前缀 | `string` | - |
+| customColumnModule | 自定义列模块 | `string \| number` | - |
+
+::: warning 互斥关系
+`customColumnModule` 和以下配置是**互斥**的：
+- `columns`：设置了 `customColumnModule` 后会忽略 `columns`
+- `leftButtons` 中的"自定义列设置"按钮：组件会自动内置该按钮
+
+**正确用法**：
+- 启用自定义列：`customColumnModule: "moduleName"`（无需配 columns 和自定义列按钮）
+- 固定列模式：不设置 `customColumnModule`，使用 `columns` 配置
+:::
+| customColumnApi | 自定义列接口 | `string` | - |
+| customColumnSaveApi | 自定义列保存接口 | `string` | - |