el-plus 0.0.92 → 0.0.94

package/dist/index.full.mjs

@@ -1,4 +1,4 @@
-/*! ElPlus v0.0.92 */
+/*! ElPlus v0.0.94 */
 
 import { useAttrs, getCurrentInstance, inject, provide, ref, nextTick, defineComponent, computed, createVNode, Fragment, withDirectives, resolveComponent, mergeProps, resolveDirective, useTemplateRef, reactive, onBeforeUpdate, createTextVNode, h, mergeModels, useModel, createElementBlock, openBlock, normalizeStyle, normalizeClass, unref, createCommentVNode, withCtx, renderSlot, renderList, createBlock, vShow, toDisplayString, useSlots, watch, onMounted, createSlots, normalizeProps, guardReactiveProps, markRaw, Transition, shallowReactive, isVNode, render, createElementVNode, toRaw } from 'vue';
 import { buttonProps, useLocale as useLocale$1, ElLoading, ElMessage, ElMessageBox, formProps as formProps$1, formEmits as formEmits$1, ElTooltip, formItemProps as formItemProps$1, ElFormItem, ElForm, ElRow, ElCol, inputProps as inputProps$1, inputEmits as inputEmits$1, configProviderContextKey, ElConfigProvider, ElDialog, ElButton, ElTable, ElIcon, selectProps as selectProps$1, selectEmits as selectEmits$1, ElPageHeader, datePickerProps, linkProps as linkProps$1, ElSkeleton } from 'element-plus';
@@ -2587,7 +2587,8 @@ const searchListPageProps = {
   },
   // 左侧按钮
   leftButtons: {
-    ...buttonsProps.list
+    type: Array,
+    default: () => []
   },
   // 表格列
   columns: {
@@ -3521,9 +3522,6 @@ async function downloadFile({
     ...config
   }).then((res) => {
     const { headers } = res;
-    if (!res.data.success) {
-      return ElMessage.error(res.data.msg);
-    }
     const data2 = res.data?.data || res.data?.data?.url || "";
     const lowerHeaders = {};
     for (const key in headers) {
@@ -4485,7 +4483,7 @@ var components = [
   EpFooterInfo
 ];
 
-var version = "0.0.92";
+var version = "0.0.94";
 
 var globalProperties = {
   install(app) {

package/docs/components/select.md

@@ -64,11 +64,11 @@ const formItemList = [
 
 ```tsx
 {
-  prop: 'companyCode',
-  label: '公司',
+  prop: 'testCode',
+  label: '测试',
   type: 'EpSelect',
   props: {
-    api: '/api/company/list',
+    api: '/test',
     valueKey: 'code',
     labelKey: 'name',
   },
@@ -78,11 +78,11 @@ const formItemList = [
 ## 远程搜索
 ```tsx
 {
-  prop: 'companyCode',
-  label: '公司',
+  prop: 'testCode',
+  label: '测试',
   type: 'EpSelect',
   props: {
-    api: '/api/company/list',
+    api: '/test',
     valueKey: 'code',
     labelKey: 'name',
     remote: true,
@@ -96,11 +96,11 @@ const formItemList = [
 - 适用于有code，但配置为remote/lazy，导致没有name的情况
 ```tsx
 {
-  prop: 'companyCode',
-  label: '公司',
+  prop: 'testCode',
+  label: '测试',
   type: 'EpSelect',
   props: {
-    api: '/api/company/list',
+    api: '/test',
     valueKey: 'code',
     labelKey: 'name',
     lazy: true,
@@ -113,11 +113,11 @@ const formItemList = [
 
 ```tsx
 {
-  prop: 'companyCode',
-  label: '公司',
+  prop: 'testCode',
+  label: '测试',
   type: 'EpSelect',
   props: {
-    api: '/api/company/list',
+    api: '/test',
     valueKey: 'code',
     labelKey: 'name',
     formatLabel: (item) => `${item.name} (${item.code})`,
@@ -129,8 +129,8 @@ const formItemList = [
 
 ```tsx
 {
-  prop: 'companyCode',
-  label: '公司',
+  prop: 'testCode',
+  label: '测试',
   type: 'EpSelect',
   props: {
     options: [],
@@ -138,7 +138,7 @@ const formItemList = [
   onChange: (value, item) => {
     // value: 选中的值
     // item: 选中的选项对象
-    formData.companyName = item?.name
+    formData.testName = item?.name
   },
 }
 ```
@@ -149,15 +149,101 @@ const formItemList = [
 
 ```tsx
 {
-  prop: 'itemCode',
-  label: '商品',
+  prop: 'testCode',
+  label: '测试',
   type: 'EpSelect',
   props: {
-    api: '/api/item/list',
+    api: '/test',
     valueKey: 'code',
     labelKey: 'name',
     codeInLabel: true, // 显示为 "name code"
-    // codeInLabel: 'itemCode', // 显示为 "name itemCode字段值"
+    // codeInLabel: 'testCode', // 显示为 "name testCode字段值"
   },
 }
 ```
+
+## 常用场景
+
+```tsx
+// 公司 - 简单接口选择
+{
+  prop: 'companyCode',
+  label: '公司',
+  type: 'EpSelect',
+  props: {
+    api: '/api-pms-order/api/common/queryAllCompany',
+    method: 'post',
+    labelKey: 'name',
+    valueKey: 'code',
+  },
+}
+
+// 币种 - 简单接口选择
+{
+  prop: 'currencyCode',
+  label: '币种',
+  type: 'EpSelect',
+  props: {
+    api: '/api-finance-base/api/finance/base/currency/queryList',
+    method: 'post',
+    labelKey: 'name',
+    valueKey: 'code',
+  },
+}
+
+// 账套 - 简单接口选择
+{
+  prop: 'accountSetCode',
+  label: '账套',
+  type: 'EpSelect',
+  props: {
+    api: '/api-globalization/api/accountSet/queryLatestVerAccountSet',
+    labelKey: 'accountSetName',
+    valueKey: 'accountSetCode',
+  },
+}
+
+// 仓库 - 远程搜索（数据量大，输入关键词搜索）
+{
+  prop: 'warehouseCode',
+  label: '仓库',
+  type: 'EpSelect',
+  props: {
+    api: '/api-wms/api/warehouse/search/list',
+    method: 'post',
+    remote: true,
+    filterable: true,
+    reqData: {
+      statusList: [1],
+      name: '$query',
+      pageNum: 1,
+      pageSize: 20,
+    },
+    labelKey: 'name',
+    valueKey: 'code',
+  },
+}
+
+// 人员 - 远程搜索 + 自定义格式（同时展示编码和名称）
+{
+  prop: 'personAccount',
+  label: '人员',
+  type: 'EpSelect',
+  props: {
+    api: '/api-u/api/saas/user/personInfoManage/queryPersonInfoPage',
+    method: 'post',
+    remote: true,
+    filterable: true,
+    reqData: {
+      page: 1,
+      pageSize: 20,
+      searchText: '$query',
+    },
+    labelKey: 'name',
+    valueKey: 'account',
+    formatLabel: (item) => `${item.account || ''} ${item.name || ''}`,
+  },
+}
+```
+
+> `reqData` 中 `$query` 为占位符，组件会自动替换为用户输入的搜索关键词。

package/docs/hooks/use-utils.md

@@ -27,7 +27,7 @@ importFile().then(file => {
 })
 
 // 文件下载
-downloadFile({ url: '/api/download', filename: 'test.xlsx' })
+downloadFile({ api: '/api/download', fileName: 'test.xlsx' })
 
 // 文件预览
 previewFile('/files/document.pdf')
@@ -45,7 +45,7 @@ const token = Cookies.get('token')
 | getUnifyTime | 统一时间处理函数 | `(time: string \| number \| Date) => string` |
 | dayjs | Day.js 实例 | `typeof dayjs` |
 | importFile | 文件导入函数 | `() => Promise<File>` |
-| downloadFile | 文件下载函数 | `(config: DownloadConfig) => void` |
+| downloadFile | 文件下载函数 | `(config: DownloadConfig) => Promise<void>` |
 | previewFile | 文件预览函数 | `(url: string) => void` |
 | Cookies | Cookie 操作对象 | `CookiesStatic` |
 
@@ -96,16 +96,33 @@ importFile().then(file => {
 
 ### downloadFile 文件下载
 
-触发文件下载。
+触发文件下载，支持直接链接下载和 Blob 流式下载。
 
 ```ts
+// 直接链接下载
 downloadFile({
-  url: '/api/export',
-  filename: '导出数据.xlsx',
-  params: { id: '123' }  // 可选的请求参数
+  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 文件预览
 
 在新窗口中预览文件。
@@ -140,5 +157,6 @@ const allCookies = Cookies.get()
 
 - `importFile` 会打开系统文件选择器
 - `downloadFile` 支持跨域下载，会自动处理 blob 响应
+- `downloadFile` 的 `blob` 模式适用于接口直接返回二进制流的场景，会自动从 `Content-Disposition` 响应头提取文件名；若未指定 `fileName` 且响应头中也无文件名信息，可能导致文件名缺失
 - `previewFile` 会打开新窗口或标签页
 - `Cookies` 基于 js-cookie 库，支持所有其配置选项

package/es/components/buttons/index.d.ts

@@ -1,20 +1,7 @@
 export declare const EpButtons: {
     new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<import("vue").ExtractPropTypes<{
         readonly list: {
-            readonly type: import("vue").PropType<Partial<Omit<import("element-plus").ButtonProps, "disabled"> & {
-                name: string;
-                prop: string;
-                permission: string;
-                onClick: (e: MouseEvent | import("el-plus/es").TableScope) => void;
-                scopedSlots: Record<string, () => import("vue").VNode>;
-                disabled: import("el-plus/es/utils").IDisabled;
-                confirm: boolean;
-                confirmText: string;
-                confirmBefore: () => Promise<void>;
-            } & {} & {
-                show?: (boolean | ((T: unknown) => boolean)) | undefined;
-                hide?: (boolean | ((T: unknown) => boolean)) | undefined;
-            }>[]>;
+            readonly type: import("vue").PropType<import("./src/buttons").ButtonProps[]>;
             readonly default: () => never[];
         };
         readonly size: {
@@ -64,7 +51,7 @@ export declare const EpButtons: {
             disabled: import("el-plus/es/utils").IDisabled;
             confirm: boolean;
             confirmText: string;
-            confirmBefore: () => Promise<void>;
+            confirmBefore: (e: MouseEvent | import("el-plus/es").TableScope) => Promise<void>;
         } & {} & {
             show?: (boolean | ((T: unknown) => boolean)) | undefined;
             hide?: (boolean | ((T: unknown) => boolean)) | undefined;
@@ -99,20 +86,7 @@ export declare const EpButtons: {
         Defaults: {};
     }, Readonly<import("vue").ExtractPropTypes<{
         readonly list: {
-            readonly type: import("vue").PropType<Partial<Omit<import("element-plus").ButtonProps, "disabled"> & {
-                name: string;
-                prop: string;
-                permission: string;
-                onClick: (e: MouseEvent | import("el-plus/es").TableScope) => void;
-                scopedSlots: Record<string, () => import("vue").VNode>;
-                disabled: import("el-plus/es/utils").IDisabled;
-                confirm: boolean;
-                confirmText: string;
-                confirmBefore: () => Promise<void>;
-            } & {} & {
-                show?: (boolean | ((T: unknown) => boolean)) | undefined;
-                hide?: (boolean | ((T: unknown) => boolean)) | undefined;
-            }>[]>;
+            readonly type: import("vue").PropType<import("./src/buttons").ButtonProps[]>;
             readonly default: () => never[];
         };
         readonly size: {
@@ -162,7 +136,7 @@ export declare const EpButtons: {
             disabled: import("el-plus/es/utils").IDisabled;
             confirm: boolean;
             confirmText: string;
-            confirmBefore: () => Promise<void>;
+            confirmBefore: (e: MouseEvent | import("el-plus/es").TableScope) => Promise<void>;
         } & {} & {
             show?: (boolean | ((T: unknown) => boolean)) | undefined;
             hide?: (boolean | ((T: unknown) => boolean)) | undefined;
@@ -238,7 +212,7 @@ export declare const EpButtons: {
         disabled: import("el-plus/es/utils").IDisabled;
         confirm: boolean;
         confirmText: string;
-        confirmBefore: () => Promise<void>;
+        confirmBefore: (e: MouseEvent | import("el-plus/es").TableScope) => Promise<void>;
     } & {} & {
         show?: (boolean | ((T: unknown) => boolean)) | undefined;
         hide?: (boolean | ((T: unknown) => boolean)) | undefined;

package/es/components/buttons/src/buttons-vue.d.ts

@@ -93,7 +93,7 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         disabled: import("el-plus/es/utils/props").IDisabled;
         confirm: boolean;
         confirmText: string;
-        confirmBefore: () => Promise<void>;
+        confirmBefore: (e: MouseEvent | import("el-plus/es").TableScope) => Promise<void>;
     } & {} & {
         show?: (boolean | ((T: unknown) => boolean)) | undefined;
         hide?: (boolean | ((T: unknown) => boolean)) | undefined;

package/es/components/buttons/src/buttons.d.ts

@@ -2,16 +2,16 @@ import type { PropType, ExtractPublicPropTypes, VNode } from 'vue';
 import { type ButtonProps as ElButtonProps } from 'element-plus';
 import type { VisibleProps, IDisabled } from 'el-plus/es/utils/props';
 import type { TableScope } from 'el-plus/es/components/table';
-export type ButtonProps = Partial<Omit<ElButtonProps, 'disabled'> & {
+export type ButtonProps<TClickArg = MouseEvent | TableScope> = Partial<Omit<ElButtonProps, 'disabled'> & {
     name: string;
     prop: string;
     permission: string;
-    onClick: (e: MouseEvent | TableScope) => void;
+    onClick: (e: TClickArg) => void;
     scopedSlots: Record<string, () => VNode>;
     disabled: IDisabled;
     confirm: boolean;
     confirmText: string;
-    confirmBefore: () => Promise<void>;
+    confirmBefore: (e: TClickArg) => Promise<void>;
 } & VisibleProps>;
 export declare const buttonsProps: {
     readonly list: {

package/es/components/buttons/src/buttons.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"buttons.mjs","sources":["../../../../../../packages/components/buttons/src/buttons.ts"],"sourcesContent":["import type { PropType, ExtractPublicPropTypes, VNode } from 'vue'\nimport {\n  buttonProps as elButtonProps,\n  // buttonEmits as elButtonEmits,\n  type ButtonProps as ElButtonProps,\n} from 'element-plus'\nimport { disabledProps } from '@el-plus/utils/props'\nimport type { VisibleProps, IDisabled } from '@el-plus/utils/props'\nimport type { TableScope } from '@el-plus/components/table'\n\nexport type ButtonProps = Partial<\n  Omit<ElButtonProps, 'disabled'> & {\n    name: string\n    prop: string // 唯一标识\n    permission: string // 权限\n    onClick: (e: MouseEvent | TableScope) => void\n    scopedSlots: Record<string, () => VNode>\n    disabled: IDisabled\n    confirm: boolean\n    confirmText: string\n    confirmBefore: () => Promise<void>\n  } & VisibleProps\n>\nexport const buttonsProps = {\n  ...elButtonProps,\n  ...disabledProps,\n  list: {\n    type: Array as PropType<ButtonProps[]>,\n    default: () => [],\n  },\n  size: {\n    ...elButtonProps.size,\n    default: 'small',\n  },\n  type: {\n    ...elButtonProps.type,\n    default: 'default',\n  },\n} as const\nexport type ButtonsProps = ExtractPublicPropTypes<typeof buttonsProps>\n// export const buttonsEmits = {\n//   ...elButtonEmits,\n// }\n// export type ButtonsEmits = typeof buttonsEmits\n// export const buttonsEmitsKeys = Object.keys(buttonsEmits)\n"],"names":["elButtonProps"],"mappings":";;;AAuBO,MAAM,YAAA,GAAe;AAAA,EAC1B,GAAGA,WAAA;AAAA,EACH,GAAG,aAAA;AAAA,EACH,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,KAAA;AAAA,IACN,OAAA,EAAS,MAAM;AAAC,GAClB;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,GAAGA,WAAA,CAAc,IAAA;AAAA,IACjB,OAAA,EAAS;AAAA,GACX;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,GAAGA,WAAA,CAAc,IAAA;AAAA,IACjB,OAAA,EAAS;AAAA;AAEb;;;;"}
+{"version":3,"file":"buttons.mjs","sources":["../../../../../../packages/components/buttons/src/buttons.ts"],"sourcesContent":["import type { PropType, ExtractPublicPropTypes, VNode } from 'vue'\nimport {\n  buttonProps as elButtonProps,\n  // buttonEmits as elButtonEmits,\n  type ButtonProps as ElButtonProps,\n} from 'element-plus'\nimport { disabledProps } from '@el-plus/utils/props'\nimport type { VisibleProps, IDisabled } from '@el-plus/utils/props'\nimport type { TableScope } from '@el-plus/components/table'\n\nexport type ButtonProps<TClickArg = MouseEvent | TableScope> = Partial<\n  Omit<ElButtonProps, 'disabled'> & {\n    name: string\n    prop: string // 唯一标识\n    permission: string // 权限\n    onClick: (e: TClickArg) => void\n    scopedSlots: Record<string, () => VNode>\n    disabled: IDisabled\n    confirm: boolean\n    confirmText: string\n    confirmBefore: (e: TClickArg) => Promise<void>\n  } & VisibleProps\n>\nexport const buttonsProps = {\n  ...elButtonProps,\n  ...disabledProps,\n  list: {\n    type: Array as PropType<ButtonProps[]>,\n    default: () => [],\n  },\n  size: {\n    ...elButtonProps.size,\n    default: 'small',\n  },\n  type: {\n    ...elButtonProps.type,\n    default: 'default',\n  },\n} as const\nexport type ButtonsProps = ExtractPublicPropTypes<typeof buttonsProps>\n// export const buttonsEmits = {\n//   ...elButtonEmits,\n// }\n// export type ButtonsEmits = typeof buttonsEmits\n// export const buttonsEmitsKeys = Object.keys(buttonsEmits)\n"],"names":["elButtonProps"],"mappings":";;;AAuBO,MAAM,YAAA,GAAe;AAAA,EAC1B,GAAGA,WAAA;AAAA,EACH,GAAG,aAAA;AAAA,EACH,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,KAAA;AAAA,IACN,OAAA,EAAS,MAAM;AAAC,GAClB;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,GAAGA,WAAA,CAAc,IAAA;AAAA,IACjB,OAAA,EAAS;AAAA,GACX;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,GAAGA,WAAA,CAAc,IAAA;AAAA,IACjB,OAAA,EAAS;AAAA;AAEb;;;;"}

package/es/components/header/index.d.ts

@@ -8,20 +8,7 @@ export declare const EpHeader: {
             readonly default: true;
         };
         readonly buttons: {
-            readonly type: import("vue").PropType<Partial<Omit<import("element-plus").ButtonProps, "disabled"> & {
-                name: string;
-                prop: string;
-                permission: string;
-                onClick: (e: MouseEvent | import("el-plus/es/index").TableScope) => void;
-                scopedSlots: Record<string, () => import("vue").VNode>;
-                disabled: import("el-plus/es/utils/props").IDisabled;
-                confirm: boolean;
-                confirmText: string;
-                confirmBefore: () => Promise<void>;
-            } & {} & {
-                show?: (boolean | ((T: unknown) => boolean)) | undefined;
-                hide?: (boolean | ((T: unknown) => boolean)) | undefined;
-            }>[]>;
+            readonly type: import("vue").PropType<import("el-plus/es/index").ButtonProps[]>;
             readonly default: () => never[];
         };
         readonly name: StringConstructor;
@@ -51,7 +38,7 @@ export declare const EpHeader: {
             disabled: import("el-plus/es/utils/props").IDisabled;
             confirm: boolean;
             confirmText: string;
-            confirmBefore: () => Promise<void>;
+            confirmBefore: (e: MouseEvent | import("el-plus/es/index").TableScope) => Promise<void>;
         } & {} & {
             show?: (boolean | ((T: unknown) => boolean)) | undefined;
             hide?: (boolean | ((T: unknown) => boolean)) | undefined;
@@ -98,20 +85,7 @@ export declare const EpHeader: {
             readonly default: true;
         };
         readonly buttons: {
-            readonly type: import("vue").PropType<Partial<Omit<import("element-plus").ButtonProps, "disabled"> & {
-                name: string;
-                prop: string;
-                permission: string;
-                onClick: (e: MouseEvent | import("el-plus/es/index").TableScope) => void;
-                scopedSlots: Record<string, () => import("vue").VNode>;
-                disabled: import("el-plus/es/utils/props").IDisabled;
-                confirm: boolean;
-                confirmText: string;
-                confirmBefore: () => Promise<void>;
-            } & {} & {
-                show?: (boolean | ((T: unknown) => boolean)) | undefined;
-                hide?: (boolean | ((T: unknown) => boolean)) | undefined;
-            }>[]>;
+            readonly type: import("vue").PropType<import("el-plus/es/index").ButtonProps[]>;
             readonly default: () => never[];
         };
         readonly name: StringConstructor;
@@ -141,7 +115,7 @@ export declare const EpHeader: {
             disabled: import("el-plus/es/utils/props").IDisabled;
             confirm: boolean;
             confirmText: string;
-            confirmBefore: () => Promise<void>;
+            confirmBefore: (e: MouseEvent | import("el-plus/es/index").TableScope) => Promise<void>;
         } & {} & {
             show?: (boolean | ((T: unknown) => boolean)) | undefined;
             hide?: (boolean | ((T: unknown) => boolean)) | undefined;
@@ -215,7 +189,7 @@ export declare const EpHeader: {
         disabled: import("el-plus/es/utils/props").IDisabled;
         confirm: boolean;
         confirmText: string;
-        confirmBefore: () => Promise<void>;
+        confirmBefore: (e: MouseEvent | import("el-plus/es/index").TableScope) => Promise<void>;
     } & {} & {
         show?: (boolean | ((T: unknown) => boolean)) | undefined;
         hide?: (boolean | ((T: unknown) => boolean)) | undefined;

package/es/components/header/src/header.vue.d.ts

@@ -66,7 +66,7 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         disabled: import("el-plus/es/utils/props").IDisabled;
         confirm: boolean;
         confirmText: string;
-        confirmBefore: () => Promise<void>;
+        confirmBefore: (e: MouseEvent | import("el-plus/es").TableScope) => Promise<void>;
     } & {} & {
         show?: (boolean | ((T: unknown) => boolean)) | undefined;
         hide?: (boolean | ((T: unknown) => boolean)) | undefined;