yuang-framework-ui-pc 1.1.44 → 1.1.46

package/lib/ele-admin-layout/props.d.ts

@@ -0,0 +1,182 @@
+import { PropType, ExtractPropTypes, InjectionKey } from 'vue';
+import { StyleValue } from '../ele-app/types';
+import { EleMenusProps, EleBreadcrumbProps, EleBacktopProps, EleDropdownProps } from '../ele-app/plus';
+import { MenuItem } from '../ele-menus/types';
+import { BreadcrumbItem } from '../ele-breadcrumb/types';
+import { TabPaneItem, TabEventOption, ContextMenus } from '../ele-tabs/types';
+import { Layout, SidebarLayout, HeaderStyle, SidebarStyle, TabStyle, TabBar, Maximized, LayoutProvide } from './types';
+
+/**
+ * 属性
+ */
+export declare const adminLayoutProps: {
+    /** 高度 */
+    height: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: string;
+    };
+    /** 顶栏菜单数据 */
+    headerMenus: PropType<MenuItem[]>;
+    /** 顶栏菜单选中 */
+    headerActive: StringConstructor;
+    /** 侧栏菜单数据 */
+    sidebarMenus: PropType<MenuItem[]>;
+    /** 侧栏菜单选中 */
+    sidebarActive: StringConstructor;
+    /** 双侧栏一级菜单数据 */
+    sideboxMenus: PropType<MenuItem[]>;
+    /** 双侧栏一级菜单选中 */
+    sideboxActive: StringConstructor;
+    /** 页签数据 */
+    tabs: PropType<TabPaneItem[]>;
+    /** 页签选中 */
+    tabActive: StringConstructor;
+    /** 面包屑导航数据 */
+    levels: PropType<BreadcrumbItem[]>;
+    /** 是否折叠侧栏 */
+    collapse: BooleanConstructor;
+    /** 双侧栏一级是否紧凑风格 */
+    compact: BooleanConstructor;
+    /** 内容区是否最大化 */
+    maximized: PropType<Maximized>;
+    /** 是否需要页签栏 */
+    tabBar: PropType<TabBar>;
+    /** 是否需要面包屑导航 */
+    breadcrumb: PropType<boolean | EleBreadcrumbProps>;
+    /** 是否需要返回顶部 */
+    backTop: PropType<boolean | EleBacktopProps>;
+    /** 顶栏菜单属性 */
+    headerMenuProps: PropType<EleMenusProps>;
+    /** 侧栏菜单属性 */
+    sidebarMenuProps: PropType<EleMenusProps>;
+    /** 双侧栏一级菜单属性 */
+    sideboxMenuProps: PropType<EleMenusProps>;
+    /** 布局类型 */
+    layout: PropType<Layout>;
+    /** 侧栏布局类型 */
+    sidebarLayout: PropType<SidebarLayout>;
+    /** 顶栏风格 */
+    headerStyle: PropType<HeaderStyle>;
+    /** 侧栏风格 */
+    sidebarStyle: PropType<SidebarStyle>;
+    /** 页签风格 */
+    tabStyle: {
+        type: PropType<TabStyle>;
+        default: string;
+    };
+    /** 是否固定顶栏 */
+    fixedHeader: BooleanConstructor;
+    /** 是否固定侧栏 */
+    fixedSidebar: BooleanConstructor;
+    /** 是否固定内容区 */
+    fixedBody: BooleanConstructor;
+    /** logo是否置于顶栏 */
+    logoInHeader: BooleanConstructor;
+    /** 是否需要固定的主页页签 */
+    fixedHome: BooleanConstructor;
+    /** 主页路由地址 */
+    homePath: StringConstructor;
+    /** 是否选中固定的主页页签 */
+    isHome: BooleanConstructor;
+    /** 是否支持页签右键菜单 */
+    tabContextMenu: PropType<boolean | EleDropdownProps>;
+    /** 页签右键菜单数据 */
+    tabContextMenus: PropType<ContextMenus>;
+    /** 是否支持页签拖动排序 */
+    tabSortable: BooleanConstructor;
+    /** 顶栏菜单标题插槽名称 */
+    headerTitleSlot: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 顶栏菜单图标插槽名称 */
+    headerIconSlot: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 侧栏菜单标题插槽名称 */
+    sidebarTitleSlot: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 侧栏菜单图标插槽名称 */
+    sidebarIconSlot: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 双侧栏一级菜单标题插槽名称 */
+    sideboxTitleSlot: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 双侧栏一级菜单图标插槽名称 */
+    sideboxIconSlot: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 顶栏样式 */
+    headerCustomStyle: PropType<StyleValue>;
+    /** 侧栏样式 */
+    sidebarCustomStyle: PropType<StyleValue>;
+    /** 双侧栏一级样式 */
+    sideboxCustomStyle: PropType<StyleValue>;
+    /** 页签栏样式 */
+    tabsCustomStyle: PropType<StyleValue>;
+    /** 内容区样式 */
+    contentCustomStyle: PropType<StyleValue>;
+    /** logo样式 */
+    logoStyle: PropType<StyleValue>;
+    /** logo文字样式 */
+    logoTitleStyle: PropType<StyleValue>;
+    /** 顶栏菜单样式 */
+    headerMenusStyle: PropType<StyleValue>;
+    /** 侧栏菜单样式 */
+    sidebarMenusStyle: PropType<StyleValue>;
+    /** 双侧栏一级菜单样式 */
+    sideboxMenusStyle: PropType<StyleValue>;
+    /** logo图片地址 */
+    logoSrc: StringConstructor;
+    /** logo文字 */
+    logoTitle: StringConstructor;
+    /** 菜单是否自动滚动到选中位置 */
+    menuScrollToActive: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否是移动端风格 */
+    mobile: BooleanConstructor;
+};
+export type AdminLayoutProps = ExtractPropTypes<typeof adminLayoutProps>;
+/**
+ * 事件
+ */
+export declare const adminLayoutEmits: {
+    'update:collapse': (_collapse: boolean) => boolean;
+    logoClick: (_e: MouseEvent) => boolean;
+    headMenuOpen: (_index: string, _indexPath: string[]) => boolean;
+    headMenuClose: (_index: string, _indexPath: string[]) => boolean;
+    headMenuItemClick: (_item: MenuItem, _e: MouseEvent) => boolean;
+    headMenuItemMouseenter: (_item: MenuItem, _e: MouseEvent) => boolean;
+    headMenuItemMouseleave: (_item: MenuItem, _e: MouseEvent) => boolean;
+    headMouseenter: (_e: MouseEvent) => boolean;
+    headMouseleave: (_e: MouseEvent) => boolean;
+    boxMenuItemClick: (_item: MenuItem, _e: MouseEvent) => boolean;
+    boxMenuItemMouseenter: (_item: MenuItem, _e: MouseEvent) => boolean;
+    boxMenuItemMouseleave: (_item: MenuItem, _e: MouseEvent) => boolean;
+    boxMouseenter: (_e: MouseEvent) => boolean;
+    boxMouseleave: (_e: MouseEvent) => boolean;
+    sideMenuOpen: (_index: string, _indexPath: string[]) => boolean;
+    sideMenuClose: (_index: string, _indexPath: string[]) => boolean;
+    sideMenuItemClick: (_item: MenuItem, _e: MouseEvent) => boolean;
+    sideMouseenter: (_e: MouseEvent) => boolean;
+    sideMouseleave: (_e: MouseEvent) => boolean;
+    tabClick: (_option: TabEventOption) => boolean;
+    tabRemove: (_name: string) => boolean;
+    tabContextMenu: (_option: TabEventOption) => boolean;
+    tabSortChange: (_data: TabPaneItem[]) => boolean;
+    contentMounted: (_contentEl: HTMLElement, _modalsEl: HTMLElement) => boolean;
+};
+/**
+ * 共享数据key
+ */
+export declare const LAYOUT_KEY: InjectionKey<LayoutProvide>;

package/lib/ele-admin-layout/style/index.scss

@@ -0,0 +1,313 @@
+@use '../../style/themes/default.scss' as *;
+@use '../../style/util.scss' as *;
+@use './css-var.scss' as *;
+@use './tabs.scss';
+@use './header.scss';
+@use './sidebar.scss';
+
+@include set-layout-var($ele);
+
+.ele-admin-layout {
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: column;
+  background: eleVar('layout', 'bg');
+  box-sizing: border-box;
+  position: relative;
+  min-height: 100vh;
+  min-height: 100dvh;
+
+  & > .ele-admin-header {
+    z-index: calc(#{eleVar('layout', 'index')} + 4);
+  }
+}
+
+.ele-admin-main,
+.ele-admin-body,
+.ele-admin-wrapper,
+.ele-admin-content {
+  flex: auto;
+  display: flex;
+  flex-direction: column;
+}
+
+.ele-admin-layout.is-row-direction,
+.ele-admin-main.is-row-direction {
+  flex-direction: row;
+}
+
+.ele-admin-wrapper {
+  position: relative;
+
+  & > .ele-backtop {
+    z-index: calc(#{eleVar('layout', 'index')} + 1);
+  }
+}
+
+/* 主体宽度 */
+.ele-admin-layout.is-row-direction > .ele-admin-main,
+.ele-admin-main.is-row-direction > .ele-admin-body {
+  flex: 0 1 auto;
+  transition: width $transition-base;
+  width: 100%;
+}
+
+.ele-admin-layout > .ele-admin-side + .ele-admin-main,
+.ele-admin-main > .ele-admin-side + .ele-admin-body {
+  width: calc(100% - #{eleVar('sidebar', 'width')});
+}
+
+.ele-admin-side.is-collapse + .ele-admin-main,
+.ele-admin-side.is-collapse + .ele-admin-body {
+  width: calc(100% - #{eleVar('sidebar', 'collapse-width')});
+}
+
+.ele-admin-side.is-mix + .ele-admin-main,
+.ele-admin-side.is-mix + .ele-admin-body {
+  $box-width: eleVar('sidebox', 'width');
+  width: calc(100% - #{eleVar('sidebar', 'mix-width')} - #{$box-width});
+}
+
+.ele-admin-side.is-mix.is-collapse + .ele-admin-main,
+.ele-admin-side.is-mix.is-collapse + .ele-admin-body {
+  width: calc(100% - #{eleVar('sidebox', 'width')});
+}
+
+.ele-admin-side.is-compact + .ele-admin-main,
+.ele-admin-side.is-compact + .ele-admin-body {
+  $box-width: eleVar('sidebar', 'collapse-width');
+  width: calc(100% - #{eleVar('sidebar', 'mix-width')} - #{$box-width});
+}
+
+.ele-admin-side.is-compact.is-collapse + .ele-admin-main,
+.ele-admin-side.is-compact.is-collapse + .ele-admin-body {
+  width: calc(100% - #{eleVar('sidebar', 'collapse-width')});
+}
+
+.ele-admin-side.is-box + .ele-admin-main,
+.ele-admin-side.is-box + .ele-admin-body {
+  width: calc(100% - #{eleVar('sidebox', 'width')});
+}
+
+.ele-admin-side.is-box.is-compact + .ele-admin-main,
+.ele-admin-side.is-box.is-compact + .ele-admin-body {
+  width: calc(100% - #{eleVar('sidebar', 'collapse-width')});
+}
+
+.ele-admin-layout.is-row-direction.is-mobile > .ele-admin-main,
+.ele-admin-layout.is-row-direction.is-fixed-body > .ele-admin-main,
+.ele-admin-layout.is-fixed-body > .ele-admin-main > .ele-admin-body,
+.ele-admin-layout.is-row-direction.is-maximized > .ele-admin-main,
+.ele-admin-layout.is-maximized > .ele-admin-main > .ele-admin-body {
+  width: 100%;
+}
+
+.ele-admin-layout {
+  /* 固定主体 */
+  &.is-fixed-body {
+    height: 100vh;
+    height: 100dvh;
+  }
+
+  &.is-fixed-body > .ele-admin-main,
+  &.is-fixed-body > .ele-admin-main > .ele-admin-body,
+  &.is-fixed-body > .ele-admin-main > .ele-admin-side,
+  &.is-fixed-body > .ele-admin-side {
+    height: 100%;
+  }
+
+  &.is-fixed-body > .ele-admin-main,
+  &.is-fixed-body > .ele-admin-main > .ele-admin-body,
+  &.is-fixed-body > .ele-admin-main > .ele-admin-body > .ele-admin-wrapper {
+    overflow: auto;
+  }
+
+  &.is-fixed-body > .ele-admin-main > .ele-admin-body > .ele-admin-wrapper {
+    & > .ele-admin-content {
+      overflow-x: hidden;
+      overflow-y: auto;
+    }
+
+    & > .ele-backtop {
+      z-index: eleVar('layout', 'index');
+    }
+  }
+
+  /* 内容全屏 */
+  &.is-maximized > .ele-admin-header,
+  &.is-maximized > .ele-admin-main > .ele-admin-header,
+  &.is-maximized > .ele-admin-main > .ele-admin-side,
+  &.is-maximized > .ele-admin-side,
+  &.is-expanded > .ele-admin-main > .ele-admin-body > .ele-admin-tabs {
+    display: none;
+  }
+
+  /* 移动端风格 */
+  &.is-mobile > .ele-admin-side {
+    width: 0;
+    z-index: calc(#{eleVar('layout', 'mask-index')} + 1);
+  }
+
+  &.is-collapse > .ele-admin-side {
+    & > .ele-admin-sidebar,
+    & > .ele-admin-sidebox {
+      visibility: hidden;
+    }
+
+    & > .ele-admin-sidebar {
+      transform: translateX(-100%);
+    }
+
+    & > .ele-admin-sidebar.is-mix,
+    & > .ele-admin-sidebox {
+      $mix-width: eleVar('sidebar', 'mix-width');
+      $box-width: eleVar('sidebox', 'width');
+      transform: translateX(calc(#{$box-width} * -1 - #{$mix-width}));
+    }
+  }
+
+  &.is-collapse > .ele-admin-mask,
+  &:not(.is-mobile) > .ele-admin-mask {
+    visibility: hidden;
+    opacity: 0;
+  }
+
+  /* 禁用过渡效果 */
+  &.is-transition-disabled {
+    & > .ele-admin-header,
+    & > .ele-admin-main > .ele-admin-header,
+    & > .ele-admin-main > .ele-admin-side > .ele-admin-sidebar,
+    & > .ele-admin-main > .ele-admin-side > .ele-admin-sidebox,
+    & > .ele-admin-side > .ele-admin-sidebar,
+    & > .ele-admin-side > .ele-admin-sidebox,
+    & > .ele-admin-main,
+    & > .ele-admin-main > .ele-admin-body {
+      transition: none !important;
+    }
+  }
+}
+
+/* logo */
+.ele-admin-logo,
+.ele-admin-logo-title {
+  flex-shrink: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: eleVar('logo', 'color');
+  font-size: eleVar('logo', 'size');
+  font-family: eleVar('logo', 'family');
+  height: eleVar('header', 'height');
+  position: relative;
+  overflow: hidden;
+
+  h1 {
+    margin: 0;
+    font-weight: 600;
+    font-size: inherit;
+    text-overflow: ellipsis;
+    word-break: break-all;
+    white-space: nowrap;
+    overflow: hidden;
+  }
+}
+
+.ele-admin-logo > img {
+  width: 30px;
+  height: 30px;
+
+  & + h1 {
+    margin-left: 8px;
+  }
+}
+
+.ele-admin-sidebar.is-collapse > .ele-admin-logo > img + h1 {
+  display: none;
+}
+
+.ele-admin-header > .ele-admin-logo {
+  $tool-padding: eleVar('header', 'tool-padding');
+  margin-left: calc(#{eleVar('header', 'tools-padding')} + #{$tool-padding});
+}
+
+.ele-admin-header.is-dark > .ele-admin-logo,
+.ele-admin-header.is-primary > .ele-admin-logo,
+.ele-admin-sidebar.is-dark > .ele-admin-logo,
+.ele-admin-sidebar.is-dark > .ele-admin-logo-title,
+.ele-admin-sidebox.is-dark > .ele-admin-logo {
+  color: eleVar('logo', 'dark-color');
+}
+
+/* 操作按钮 */
+.ele-admin-tool {
+  flex-shrink: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: eleVar('header', 'tool-height');
+  padding: 0 eleVar('header', 'tool-padding');
+  border-radius: eleVar('header', 'tool-radius');
+  transition: (color $transition-base, background-color $transition-base);
+  box-sizing: border-box;
+  cursor: pointer;
+
+  &:hover {
+    background: eleVar('header', 'tool-hover-bg');
+  }
+
+  & > .el-dropdown {
+    color: inherit;
+    cursor: inherit;
+    font-size: inherit;
+    line-height: inherit;
+    align-items: center;
+    height: 100%;
+  }
+}
+
+.ele-admin-header.is-dark .ele-admin-tool:hover,
+.ele-admin-header.is-primary .ele-admin-tool:hover,
+.ele-admin-sidebar.is-dark .ele-admin-tool:hover,
+.ele-admin-sidebox.is-dark .ele-admin-tool:hover {
+  background: eleVar('header', 'dark-tool-hover-bg');
+}
+
+.ele-admin-sidebar .ele-admin-tool,
+.ele-admin-sidebox .ele-admin-tool {
+  height: eleVar('sidebar', 'tool-height');
+  padding: 0;
+}
+
+.ele-admin-sidebar.is-dark .ele-admin-tool,
+.ele-admin-sidebox.is-dark .ele-admin-tool {
+  color: eleVar('header', 'dark-color');
+}
+
+/* 模态框容器 */
+.ele-admin-modals {
+  flex-shrink: 0;
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+  z-index: eleVar('layout', 'index');
+}
+
+/* 遮罩 */
+.ele-admin-mask {
+  flex-shrink: 0;
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  width: 100%;
+  height: 100%;
+  z-index: eleVar('layout', 'mask-index');
+  background: elVar('overlay-color', 'lighter');
+  transition: all $transition-base;
+}

package/lib/ele-admin-layout/style/sidebar.scss

@@ -0,0 +1,187 @@
+@use '../../style/themes/default.scss' as *;
+@use '../../style/util.scss' as *;
+
+/* 侧栏容器 */
+.ele-admin-side {
+  flex-shrink: 0;
+  display: flex;
+  box-sizing: border-box;
+  z-index: calc(#{eleVar('layout', 'index')} + 3);
+  position: relative;
+}
+
+/* 侧栏 */
+.ele-admin-sidebar {
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: column;
+  width: eleVar('sidebar', 'width');
+  background: eleVar('sidebar', 'bg');
+  box-shadow: eleVar('sidebar', 'shadow');
+  z-index: calc(#{eleVar('layout', 'index')} + 3);
+  transition: all $transition-base;
+  box-sizing: border-box;
+  position: relative;
+
+  /* 侧栏菜单 */
+  .ele-admin-menus {
+    flex: 1;
+    overflow: hidden;
+
+    & > .el-scrollbar__wrap {
+      position: relative;
+      box-sizing: border-box;
+      overflow-x: hidden;
+      overflow-y: auto;
+
+      & > .el-scrollbar__view > .ele-menu {
+        width: 100%;
+        border: none;
+        background: none;
+        transition: none;
+      }
+    }
+  }
+
+  /* 暗色侧栏 */
+  &.is-dark {
+    background: eleVar('sidebar', 'dark-bg');
+    box-shadow: eleVar('sidebar', 'dark-shadow');
+  }
+
+  /* 双侧栏 */
+  &.is-mix {
+    width: eleVar('sidebar', 'mix-width');
+    z-index: calc(#{eleVar('layout', 'index')} + 2);
+
+    &.is-dark {
+      border-left: 1px solid #000;
+    }
+  }
+
+  /* 模糊透明侧栏 */
+  &.is-ghost {
+    background: eleVar('sidebar', 'ghost-bg');
+  }
+
+  /* 折叠侧栏 */
+  &.is-collapse {
+    &:not(.is-mix) {
+      width: eleVar('sidebar', 'collapse-width');
+    }
+
+    &.is-mix {
+      margin-left: calc(#{eleVar('sidebar', 'mix-width')} * -1);
+      visibility: hidden;
+    }
+  }
+}
+
+/* 双侧栏一级 */
+.ele-admin-sidebox {
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: column;
+  width: eleVar('sidebox', 'width');
+  background: eleVar('sidebar', 'bg');
+  box-shadow: eleVar('sidebar', 'shadow');
+  z-index: calc(#{eleVar('layout', 'index')} + 3);
+  transition: all $transition-base;
+  box-sizing: border-box;
+  position: relative;
+
+  /* 双侧栏一级菜单 */
+  .ele-admin-menus {
+    flex: 1;
+    overflow: hidden;
+
+    & > .el-scrollbar__wrap {
+      position: relative;
+      box-sizing: border-box;
+      overflow-x: hidden;
+      overflow-y: auto;
+
+      & > .el-scrollbar__view > .ele-menu {
+        border: none;
+        background: none;
+      }
+    }
+  }
+
+  /* 暗色双侧栏一级 */
+  &.is-dark {
+    background: eleVar('sidebar', 'dark-bg');
+    box-shadow: eleVar('sidebar', 'dark-shadow');
+  }
+
+  /* 模糊透明双侧栏一级 */
+  &.is-ghost {
+    background: eleVar('sidebar', 'ghost-bg');
+  }
+
+  /* 与侧栏分割线 */
+  &.show-divider {
+    box-shadow: -0.8px 0 0 eleVar('header', 'line-color') inset;
+
+    &.is-dark {
+      box-shadow: none;
+    }
+  }
+
+  /* 折叠双侧栏一级 */
+  &.is-compact {
+    width: eleVar('sidebar', 'collapse-width');
+  }
+}
+
+/* 固定侧栏 */
+.ele-admin-side.is-fixed {
+  position: sticky;
+  left: 0;
+  top: 0;
+  height: 100vh;
+  height: 100dvh;
+}
+
+.ele-admin-side.show-placeholder {
+  margin-top: calc(eleVar('header', 'height') * -1);
+
+  & > .ele-admin-sidebar,
+  & > .ele-admin-sidebox {
+    padding-top: eleVar('header', 'height');
+  }
+}
+
+/* 侧栏菜单滚动条 */
+.ele-admin-sidebar > .ele-admin-menus,
+.ele-admin-sidebox > .ele-admin-menus {
+  $size: eleVar('menu-thumb', 'size');
+  $padding: eleVar('menu-thumb', 'padding');
+  $hover-color: eleVar('menu-thumb', 'hover-color');
+  #{elVarName('scrollbar', 'opacity')}: 1;
+  #{elVarName('scrollbar', 'hover-opacity')}: 1;
+  #{elVarName('scrollbar', 'bg-color')}: eleVar('menu-thumb', 'color');
+  #{elVarName('scrollbar', 'hover-bg-color')}: #{$hover-color};
+
+  & > .el-scrollbar__bar.is-vertical {
+    width: calc(#{$size} - #{$padding} * 2);
+    border-radius: eleVar('menu-thumb', 'radius');
+    right: $padding;
+    z-index: 9;
+  }
+
+  & > .el-scrollbar__bar.is-horizontal {
+    height: calc(#{$size} - #{$padding} * 2);
+    border-radius: eleVar('menu-thumb', 'radius');
+    bottom: $padding;
+    z-index: 9;
+  }
+}
+
+/* 暗色侧栏菜单滚动条 */
+.ele-admin-sidebar.is-dark > .ele-admin-menus,
+.ele-admin-sidebox.is-dark > .ele-admin-menus {
+  $dark-hover-color: eleVar('menu-dark-thumb', 'hover-color');
+  #{elVarName('scrollbar', 'bg-color')}: eleVar('menu-dark-thumb', 'color');
+  #{elVarName('scrollbar', 'hover-bg-color')}: #{$dark-hover-color};
+}