el-plus 0.0.113 → 0.0.115

package/docs/hooks/use-navigation.md

@@ -1,131 +1,131 @@
-# useNavigation 导航
-
-提供路由导航、标签页管理和页面模式控制等功能。
-
-## 基本用法
-
-```vue
-<template>
-  <div>
-    <el-button @click="handleEdit">编辑</el-button>
-    <el-button @click="handleGoto">跳转新页面</el-button>
-    <el-button @click="handleClose">关闭当前页</el-button>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { useNavigation } from 'el-plus'
-
-const { $goto, $closeTag, mode, setMode, isBrowse, isEdit, isAdd } = useNavigation({
-  onModeChange: (newMode) => {
-    console.log('模式变化:', newMode)
-  }
-})
-
-// 编辑模式
-const handleEdit = () => {
-  setMode('edit')
-}
-
-// 跳转到新页面
-const handleGoto = () => {
-  $goto({
-    name: 'detail',
-    query: { id: '123' }
-  })
-}
-
-// 关闭当前标签页
-const handleClose = () => {
-  $closeTag()
-}
-</script>
-```
-
-## 参数
-
-### Config 配置
-
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| onModeChange | 模式变化时的回调函数 | `(mode: PageMode) => void` | - |
-
-## 返回值
-
-| 属性 | 说明 | 类型 |
-|------|------|------|
-| $goto | 打开新窗口或跳转路由 | `(config: NavigationConfig) => void` |
-| $closeTag | 关闭当前标签页 | `() => void` |
-| mode | 当前页面模式 | `ComputedRef<PageMode>` |
-| isBrowse | 是否为浏览模式 | `ComputedRef<boolean>` |
-| isEdit | 是否为编辑模式 | `ComputedRef<boolean>` |
-| isAdd | 是否为新增模式 | `ComputedRef<boolean>` |
-| setMode | 设置页面模式 | `(mode: PageMode, callback?: (mode: PageMode) => void) => void` |
-
-## 类型定义
-
-### PageMode
-
-```ts
-type PageMode = 'add' | 'edit' | 'browse'
-```
-
-### NavigationConfig
-
-```ts
-interface NavigationConfig {
-  id?: number | string    // 菜单id
-  name?: string           // 路由模块name，适用于内部跳转
-  title?: string          // 菜单名称，适用于传外部url跳转
-  url?: string            // 菜单url
-  query?: Record<string, any>  // url参数
-}
-```
-
-## 功能说明
-
-### $goto 路由跳转
-
-支持两种跳转方式：
-
-**内部路由跳转**
-
-```ts
-$goto({
-  name: 'userDetail',
-  query: { id: '123', mode: 'browse' }
-})
-```
-
-**外部URL跳转**
-
-```ts
-$goto({
-  url: 'https://example.com',
-  title: '外部链接'
-})
-```
-
-### setMode 模式切换
-
-用于详情页的模式切换，自动更新URL参数并触发回调。
-
-```ts
-// 切换到编辑模式
-setMode('edit')
-
-// 切换并执行回调
-setMode('edit', (mode) => {
-  console.log('已切换到编辑模式')
-})
-```
-
-### $closeTag 关闭标签页
-
-关闭当前标签页并自动切换到前一个标签页，需要在支持标签页管理的环境中使用。
-
-## 注意事项
-
-- 该 hook 依赖 `vue-router`，必须在路由环境中使用
-- `$closeTag` 方法依赖父窗口的标签页管理功能
-- `setMode` 会修改URL的query参数，刷新页面后模式会保持
+# useNavigation 导航
+
+提供路由导航、标签页管理和页面模式控制等功能。
+
+## 基本用法
+
+```vue
+<template>
+  <div>
+    <el-button @click="handleEdit">编辑</el-button>
+    <el-button @click="handleGoto">跳转新页面</el-button>
+    <el-button @click="handleClose">关闭当前页</el-button>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { useNavigation } from 'el-plus'
+
+const { $goto, $closeTag, mode, setMode, isBrowse, isEdit, isAdd } = useNavigation({
+  onModeChange: (newMode) => {
+    console.log('模式变化:', newMode)
+  }
+})
+
+// 编辑模式
+const handleEdit = () => {
+  setMode('edit')
+}
+
+// 跳转到新页面
+const handleGoto = () => {
+  $goto({
+    name: 'detail',
+    query: { id: '123' }
+  })
+}
+
+// 关闭当前标签页
+const handleClose = () => {
+  $closeTag()
+}
+</script>
+```
+
+## 参数
+
+### Config 配置
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| onModeChange | 模式变化时的回调函数 | `(mode: PageMode) => void` | - |
+
+## 返回值
+
+| 属性 | 说明 | 类型 |
+|------|------|------|
+| $goto | 打开新窗口或跳转路由 | `(config: NavigationConfig) => void` |
+| $closeTag | 关闭当前标签页 | `() => void` |
+| mode | 当前页面模式 | `ComputedRef<PageMode>` |
+| isBrowse | 是否为浏览模式 | `ComputedRef<boolean>` |
+| isEdit | 是否为编辑模式 | `ComputedRef<boolean>` |
+| isAdd | 是否为新增模式 | `ComputedRef<boolean>` |
+| setMode | 设置页面模式 | `(mode: PageMode, callback?: (mode: PageMode) => void) => void` |
+
+## 类型定义
+
+### PageMode
+
+```ts
+type PageMode = 'add' | 'edit' | 'browse'
+```
+
+### NavigationConfig
+
+```ts
+interface NavigationConfig {
+  id?: number | string    // 菜单id
+  name?: string           // 路由模块name，适用于内部跳转
+  title?: string          // 菜单名称，适用于传外部url跳转
+  url?: string            // 菜单url
+  query?: Record<string, any>  // url参数
+}
+```
+
+## 功能说明
+
+### $goto 路由跳转
+
+支持两种跳转方式：
+
+**内部路由跳转**
+
+```ts
+$goto({
+  name: 'userDetail',
+  query: { id: '123', mode: 'browse' }
+})
+```
+
+**外部URL跳转**
+
+```ts
+$goto({
+  url: 'https://example.com',
+  title: '外部链接'
+})
+```
+
+### setMode 模式切换
+
+用于详情页的模式切换，自动更新URL参数并触发回调。
+
+```ts
+// 切换到编辑模式
+setMode('edit')
+
+// 切换并执行回调
+setMode('edit', (mode) => {
+  console.log('已切换到编辑模式')
+})
+```
+
+### $closeTag 关闭标签页
+
+关闭当前标签页并自动切换到前一个标签页，需要在支持标签页管理的环境中使用。
+
+## 注意事项
+
+- 该 hook 依赖 `vue-router`，必须在路由环境中使用
+- `$closeTag` 方法依赖父窗口的标签页管理功能
+- `setMode` 会修改URL的query参数，刷新页面后模式会保持

package/docs/hooks/use-utils.md

@@ -1,162 +1,162 @@
-# useUtils 工具函数
-
-提供常用的工具函数集合，包括时间处理、文件操作、Cookie管理等。
-
-## 基本用法
-
-```vue
-<script setup lang="ts">
-import { useUtils } from 'el-plus'
-
-const {
-  getUnifyTime,
-  dayjs,
-  importFile,
-  downloadFile,
-  previewFile,
-  Cookies
-} = useUtils()
-
-// 时间格式化
-const time = getUnifyTime('2024-01-01')
-const formatted = dayjs().format('YYYY-MM-DD HH:mm:ss')
-
-// 文件导入
-importFile().then(file => {
-  console.log('导入的文件:', file)
-})
-
-// 文件下载
-downloadFile({ api: '/api/download', fileName: 'test.xlsx' })
-
-// 文件预览
-previewFile('/files/document.pdf')
-
-// Cookie 操作
-Cookies.set('token', 'xxx')
-const token = Cookies.get('token')
-</script>
-```
-
-## 返回值
-
-| 属性 | 说明 | 类型 |
-|------|------|------|
-| getUnifyTime | 统一时间处理函数 | `(time: string \| number \| Date) => string` |
-| dayjs | Day.js 实例 | `typeof dayjs` |
-| importFile | 文件导入函数 | `() => Promise<File>` |
-| downloadFile | 文件下载函数 | `(config: DownloadConfig) => Promise<void>` |
-| previewFile | 文件预览函数 | `(url: string) => void` |
-| Cookies | Cookie 操作对象 | `CookiesStatic` |
-
-## 功能说明
-
-### getUnifyTime 时间处理
-
-统一时间格式处理函数。
-
-```ts
-// 时间戳转格式化字符串
-const time1 = getUnifyTime(1609459200000)
-
-// Date对象转格式化字符串
-const time2 = getUnifyTime(new Date())
-
-// 字符串转格式化字符串
-const time3 = getUnifyTime('2024-01-01')
-```
-
-### dayjs 日期处理
-
-提供 Day.js 的所有功能，用于日期格式化和计算。
-
-```ts
-// 格式化当前时间
-const now = dayjs().format('YYYY-MM-DD HH:mm:ss')
-
-// 日期计算
-const tomorrow = dayjs().add(1, 'day')
-const lastMonth = dayjs().subtract(1, 'month')
-
-// 日期比较
-const isBefore = dayjs('2024-01-01').isBefore(dayjs())
-```
-
-### importFile 文件导入
-
-打开文件选择器，返回选择的文件对象。
-
-```ts
-importFile().then(file => {
-  console.log('文件名:', file.name)
-  console.log('文件大小:', file.size)
-  console.log('文件类型:', file.type)
-})
-```
-
-### downloadFile 文件下载
-
-触发文件下载，支持直接链接下载和 Blob 流式下载。
-
-```ts
-// 直接链接下载
-downloadFile({
-  src: '/files/document.pdf',
-  fileName: '文档.pdf'
-})
-
-// 接口下载（非 Blob，接口返回文件地址）
-downloadFile({
-  api: '/api/export',
-  fileName: '导出数据.xlsx',
-  data: { id: '123' }
-})
-
-// Blob 流式下载（接口返回二进制流）
-downloadFile({
-  api: '/api/export',
-  blob: true,
-  fileName: '导出数据.xlsx',
-  data: { id: '123' }
-})
-```
-
-当 `blob` 为 `true` 时，会以 `responseType: 'blob'` 发起请求，自动从响应头 `Content-Disposition` 中提取文件名，并创建 Blob URL 触发下载，下载完成后自动释放内存。
-
-### previewFile 文件预览
-
-在新窗口中预览文件。
-
-```ts
-// PDF预览
-previewFile('/files/document.pdf')
-
-// 图片预览
-previewFile('/images/photo.jpg')
-```
-
-### Cookies Cookie管理
-
-提供 Cookie 的增删改查操作。
-
-```ts
-// 设置 Cookie
-Cookies.set('token', 'xxx', { expires: 7 }) // 7天后过期
-
-// 获取 Cookie
-const token = Cookies.get('token')
-
-// 删除 Cookie
-Cookies.remove('token')
-
-// 获取所有 Cookie
-const allCookies = Cookies.get()
-```
-
-## 注意事项
-
-- `importFile` 会打开系统文件选择器
-- `downloadFile` 支持跨域下载，会自动处理 blob 响应
-- `downloadFile` 的 `blob` 模式适用于接口直接返回二进制流的场景，会自动从 `Content-Disposition` 响应头提取文件名；若未指定 `fileName` 且响应头中也无文件名信息，可能导致文件名缺失
-- `previewFile` 会打开新窗口或标签页
-- `Cookies` 基于 js-cookie 库，支持所有其配置选项
+# useUtils 工具函数
+
+提供常用的工具函数集合，包括时间处理、文件操作、Cookie管理等。
+
+## 基本用法
+
+```vue
+<script setup lang="ts">
+import { useUtils } from 'el-plus'
+
+const {
+  getUnifyTime,
+  dayjs,
+  importFile,
+  downloadFile,
+  previewFile,
+  Cookies
+} = useUtils()
+
+// 时间格式化
+const time = getUnifyTime('2024-01-01')
+const formatted = dayjs().format('YYYY-MM-DD HH:mm:ss')
+
+// 文件导入
+importFile().then(file => {
+  console.log('导入的文件:', file)
+})
+
+// 文件下载
+downloadFile({ api: '/api/download', fileName: 'test.xlsx' })
+
+// 文件预览
+previewFile('/files/document.pdf')
+
+// Cookie 操作
+Cookies.set('token', 'xxx')
+const token = Cookies.get('token')
+</script>
+```
+
+## 返回值
+
+| 属性 | 说明 | 类型 |
+|------|------|------|
+| getUnifyTime | 统一时间处理函数 | `(time: string \| number \| Date) => string` |
+| dayjs | Day.js 实例 | `typeof dayjs` |
+| importFile | 文件导入函数 | `() => Promise<File>` |
+| downloadFile | 文件下载函数 | `(config: DownloadConfig) => Promise<void>` |
+| previewFile | 文件预览函数 | `(url: string) => void` |
+| Cookies | Cookie 操作对象 | `CookiesStatic` |
+
+## 功能说明
+
+### getUnifyTime 时间处理
+
+统一时间格式处理函数。
+
+```ts
+// 时间戳转格式化字符串
+const time1 = getUnifyTime(1609459200000)
+
+// Date对象转格式化字符串
+const time2 = getUnifyTime(new Date())
+
+// 字符串转格式化字符串
+const time3 = getUnifyTime('2024-01-01')
+```
+
+### dayjs 日期处理
+
+提供 Day.js 的所有功能，用于日期格式化和计算。
+
+```ts
+// 格式化当前时间
+const now = dayjs().format('YYYY-MM-DD HH:mm:ss')
+
+// 日期计算
+const tomorrow = dayjs().add(1, 'day')
+const lastMonth = dayjs().subtract(1, 'month')
+
+// 日期比较
+const isBefore = dayjs('2024-01-01').isBefore(dayjs())
+```
+
+### importFile 文件导入
+
+打开文件选择器，返回选择的文件对象。
+
+```ts
+importFile().then(file => {
+  console.log('文件名:', file.name)
+  console.log('文件大小:', file.size)
+  console.log('文件类型:', file.type)
+})
+```
+
+### downloadFile 文件下载
+
+触发文件下载，支持直接链接下载和 Blob 流式下载。
+
+```ts
+// 直接链接下载
+downloadFile({
+  src: '/files/document.pdf',
+  fileName: '文档.pdf'
+})
+
+// 接口下载（非 Blob，接口返回文件地址）
+downloadFile({
+  api: '/api/export',
+  fileName: '导出数据.xlsx',
+  data: { id: '123' }
+})
+
+// Blob 流式下载（接口返回二进制流）
+downloadFile({
+  api: '/api/export',
+  blob: true,
+  fileName: '导出数据.xlsx',
+  data: { id: '123' }
+})
+```
+
+当 `blob` 为 `true` 时，会以 `responseType: 'blob'` 发起请求，自动从响应头 `Content-Disposition` 中提取文件名，并创建 Blob URL 触发下载，下载完成后自动释放内存。
+
+### previewFile 文件预览
+
+在新窗口中预览文件。
+
+```ts
+// PDF预览
+previewFile('/files/document.pdf')
+
+// 图片预览
+previewFile('/images/photo.jpg')
+```
+
+### Cookies Cookie管理
+
+提供 Cookie 的增删改查操作。
+
+```ts
+// 设置 Cookie
+Cookies.set('token', 'xxx', { expires: 7 }) // 7天后过期
+
+// 获取 Cookie
+const token = Cookies.get('token')
+
+// 删除 Cookie
+Cookies.remove('token')
+
+// 获取所有 Cookie
+const allCookies = Cookies.get()
+```
+
+## 注意事项
+
+- `importFile` 会打开系统文件选择器
+- `downloadFile` 支持跨域下载，会自动处理 blob 响应
+- `downloadFile` 的 `blob` 模式适用于接口直接返回二进制流的场景，会自动从 `Content-Disposition` 响应头提取文件名；若未指定 `fileName` 且响应头中也无文件名信息，可能导致文件名缺失
+- `previewFile` 会打开新窗口或标签页
+- `Cookies` 基于 js-cookie 库，支持所有其配置选项

package/docs/index.md

@@ -1,25 +1,25 @@
----
-# https://vitepress.dev/reference/default-theme-home-page
-layout: home
-
-hero:
-  name: "el-plus-docs"
-  text: "宏信组件文档"
-  tagline: 快速生成 Vue 页面和组件
-  actions:
-    - theme: brand
-      text: 组件库总览
-      link: /overview
-    - theme: alt
-      text: 更新日志
-      link: /CHANGELOG
-
-features:
-  - title: 📄 列表页
-    details: 快速生成包含搜索、表格、操作按钮的列表页面
-  - title: 📝 详情页
-    details: 灵活组合表单、明细表格、附件等组件
-  - title: 🧩 组件库
-    details: 丰富的业务组件，支持自由组合配置
----
-
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+
+hero:
+  name: "el-plus-docs"
+  text: "宏信组件文档"
+  tagline: 快速生成 Vue 页面和组件
+  actions:
+    - theme: brand
+      text: 组件库总览
+      link: /overview
+    - theme: alt
+      text: 更新日志
+      link: /CHANGELOG
+
+features:
+  - title: 📄 列表页
+    details: 快速生成包含搜索、表格、操作按钮的列表页面
+  - title: 📝 详情页
+    details: 灵活组合表单、明细表格、附件等组件
+  - title: 🧩 组件库
+    details: 丰富的业务组件，支持自由组合配置
+---
+