@wyfex/ivue 0.19.4 → 0.21.0

package/src/components/UseElConfigProvider/types.ts

@@ -11,34 +11,26 @@ export type Props = ExtractPropTypes<typeof componentProps>
  * extConfig接口
  */
 export interface ExtConfig {
-  /**
-   * 字典属性配置项
-   */
+  /** 字典属性配置项 */
   dictProps?: DictProps
-  /**
-   * crud配置项
-   * pageHeight：crud表格页面高度 extConfig.mode.type='PAGE'时生效，显式设置则表格自适应高度不生效，否则默认使用表格自适应高度
-   * modalHeight：crud表格弹窗高度 extConfig.mode.type='MODAL'时生效，显式设置则表格自适应高度不生效，否则默认使用表格自适应高度
-   */
+  /** crud配置项 */
   crud?: {
+    /** crud表格页面高度 extConfig.mode.type='PAGE'时生效，显式设置则表格自适应高度不生效，否则默认使用表格自适应高度 */
     pageHeight?: string
+    /** crud表格弹窗高度 extConfig.mode.type='MODAL'时生效，显式设置则表格自适应高度不生效，否则默认使用表格自适应高度 */
     modalHeight?: string
   }
-  /**
-   * 表格配置项
-   * pageHeight：表格页面高度 extConfig.mode.type='PAGE'时生效，显式设置则表格自适应高度不生效，否则默认使用表格自适应高度
-   * modalHeight：表格弹窗高度 extConfig.mode.type='MODAL'时生效，显式设置则表格自适应高度不生效，否则默认使用表格自适应高度
-   * pageBottomOffset：表格页面底部预留偏移
-   * modalBottomOffset：表格弹窗底部预留偏移
-   */
+  /** 表格配置项 */
   table?: {
+    /** 表格页面高度 extConfig.mode.type='PAGE'时生效，显式设置则表格自适应高度不生效，否则默认使用表格自适应高度 */
     pageHeight?: string
+    /** 表格弹窗高度 extConfig.mode.type='MODAL'时生效，显式设置则表格自适应高度不生效，否则默认使用表格自适应高度 */
     modalHeight?: string
+    /** 表格页面底部预留偏移 */
     pageBottomOffset?: number
+    /** 表格弹窗底部预留偏移 */
     modalBottomOffset?: number
   }
-  /**
-   * 上传配置项
-   */
+  /** 上传配置项 */
   upload?: UploadConfig
 }

package/src/components/UseElDatePicker/types.ts

@@ -7,9 +7,9 @@ import componentProps from './props'
 export type Props = ExtractPropTypes<typeof componentProps>
 
 /**
- * emits接口
+ * emits类型
  */
-export interface Emits {
-  // 更新value值
+export type Emits = {
+  /** 更新value值 */
   (e: 'update:modelValue', value: string | number | any[]): void
 }

package/src/components/UseElDialog/props.ts

@@ -17,11 +17,18 @@ export default {
     default: true
   },
   /**
-   * el-dialog内容区域最大高度
+   * el-dialog CSS 中的 margin-top 值 默认12dvh
+   */
+  top: {
+    type: String,
+    default: '12dvh'
+  },
+  /**
+   * el-dialog内容区域最大高度 默认为autoMax，内部自动根据浏览器高度进行计算最大高度
    */
   maxHeight: {
     type: [String, Number],
-    default: ''
+    default: 'autoCalcMaxHeight'
   },
   /**
    * el-scrollbar不响应容器尺寸变化，如果容器尺寸不会发生变化，最好设置它可以优化性能
@@ -108,6 +115,13 @@ export default {
     type: String,
     default: '取消'
   },
+  /**
+   * 确定按钮loading状态
+   */
+  confirmLoading: {
+    type: Boolean,
+    default: false
+  },
   /**
    * 取消按钮类型
    */

package/src/components/UseElDrawer/props.ts

@@ -87,6 +87,13 @@ export default {
     type: String,
     default: '取消'
   },
+  /**
+   * 确定按钮loading状态
+   */
+  confirmLoading: {
+    type: Boolean,
+    default: false
+  },
   /**
    * 取消按钮类型 同ElButton类型
    */

package/src/components/UseElForm/types.ts

@@ -11,9 +11,7 @@ export type Props = ExtractPropTypes<typeof componentProps>
  * emits类型
  */
 export type Emits = {
-  /**
-   * dictKeys事件
-   */
+  /** dictKeys事件 */
   (e: 'onDictKeys', value?: string[]): void
 }
 
@@ -369,15 +367,10 @@ export interface FormColumn {
   label?: string
   /**
    * el-form-item的prop
+   * 一般情况下为必传 为适配UseCrud组件类型特将此属性设置为非必传
    * 可传以逗号分隔的字符串，组件内部自动拆解，如'startDate,endDate' => { startDate: xxx, endDate: yyy }
    */
-  prop: string
-  /**
-   * 查询prop
-   * 当查询表单（如起止时间字段拆分）和列表prop字段不一致时传入该配置项
-   * 可传以逗号分隔的字符串，组件内部自动拆解，亦可传入字符串数组
-   */
-  queryProp?: string | string[]
+  prop?: string
   /**
    * 是否为必填项
    * 如为boolean则使用基础必填校验

package/src/components/UseElTable/types.ts

@@ -11,25 +11,15 @@ export type Props = ExtractPropTypes<typeof componentProps>
  * emits类型
  */
 export type Emits = {
-  /**
-   * dictKeys事件
-   */
+  /** dictKeys事件 */
   (e: 'onDictKeys', value?: string[]): void
-  /**
-   * 选中数据更新事件 v-model:selectionData
-   */
+  /** 选中数据更新事件 v-model:selectionData */
   (e: 'update:selectionData', selectionData: any[]): void
-  /**
-   * 当前行更新事件 v-model:currentRow
-   */
+  /** 当前行更新事件 v-model:currentRow */
   (e: 'update:currentRow', currentRow: any): void
-  /**
-   * 当前页码更新事件 v-model:currentPage
-   */
+  /** 当前页码更新事件 v-model:currentPage */
   (e: 'update:currentPage', currentPage: number): void
-  /**
-   * 每页条数更新事件 v-model:pageSize
-   */
+  /** 每页条数更新事件 v-model:pageSize */
   (e: 'update:pageSize', pageSize: number): void
 }
 
@@ -37,21 +27,13 @@ export type Emits = {
  * EditableCell和SpanVue组件的props接口
  */
 export interface EditableCellAndSpanVueProps {
-  /**
-   * 行数据
-   */
+  /** 行数据 */
   row: Record<string, any>
-  /**
-   * 表格配置项
-   */
+  /** 表格配置项 */
   item: TableColumn
-  /**
-   * 合并后的props
-   */
+  /** 合并后的props */
   mergedProps: Props
-  /**
-   * 全局配置
-   */
+  /** 全局配置 */
   globalConfig: GlobalConfig
 }
 
@@ -59,17 +41,11 @@ export interface EditableCellAndSpanVueProps {
  * 表头配置接口
  */
 export interface Header {
-  /**
-   * 表头具名插槽 为true则在模板代码中添加`<template #prop-header="{ item }"></template>`即可，可传入string自定义具名插槽名称
-   */
+  /** 表头具名插槽 为true则在模板代码中添加`<template #prop-header="{ item }"></template>`即可，可传入string自定义具名插槽名称 */
   slot?: boolean | string
-  /**
-   * 表头是否必填 必填表头默认在表头名称前添加*号
-   */
+  /** 表头是否必填 必填表头默认在表头名称前添加*号 */
   required?: boolean
-  /**
-   * 必填表头*号位置 默认为before
-   */
+  /** 必填表头*号位置 默认为before */
   asteriskPosition?: 'before' | 'after'
 }
 
@@ -77,53 +53,17 @@ export interface Header {
  * 编辑配置接口
  */
 export interface Edit {
-  /**
-   * 组件
-   */
+  /** 组件 */
   component: Component
-  /**
-   * 属性
-   */
+  /** 属性 */
   attrs?: EditAttrs
 }
 
-/**
- * tableColumn的extConfig接口
- */
-export interface TableColumnExtConfig {
-  /**
-   * 表头配置
-   */
-  header?: Header
-  /**
-   * 编辑配置
-   */
-  edit?: Edit
-  /**
-   * 过滤器
-   */
-  formatter?: Function
-  /**
-   * 类名
-   */
-  class?: string | string[]
-  /**
-   * 样式
-   */
-  style?: string | Record<string, unknown>
-  /**
-   * 插槽 为true则在模板代码中添加`<template #prop="{ row }"></template>`即可，可传入string自定义具名插槽名称
-   */
-  slot?: boolean | string
-}
-
 /**
  * tableColumn接口
  */
 export interface TableColumn {
-  /**
-   * 表格列的标签
-   */
+  /** 表格列的标签 */
   label?: string
   /**
    * 表格列的属性 多级表头的父级表头可不传
@@ -135,41 +75,36 @@ export interface TableColumn {
    * 如为string或dict.data为string则将dict或dict.data作为dictMap的key
    */
   useDict?: boolean | string | UseDict
-  /**
-   * 表格列的宽度
-   */
+  /** 表格列的宽度 */
   width?: string | number
-  /**
-   * 表格列的最小宽度
-   */
+  /** 表格列的最小宽度 */
   minWidth?: string | number
-  /**
-   * 是否显示表格列
-   */
+  /** 是否显示表格列 */
   show?: boolean
-  /**
-   * 表格列的排列方式
-   */
+  /** 表格列的排列方式 */
   align?: string
-  /**
-   * 表格列是否固定
-   */
+  /** 表格列是否固定 */
   fixed?: boolean | string
-  /**
-   * 表格列是否开启排序
-   */
+  /** 表格列是否开启排序 */
   sortable?: boolean
-  /**
-   * 表格列溢出是否显示省略号
-   */
+  /** 表格列溢出是否显示省略号 */
   showOverflowTooltip?: boolean
-  /**
-   * 表格列扩展配置
-   */
-  extConfig?: TableColumnExtConfig
-  /**
-   * 表格列的子表格列
-   */
+  /** 表格列扩展配置 */
+  extConfig?: {
+    /** 表头配置 */
+    header?: Header
+    /** 编辑配置 */
+    edit?: Edit
+    /** 过滤器 */
+    formatter?: Function
+    /** 类名 */
+    class?: string | string[]
+    /** 样式 */
+    style?: string | Record<string, unknown>
+    /** 插槽 为true则在模板代码中添加`<template #prop="{ row }"></template>`即可，可传入string自定义具名插槽名称 */
+    slot?: boolean | string
+  }
+  /** 表格列的子表格列 */
   children?: TableColumn[]
 }
 
@@ -177,43 +112,25 @@ export interface TableColumn {
  * 选择器配置项
  */
 export interface Selection {
-  /**
-   * 选择器的标签
-   */
+  /** 选择器的标签 type为CHECKBOXRADIO、RADIO时表头全选复选框的文本，不设置则为空显示 */
   label?: string
-  /**
-   * 选择器的类型
-   */
+  /** 选择类型 可选值：CHECKBOX(复选) | CHECKBOXRADIO(复选框单选) | RADIO(单选) */
   type?: 'CHECKBOX' | 'CHECKBOXRADIO' | 'RADIO'
-  /**
-   * 选择器的宽度
-   */
+  /** 选择器的列宽 */
   width?: number
-  /**
-   * 选择器的唯一键
-   */
+  /** 选中数据的唯一键 对应tableData中的唯一键 如id */
   key?: string
-  /**
-   * 是否允许点击行触发选择器勾选
-   */
+  /** 允许通过点击行触发单选/复选 默认否 PS：默认不高亮当前行，若需高亮当前行，只需给UseElTable组件设置highlightCurrentRow属性即可 */
   enableRowClick?: boolean
-  /**
-   * 自定义选择器功能函数
-   */
+  /** 决定当前行复选框是否可以勾选 传入function，如果是简单禁用逻辑推荐优先使用disabledConfig配置项，复杂逻辑才建议使用本配置项 */
   selectable?: Function
-  /**
-   * 选择器禁止勾选配置
-   */
+  /** 禁用配置 可传对象或对象数组 */
   disabledConfig?:
     | Record<string, string | number | string[] | number[]>
     | Array<{ key: string; value: string | number | string[] | number[] }>
-  /**
-   * 选择器排列方式
-   */
+  /** 选择器的排列方式 */
   align?: string
-  /**
-   * 选择器是否固定
-   */
+  /** 选择器是否固定 */
   fixed?: boolean
 }
 
@@ -221,78 +138,70 @@ export interface Selection {
  * UseElTable的extConfig接口
  */
 export interface ExtConfig {
-  /**
-   * 额外表头配置项
-   * border：是否显示边框线 默认和el-table的border保持一致
-   * class：额外表头类名
-   * style：额外表头样式对象
-   */
+  /** 额外表头配置项 */
   extraHeader?: {
+    /** 是否显示边框线 默认和el-table的border保持一致 */
     border?: boolean
+    /** 额外表头类名 */
     class?: string
+    /** 额外表头样式对象 */
     style?: { padding?: string; borderBottom?: string }
   }
-  /**
-   * 模式配置项
-   * type：模式类型 可选值：PAGE(页面) | MODAL(弹窗)
-   * height：表格高度 不设置则默认高度自适应，该配置项设置的是UseELTable组件整体高度，非ElTable组件的高度
-   * bottomOffset：表格高度自适应表格底部预留偏移 该配置项由UseElConfigProvider组件统一提供默认值
-   */
-  mode?: { type?: 'PAGE' | 'MODAL'; height?: string; bottomOffset?: number }
-  /**
-   * 选择器配置项
-   * 绑定v-model:selectionData="selectionData"则开启选择器 不显式设置type则默认为CHECKBOX复选
-   * type：选择类型 可选值：CHECKBOX(复选) | CHECKBOXRADIO(复选框单选) | RADIO(单选)
-   * label：type为CHECKBOXRADIO、RADIO时表头全选复选框的文本 不设置则为空显示
-   * key：选中数据的唯一键 对应tableData中的唯一键 如id
-   * selectable：决定当前行复选框是否可以勾选 传入function，如果是简单禁用逻辑推荐优先使用disabledConfig配置项，复杂逻辑才建议使用本配置项
-   * disabledConfig：禁用配置 可传对象或对象数组
-   * enableRowClick：允许通过点击行触发单选/复选 默认否 PS：默认不高亮当前行，若需高亮当前行，只需给UseElTable组件设置highlightCurrentRow属性即可
-   * width：选择器的列宽 默认为40px
-   * align：选择器的排列方式 默认为center居中
-   * fixed：是否固定 默认为true
-   */
+  /** 模式配置项 */
+  mode?: {
+    /** 模式类型 可选值：PAGE(页面) | MODAL(弹窗) */
+    type?: 'PAGE' | 'MODAL'
+    /** 表格高度 不设置则默认高度自适应，该配置项设置的是UseELTable组件整体高度，非ElTable组件的高度 */
+    height?: string
+    /** 表格高度自适应表格底部预留偏移 该配置项由UseElConfigProvider组件统一提供默认值 */
+    bottomOffset?: number
+  }
+  /** 选择器配置项 绑定v-model:selectionData="selectionData"则开启选择器 不显式设置type则默认为CHECKBOX复选 */
   selection?: Selection
-  /**
-   * 序号列配置项
-   * label：序号列表头文本 不显式设置则不显示序号列
-   * isContinuous：是否连续的，默认是，即第二页的序号根据第一条最后一个序号进行延续
-   * width、align、fixed同选择器配置项
-   */
+  /** 序号列配置项 */
   index?: {
+    /** 序号列表头文本 不显式设置则不显示序号列 */
     label?: string
+    /** 是否连续的，默认是，即第二页的序号根据第一条最后一个序号进行延续 */
     isContinuous?: boolean
+    /** 序号列的列宽 */
     width?: number
+    /** 序号列的排列方式 */
     align?: string
+    /** 序号列是否固定 */
     fixed?: boolean
   }
-  /**
-   * 展开列配置项
-   * show：是否显示展开列
-   * width：展开列宽度
-   */
-  expand?: { show?: boolean; width?: number }
-  /**
-   * 操作列配置项
-   * label：操作列文案 显式设置则开启操作列
-   * width：操作列宽度 默认为128px
-   * fixed：固定方向 默认固定在右侧
-   */
-  operation?: { label?: string; width?: number; fixed?: string }
-  /**
-   * 分页器配置项
-   * total：分页总数 为-1时不显示分页器
-   * marginTop：分页器与表格的间距 默认20px
-   * func：分页方法 显式设置则在组件内部自动处理分页逻辑
-   * position：分页器位置 默认为right 可选值:left | center | right
-   */
+  /** 展开列配置项 */
+  expand?: {
+    /** 是否显示展开列 */
+    show?: boolean
+    /** 展开列宽度 */
+    width?: number
+  }
+  /** 操作列配置项 */
+  operation?: {
+    /** 操作列文案 显式设置则开启操作列 */
+    label?: string
+    /** 操作列列宽 */
+    width?: number
+    /** 操作列是否固定 */
+    fixed?: string
+  }
+  /** 分页器配置项 */
   pagination?: {
+    /** 分页总数 为-1时不显示分页器 */
     total?: number
+    /** 分页器与表格的间距 */
     marginTop?: number
-    position?: string
+    /** 分页器位置 */
+    position?: 'left' | 'center' | 'right'
+    /** 页码尺寸数组 */
     pageSizes?: number[]
+    /** 是否显示分页器背景 */
     background?: boolean
+    /** 分页器布局 */
     layout?: string
+    /** 分页方法 显式设置则在组件内部自动处理分页逻辑 */
     func?: Function
   }
 }

package/src/components/UseElTimeSelect/props.ts

@@ -0,0 +1,22 @@
+import type { PropType } from 'vue'
+import type { RenderConfig } from '@/types'
+
+/**
+ * 组件props
+ */
+export default {
+  /**
+   * 双向绑定数据源
+   */
+  modelValue: {
+    type: String,
+    default: ''
+  },
+  /**
+   * 是否使用渲染器 默认否
+   */
+  useRender: {
+    type: [Boolean, Object] as PropType<boolean | RenderConfig>,
+    default: false
+  }
+}

package/src/components/UseElTimeSelect/types.ts

@@ -0,0 +1,15 @@
+import type { ExtractPropTypes } from 'vue'
+import componentProps from './props'
+
+/**
+ * props类型
+ */
+export type Props = ExtractPropTypes<typeof componentProps>
+
+/**
+ * emits类型
+ */
+export type Emits = {
+  /** 更新value值 */
+  (e: 'update:modelValue', value: string | number | any[]): void
+}

package/src/components/UseLineTitle/defaultExtConfig.ts

@@ -17,7 +17,7 @@ export default {
   line: {
     width: '4px', //作用于position为left和bottom
     height: '2px', //作用于position为between
-    color: 'var(--theme-color)',
+    color: 'var(--theme-color,var(--el-color-primary))',
     position: 'left',
     verticalPadding: '0px'
   },

package/dist/types/UseCrud/useCrudWithBusiness.d.ts

@@ -1,46 +0,0 @@
-interface UseCrudState {
-    configs: Record<string, any>[];
-    formModel: Record<string, any>;
-    formParams: Record<string, any>;
-    tableLoading: boolean;
-    tableData: any[];
-    currentPage: number;
-    pageSize: number;
-    total: number;
-    dictMap: Record<string, any>;
-    selectionData: any[];
-    modalTitle: string;
-}
-interface Options {
-    params: Record<string, any>;
-    isPageApi: boolean;
-}
-export declare const useCrud: () => {
-    state: import('vue').Ref<{
-        configs: Record<string, any>[];
-        formModel: Record<string, any>;
-        formParams: Record<string, any>;
-        tableLoading: boolean;
-        tableData: any[];
-        currentPage: number;
-        pageSize: number;
-        total: number;
-        dictMap: Record<string, any>;
-        selectionData: any[];
-        modalTitle: string;
-    }, UseCrudState | {
-        configs: Record<string, any>[];
-        formModel: Record<string, any>;
-        formParams: Record<string, any>;
-        tableLoading: boolean;
-        tableData: any[];
-        currentPage: number;
-        pageSize: number;
-        total: number;
-        dictMap: Record<string, any>;
-        selectionData: any[];
-        modalTitle: string;
-    }>;
-    fetchTableData: (api: Function, options: Options) => Promise<void>;
-};
-export {};