vxe-pc-ui 4.16.9 → 4.16.11

package/types/components/menu.d.ts

@@ -29,12 +29,25 @@ export namespace VxeMenuPropTypes {
   export type ModelValue = string | number | null
   export type Size = VxeComponentSizeType
   export type Loading = boolean
+  export type Border = boolean | 'first' | 'first-group' | 'group' | 'all'
   export type Accordion = boolean
+  export interface OptionProps {
+   name?: string
+   title?: string
+   icon?: string
+   children?: string
+   linkUrl?: string
+   linkTarget?: string
+   routerLink?: string
+   routerTarget?: string
+  }
 
   export interface MenuOption {
     name?: VxeMenuPropTypes.ModelValue
     title?: string | number
     icon?: string
+    linkUrl?: string
+    linkTarget?: VxeLinkPropTypes.Target
     routerLink?: VxeLinkPropTypes.RouterLink
     expanded?: boolean
     permissionCode?: VxeComponentPermissionCodeType
@@ -44,11 +57,14 @@ export namespace VxeMenuPropTypes {
       title?: string | ((params: VxeMenuSlotTypes.TitleSlotParams) => VxeComponentSlotType | VxeComponentSlotType[]) | null
       default?: string | ((params: VxeMenuSlotTypes.TitleSlotParams) => VxeComponentSlotType | VxeComponentSlotType[]) | null
     }
+
+    [key: string]: any
   }
 
   export type Collapsed = boolean
   export type CollapseFixed = boolean
   export type ExpandAll = boolean
+  export type ExpandKeys = (string | number)[]
   export type Options = MenuOption[]
   export interface MenuConfig {
     /**
@@ -66,6 +82,7 @@ export namespace VxeMenuPropTypes {
       $menu: VxeMenuConstructor
       options: VxeContextMenuPropTypes.Options
       currentMenu: VxeMenuDefines.MenuItem
+      currentOption: VxeMenuPropTypes.MenuOption
     }): boolean
   }
 }
@@ -74,10 +91,19 @@ export interface VxeMenuProps {
   modelValue?: VxeMenuPropTypes.ModelValue
   size?: VxeMenuPropTypes.Size
   loading?: VxeMenuPropTypes.Loading
+  border?: VxeMenuPropTypes.Border
   accordion?: VxeMenuPropTypes.Accordion
+  optionProps?: VxeMenuPropTypes.OptionProps
   collapsed?: VxeMenuPropTypes.Collapsed
-  CollapseFixed?: VxeMenuPropTypes.CollapseFixed
+  collapseFixed?: VxeMenuPropTypes.CollapseFixed
+  /**
+   * 默认展开所有菜单项（只会在初始化时被触发一次）
+   */
   expandAll?: VxeMenuPropTypes.ExpandAll
+  /**
+   * 默认展开指定菜单项（只会在初始化时被触发一次）
+   */
+  expandKeys?: VxeMenuPropTypes.ExpandKeys
   options?: VxeMenuPropTypes.Options
   menuConfig?: VxeMenuPropTypes.MenuConfig
 }
@@ -87,6 +113,10 @@ export interface MenuPrivateComputed {
 export interface VxeMenuPrivateComputed extends MenuPrivateComputed { }
 
 export interface MenuInternalData {
+  lastActiveTime: number
+  menuInitMaps: Record<number, boolean>
+  menuCacheMaps: Record<string, VxeMenuDefines.MenuItem>
+  menuKeyMaps: Record<string, VxeMenuDefines.MenuItem>
   menuEffectMaps: Record<number, number>
 }
 
@@ -102,8 +132,24 @@ export interface MenuReactData {
 
 export interface MenuMethods {
   dispatchEvent(type: ValueOf<VxeMenuEmits>, params: Record<string, any>, evnt: Event | null): void
+  /**
+   * 设置指定菜单 key 为展开状态，第二个参数为选中与否
+   */
+  setExpandByMenuKey(menuKeys: string | number | (string | number)[], expanded: boolean): Promise<any>
+  /**
+   * 手动清除所有菜单的展开状态
+   */
+  clearAllExpandMenu(): Promise<any>
+  /**
+   * 自动滚动到指定菜单
+   */
+  scrollToMenuKey(menuKey: string | number): Promise<any>
+  /**
+   * 自动滚动到旋转的菜单
+   */
+  scrollToActiveMenu(): Promise<any>
 }
-export interface VxeMenuMethods extends MenuMethods { }
+export interface VxeMenuMethods extends MenuMethods {}
 
 export interface MenuPrivateMethods { }
 export interface VxeMenuPrivateMethods extends MenuPrivateMethods { }
@@ -121,6 +167,7 @@ export namespace VxeMenuDefines {
   }
 
   export interface MenuItem extends VxeMenuPropTypes.MenuOption {
+    itemConf: VxeMenuPropTypes.MenuOption
     itemId: number
     itemKey: string | number
     level: number,
@@ -130,26 +177,23 @@ export namespace VxeMenuDefines {
     isExpand: boolean
     hasChild: boolean
     childList: MenuItem[]
-    allChildSize: number
-    childHeight: number
   }
 
   export interface ClickParams {
     currentMenu: VxeMenuDefines.MenuItem
-
-    /**
-     * 已废弃，请使用 currentMenu
-     * @deprecated
-     */
-    menu: VxeMenuDefines.MenuItem
+    currentOption: VxeMenuPropTypes.MenuOption
+    option: VxeMenuPropTypes.MenuOption
   }
   export interface ClickEventParams extends MenuEventParams, ClickParams { }
 
   export interface OptionMenuEventParams extends MenuEventParams {
     currentMenu: VxeMenuDefines.MenuItem
+    currentOption: VxeMenuPropTypes.MenuOption
+    option: VxeMenuPropTypes.MenuOption
   }
   export interface MenuClickEventParams extends MenuEventParams {
     currentMenu: VxeMenuDefines.MenuItem
+    currentOption: VxeMenuPropTypes.MenuOption
     menu: VxeContextMenuDefines.MenuFirstOption | VxeContextMenuDefines.MenuChildOption
   }
 }
@@ -177,17 +221,18 @@ export namespace VxeMenuEvents {
 
 export namespace VxeMenuSlotTypes {
   export interface DefaultSlotParams {
-    currentMenu: Required<VxeMenuPropTypes.MenuOption>
+    currentMenu: VxeMenuDefines.MenuItem
+    currentOption: VxeMenuPropTypes.MenuOption
+    option: VxeMenuPropTypes.MenuOption
     collapsed: boolean
-
-    /**
-     * 已废弃，请使用 currentMenu
-     * @deprecated
-     */
-    option: Required<VxeMenuPropTypes.MenuOption>
   }
   export interface IconSlotParams extends DefaultSlotParams {}
   export interface TitleSlotParams extends DefaultSlotParams {}
+
+  export interface HeaderSlotParams {
+    collapsed: boolean
+  }
+  export interface FooterSlotParams extends HeaderSlotParams {}
 }
 
 export interface VxeMenuSlots {
@@ -211,6 +256,9 @@ export interface VxeMenuSlots {
   'option-title'?: (params: VxeMenuSlotTypes.TitleSlotParams) => any
 
   option?: (params: VxeMenuSlotTypes.TitleSlotParams) => any
+
+  header?: (params: VxeMenuSlotTypes.HeaderSlotParams) => any
+  footer?: (params: VxeMenuSlotTypes.FooterSlotParams) => any
 }
 
 export const Menu: typeof VxeMenu

package/types/components/modal.d.ts

@@ -33,8 +33,8 @@ export type ModalType = 'alert' | 'confirm' | 'message' | 'notification' | 'moda
 export type ModalStatus = 'info' | 'success' | 'warning' | 'question' | 'error' | 'loading'
 
 export type ModalPosition = {
-  top?: number
-  left?: number
+  top?: number | string
+  left?: number | string
 }
 
 /**

package/types/components/table.d.ts

@@ -537,7 +537,7 @@ export namespace VxeTablePropTypes {
      */
     excludeValuesFields?: string[]
     /**
-     * 自定义列聚合数据的计算方法
+     * 个性化设置聚合数据的计算方法
      */
     calcValuesMethod?:(params: {
       $table: VxeTableConstructor<D>
@@ -550,7 +550,7 @@ export namespace VxeTablePropTypes {
       aggValue: number
     }) => number
     /**
-     * 自定义列聚合数据的显示值
+     * 个性化设置聚合数据的显示值
      */
     formatValuesMethod?:(params: {
       $table: VxeTableConstructor<D>
@@ -964,7 +964,7 @@ export namespace VxeTablePropTypes {
   }
 
   /**
-   * 自定义列配置项
+   * 个性化设置配置项
    */
   export interface CustomConfig<D = VxeTablePropTypes.Row> {
     /**
@@ -1051,14 +1051,14 @@ export namespace VxeTablePropTypes {
     immediate?: boolean
     placement?: 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'
     /**
-     * 自定义列是否允许列选中的方法，该方法的返回值用来决定这一列的 checkbox 是否可以选中
+     * 个性化设置是否允许列选中的方法，该方法的返回值用来决定这一列的 checkbox 是否可以选中
      */
     checkMethod?(params: {
       $table: VxeTableConstructor<D>
       column: VxeTableDefines.ColumnInfo<D>
     }): boolean
     /**
-     * 自定义列是否的方法，该方法的返回值用来决定这一列是否显示
+     * 个性化设置是否的方法，该方法的返回值用来决定这一列是否显示
      */
     visibleMethod?(params: {
       $table: VxeTableConstructor<D>
@@ -1132,7 +1132,7 @@ export namespace VxeTablePropTypes {
     confirmButtonText?: string
 
     /**
-     * 自定义列的插槽模板
+     * 个性化设置的插槽模板
      */
     slots?: {
       header?: string | ((params: VxeTableDefines.CustomSlotParams) => VxeComponentSlotType | VxeComponentSlotType[])
@@ -1312,7 +1312,7 @@ export namespace VxeTablePropTypes {
       column: VxeTableDefines.ColumnInfo<D>
     }): boolean
     /**
-     * 自定义列头升级按钮的 title 提示语
+     * 自定义列头升序按钮的 title 提示语
      */
     ascTitle?: string | number
     /**
@@ -3884,7 +3884,7 @@ export interface TableReactData<D = any> {
     export: boolean
     custom: boolean
   }
-  // 自定义列相关的信息
+  // 个性化设置相关的信息
   customStore: VxeTableDefines.VxeTableCustomStoreObj
   customColumnList: VxeTableDefines.ColumnInfo<D>[]
   // 当前选中的筛选列
@@ -5273,11 +5273,11 @@ export interface TableMethods<DT = any> {
    */
   blur(): Promise<void>
   /**
-   * 用于 custom-config，用于手动恢复自定义列设置信息，恢复为初始状态
+   * 用于 custom-config，用于手动恢复个性化设置，恢复为初始状态
    */
   setCustomStoreData(storeData: VxeTableDefines.CustomStoreData | null): Promise<void>
   /**
-   * 用于 custom-config，用于获取自定义列设置信息，用于自定义保持
+   * 用于 custom-config，用于获取个性化设置，用于自定义保持
    */
   getCustomStoreData(): VxeTableDefines.CustomStoreData
 }
@@ -7421,7 +7421,7 @@ export interface VxeTableListeners<D = any> {
   scroll?: VxeTableEvents.Scroll<D>
   scrollBoundary?: VxeTableEvents.ScrollBoundary<D>
   /**
-   * 如果与工具栏关联，在自定义列按钮被手动点击后会触发该事件
+   * 如果与工具栏关联，在个性化设置按钮被手动点击后会触发该事件
    */
   custom?: VxeTableEvents.Custom<D>
   customOpen?: VxeTableEvents.CustomOpen<D>

package/types/components/toolbar.d.ts

@@ -221,7 +221,7 @@ export type VxeToolbarProps = {
   zoom?: VxeToolbarPropTypes.Zoom
   zoomOptions?: VxeToolbarPropTypes.ZoomOptions
   /**
-   * 自定义列配置
+   * 个性化设置配置
    */
   custom?: VxeToolbarPropTypes.Custom
   customOptions?: VxeToolbarPropTypes.CustomOptions