vxe-pc-ui 3.16.10 → 3.16.11

package/types/components/menu.d.ts

@@ -23,12 +23,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
@@ -38,11 +51,14 @@ export namespace VxeMenuPropTypes {
       title?: string | ((params: VxeMenuSlotTypes.TitleSlotParams, h: CreateElement) => VxeComponentSlotType | VxeComponentSlotType[]) | null
       default?: string | ((params: VxeMenuSlotTypes.TitleSlotParams, h: CreateElement) => 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 {
     /**
@@ -60,18 +76,28 @@ export namespace VxeMenuPropTypes {
       $menu: VxeMenuConstructor
       options: VxeContextMenuPropTypes.Options
       currentMenu: VxeMenuDefines.MenuItem
+      currentOption: VxeMenuPropTypes.MenuOption
     }): boolean
   }
 }
 
 export interface VxeMenuProps {
-  value?: VxeMenuPropTypes.ModelValue
+  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
 }
@@ -81,6 +107,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>
 }
 
@@ -96,6 +126,22 @@ 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 { }
 
@@ -116,6 +162,7 @@ export namespace VxeMenuDefines {
   }
 
   export interface MenuItem extends VxeMenuPropTypes.MenuOption {
+    itemConf: VxeMenuPropTypes.MenuOption
     itemId: number
     itemKey: string | number
     level: number,
@@ -125,26 +172,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
   }
 }
@@ -169,17 +213,17 @@ export namespace VxeMenuEvents {
 
 export namespace VxeMenuSlotTypes {
   export interface DefaultSlotParams {
-    currentMenu: Required<VxeMenuPropTypes.MenuOption>
+    currentMenu: VxeMenuDefines.MenuItem
+    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 {
@@ -203,6 +247,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/table.d.ts

@@ -511,7 +511,7 @@ export namespace VxeTablePropTypes {
      */
     excludeValuesFields?: string[]
     /**
-     * 自定义列聚合数据的计算方法
+     * 个性化设置聚合数据的计算方法
      */
     calcValuesMethod?:(params: {
       $table: VxeTableConstructor<D>
@@ -524,7 +524,7 @@ export namespace VxeTablePropTypes {
       aggValue: number
     }) => number
     /**
-     * 自定义列聚合数据的显示值
+     * 个性化设置聚合数据的显示值
      */
     formatValuesMethod?:(params: {
       $table: VxeTableConstructor<D>
@@ -942,7 +942,7 @@ export namespace VxeTablePropTypes {
   }
 
   /**
-   * 自定义列配置项
+   * 个性化设置配置项
    */
   export interface CustomConfig<D = VxeTablePropTypes.Row> {
     /**
@@ -1029,14 +1029,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>
@@ -1110,7 +1110,7 @@ export namespace VxeTablePropTypes {
     confirmButtonText?: string
 
     /**
-     * 自定义列的插槽模板
+     * 个性化设置的插槽模板
      */
     slots?: {
       header?: string | ((params: VxeTableDefines.CustomSlotParams) => VxeComponentSlotType | VxeComponentSlotType[])
@@ -1290,7 +1290,7 @@ export namespace VxeTablePropTypes {
       column: VxeTableDefines.ColumnInfo<D>
     }): boolean
     /**
-     * 自定义列头升级按钮的 title 提示语
+     * 自定义列头升序按钮的 title 提示语
      */
     ascTitle?: string | number
     /**
@@ -3916,7 +3916,7 @@ export interface TableReactData<D = any> {
     export: boolean
     custom: boolean
   }
-  // 自定义列相关的信息
+  // 个性化设置相关的信息
   customStore: VxeTableDefines.VxeTableCustomStoreObj
   customColumnList: VxeTableDefines.ColumnInfo<D>[]
   // 当前选中的筛选列
@@ -5301,11 +5301,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
 }
@@ -7452,7 +7452,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

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