@arcblock/ux 2.6.9 → 2.7.0

package/es/Layout/dashboard/sidebar.js

@@ -0,0 +1,209 @@
+/* eslint-disable react/no-array-index-key */
+import PropTypes from 'prop-types';
+import Typography from '@mui/material/Typography';
+import { teal } from '@mui/material/colors';
+import clsx from 'clsx';
+import { styled } from '../../Theme';
+import { NavLink } from './external-link';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+function renderGroup(item) {
+  return /*#__PURE__*/_jsxs("li", {
+    className: "layout-sidebar-group",
+    children: [/*#__PURE__*/_jsx("span", {
+      className: "layout-sidebar-group-title",
+      children: item.title
+    }), /*#__PURE__*/_jsx("ul", {
+      children: item.children.map(renderItem)
+    })]
+  }, `group-${item.title}`);
+}
+function renderItem(item) {
+  if (item.children?.length) {
+    return renderGroup(item);
+  }
+  const {
+    url,
+    icon,
+    title,
+    showBadge,
+    external,
+    active
+  } = item;
+  // external = true 时 link active 状态由传入 links 的调用方决定 (适用于 blocklet ui dashboard 的情况)
+  return /*#__PURE__*/_jsx("li", {
+    className: "layout-sidebar-item",
+    children: /*#__PURE__*/_jsxs(NavLink, {
+      external: external,
+      to: url,
+      className: ({
+        isActive
+      }) => clsx('layout-sidebar-link', {
+        'layout-sidebar-link--active': external ? active : isActive
+      }),
+      children: [icon && /*#__PURE__*/_jsx("span", {
+        className: `layout-sidebar-icon ${showBadge ? 'layout-sidebar-badge' : ''}`,
+        children: icon
+      }), /*#__PURE__*/_jsx(Typography, {
+        component: "span",
+        className: "layout-sidebar-link-text",
+        children: title
+      })]
+    })
+  }, url);
+}
+function Sidebar({
+  links,
+  addons,
+  dense,
+  ...rest
+}) {
+  return /*#__PURE__*/_jsxs(Root, {
+    ...rest,
+    className: clsx({
+      'layout-sidebar-dense': dense
+    }),
+    children: [/*#__PURE__*/_jsx("ul", {
+      children: links.map(renderItem)
+    }), /*#__PURE__*/_jsx("div", {
+      style: {
+        flex: 1
+      }
+    }), addons]
+  });
+}
+Sidebar.propTypes = {
+  links: PropTypes.array.isRequired,
+  addons: PropTypes.any,
+  dense: PropTypes.bool
+};
+Sidebar.defaultProps = {
+  addons: null,
+  dense: false
+};
+const gradient = 'linear-gradient(32deg, rgba(144, 255, 230, 0.1), rgba(144, 255, 230, 0))';
+const Root = styled('div')`
+  display: flex;
+  flex-direction: column;
+  ul {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+  }
+  .layout-sidebar-link {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    padding: 22px 24px;
+    color: ${props => props.theme.palette.text.secondary};
+    text-decoration: none;
+
+    &:hover,
+    &.layout-sidebar-link--active {
+      color: ${props => props.theme.palette.primary.main};
+      background: ${gradient};
+      border-left-color: ${teal.A700};
+    }
+  }
+  .layout-sidebar-icon {
+    display: inline-block;
+    width: 32px;
+    height: 32px;
+    > img,
+    > svg {
+      width: 32px;
+      height: 32px;
+    }
+  }
+  .layout-sidebar-badge {
+    position: relative;
+    &:after {
+      content: '';
+      position: absolute;
+      width: 10px;
+      height: 10px;
+      border-radius: 10px;
+      background-color: #fe4e44;
+      right: -2px;
+      top: 0;
+      box-shadow: 0px 1px 4px rgba(0, 0, 0, 0.3), 0px 0px 20px rgba(0, 0, 0, 0.1);
+    }
+  }
+  .layout-sidebar-link-text {
+    margin-top: 8px;
+    font-size: 12px;
+    font-weight: 500;
+    text-align: center;
+    text-transform: capitalize;
+    letter-spacing: normal;
+  }
+  /* dense=false 时隐藏 group title */
+  .layout-sidebar-group-title {
+    display: none;
+  }
+  &.layout-sidebar-dense {
+    box-sizing: border-box;
+    padding: 20px 0;
+    font-weight: bold;
+    .layout-sidebar-item {
+      padding: 0 16px;
+    }
+    .layout-sidebar-item + .layout-sidebar-item {
+      margin-top: 1px;
+    }
+    .layout-sidebar-link {
+      box-sizing: border-box;
+      flex-direction: row;
+      align-items: center;
+      width: 100%;
+      padding: 8px;
+      &:hover,
+      &.layout-sidebar-link--active {
+        color: ${props => props.theme.palette.grey[900]};
+        background: ${props => props.theme.palette.grey[100]};
+        border: 0;
+        border-radius: 4px;
+      }
+    }
+    .layout-sidebar-icon {
+      display: inline-block;
+      width: 20px;
+      height: 20px;
+      margin-right: 8px;
+      > img,
+      > svg {
+        width: 20px;
+        height: 20px;
+      }
+    }
+    .layout-sidebar-badge {
+      &:after {
+        width: 6px;
+        height: 6px;
+        border-radius: 6px;
+        right: -2px;
+        top: 0;
+      }
+    }
+    .layout-sidebar-link-text {
+      margin-top: 0;
+      font-size: 14px;
+      line-height: 1;
+    }
+    .layout-sidebar-group {
+      color: ${props => props.theme.palette.text.hint};
+      .layout-sidebar-group-title {
+        display: inline-block;
+        padding: 8px 0 8px 24px;
+        font-size: 13px;
+        text-transform: uppercase;
+      }
+    }
+    .layout-sidebar-group + .layout-sidebar-group,
+    .layout-sidebar-group + .layout-sidebar-item,
+    .layout-sidebar-item + .layout-sidebar-group {
+      margin-top: 16px;
+    }
+  }
+`;
+export default Sidebar;

package/es/Layout/dashboard-legacy/header.js

@@ -0,0 +1,174 @@
+import PropTypes from 'prop-types';
+import Button from '@mui/material/IconButton';
+import AppBar from '@mui/material/AppBar';
+import Toolbar from '@mui/material/Toolbar';
+import Box from '@mui/material/Box';
+import Typography from '@mui/material/Typography';
+import Hidden from '@mui/material/Hidden';
+import MenuIcon from '@mui/icons-material/Menu';
+import { Link } from 'react-router-dom';
+import Logo from '../../Logo';
+import { styled } from '../../Theme';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+const StyledAppBar = styled(AppBar)`
+  && {
+    z-index: ${props => props.theme.zIndex.drawer};
+    background: ${props => props.theme.palette.background.default};
+    box-shadow: none;
+    top: 0;
+    height: auto;
+  }
+  .header-toolbar {
+    background: ${props => props.theme.palette.background.default};
+    color: ${props => props.theme.palette.text.primary};
+    margin: ${props => props.theme.spacing(1)}px 0;
+  }
+  .header-link {
+    display: flex;
+    text-decoration: none;
+    flex-shrink: 1;
+    overflow: hidden;
+  }
+  .header-logo {
+    margin-right: 20px;
+  }
+  .header-title {
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    align-items: flex-start;
+  }
+  .header-title__primary {
+    font-size: 24px;
+    font-weight: 800;
+    color: ${props => props.theme.typography.color.main};
+    text-transform: uppercase;
+    display: flex;
+    align-items: center;
+  }
+  .header-title__secondary {
+    font-size: 14px;
+    line-height: 1.71;
+    color: ${props => props.theme.typography.color.gray};
+  }
+
+  .header-addons {
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    flex-shrink: 9999999;
+
+    .user-addon {
+      .header-avatar {
+        width: 32px;
+        border-radius: 16px;
+        height: auto;
+      }
+    }
+  }
+  .header-menu {
+    display: none;
+  }
+  ${props => props.theme.breakpoints.down('md')} {
+    .header-title {
+      display: none;
+    }
+    .header-title__primary {
+      font-size: 20px;
+    }
+    .header-menu {
+      display: block;
+    }
+  }
+`;
+
+/*
+  自定义 logo 相关:
+  如果为 logo prop 传入一个自定义的 svg, 并且 svg 中的元素通过 id 引用了 defs 中的元素 (比如 linearGradient),
+  这种情况下因为 header 和 sidebar 中会各有一个相同的 svg, defs 中元素的 id 会出现冲突,
+  当屏幕较窄时, header 会通过设置 display:none 将 svg logo 隐藏,
+  这会导致 svg defs 中的元素不能被正常引用 (比如 fill 引用的 color 失效), 这会进一步导致 sidebar 中的 logo 不能正常显示.
+  考虑到上述问题, 目前使用 Hidden 组件控制 logo 的显示/隐藏
+  参考: https://blog.patw.me/archives/1820/inline-svg-same-id-and-display-none-issue/
+*/
+export default function Header({
+  children,
+  brand,
+  brandAddon,
+  description,
+  addons,
+  onToggleMenu,
+  homeUrl,
+  logo,
+  ...rest
+}) {
+  return /*#__PURE__*/_jsx(StyledAppBar, {
+    position: "sticky",
+    className: "header",
+    ...rest,
+    children: /*#__PURE__*/_jsxs(Toolbar, {
+      disableGutters: false,
+      className: "header-toolbar",
+      children: [/*#__PURE__*/_jsx(Button, {
+        color: "inherit",
+        "aria-label": "open drawer",
+        edge: "start",
+        className: "header-menu",
+        "aira-label": "header menu button",
+        onClick: onToggleMenu,
+        children: /*#__PURE__*/_jsx(MenuIcon, {})
+      }), /*#__PURE__*/_jsxs(Link, {
+        to: homeUrl,
+        className: "header-link",
+        children: [/*#__PURE__*/_jsx(Hidden, {
+          mdDown: true,
+          children: /*#__PURE__*/_jsx("div", {
+            className: "header-logo",
+            children: logo || /*#__PURE__*/_jsx(Logo, {
+              showText: false
+            })
+          })
+        }), /*#__PURE__*/_jsxs("div", {
+          className: "header-title",
+          children: [/*#__PURE__*/_jsxs(Typography, {
+            component: "h2",
+            noWrap: true,
+            className: "header-title__primary",
+            children: [brand, brandAddon]
+          }), /*#__PURE__*/_jsx(Typography, {
+            component: "p",
+            noWrap: true,
+            className: "header-title__secondary",
+            children: description
+          })]
+        })]
+      }), /*#__PURE__*/_jsx(Box, {
+        flexGrow: 1
+      }), !!children && /*#__PURE__*/_jsx("div", {
+        className: "header-children",
+        children: children
+      }), /*#__PURE__*/_jsx("div", {
+        className: "header-addons",
+        children: addons
+      })]
+    })
+  });
+}
+Header.propTypes = {
+  onToggleMenu: PropTypes.func.isRequired,
+  brand: PropTypes.string.isRequired,
+  brandAddon: PropTypes.object,
+  description: PropTypes.any.isRequired,
+  children: PropTypes.any,
+  addons: PropTypes.any,
+  homeUrl: PropTypes.string,
+  logo: PropTypes.any
+};
+Header.defaultProps = {
+  children: null,
+  addons: null,
+  brandAddon: null,
+  homeUrl: '/',
+  logo: null
+};

package/es/Layout/dashboard-legacy/index.js

@@ -0,0 +1,149 @@
+import { useEffect, useState } from 'react';
+import PropTypes from 'prop-types';
+import Helmet from 'react-helmet';
+import Container from '@mui/material/Container';
+import Box from '@mui/material/Box';
+import Drawer from '@mui/material/Drawer';
+import useWindowSize from 'react-use/lib/useWindowSize';
+import Sidebar from './sidebar';
+import Header from './header';
+import Footer from '../../Footer';
+import { styled } from '../../Theme';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+const Wrapper = styled('div')`
+  &.dashboard {
+    display: flex;
+    flex-direction: column;
+    height: 100vh;
+  }
+  .dashboard__body {
+    overflow: hidden;
+    flex: 1;
+  }
+  .dashboard__main {
+    display: flex;
+    flex-direction: column;
+    overflow: auto;
+    flex: 1;
+  }
+  .dashboard__content {
+    flex: 1;
+  }
+
+  .drawerPaper {
+    position: relative;
+    white-space: nowrap;
+    width: 120px;
+    background: ${props => props.theme.palette.background.default};
+    box-shadow: 2px 16px 10px 0 rgba(0, 0, 0, ${props => props.theme.mode === 'light' ? 0.05 : 0.5});
+    border: 0;
+  }
+`;
+export default function Dashboard({
+  children,
+  title,
+  brand,
+  description,
+  brandAddon,
+  headerAddon,
+  images,
+  links,
+  prefix,
+  fullWidth,
+  contentLayout,
+  className,
+  homeUrl,
+  logo,
+  ...rest
+}) {
+  const breakpoint = 960;
+  const {
+    width
+  } = useWindowSize();
+  const [drawerMode, setDrawerMode] = useState(width >= breakpoint ? 'permanent' : 'temporary');
+  const [drawerOpen, setDrawerOpen] = useState(drawerMode === 'permanent');
+  useEffect(() => {
+    const newMode = width >= breakpoint ? 'permanent' : 'temporary';
+    setDrawerMode(newMode);
+    setDrawerOpen(newMode !== 'temporary');
+  }, [width]);
+  const onToggleDrawer = () => {
+    setDrawerOpen(!drawerOpen);
+  };
+  const isFullWidth = fullWidth || contentLayout === 'row';
+  return /*#__PURE__*/_jsxs(Wrapper, {
+    className: `dashboard ${className}`,
+    ...rest,
+    children: [/*#__PURE__*/_jsx(Helmet, {
+      title: `${title}-${brand}`
+    }), /*#__PURE__*/_jsx(Header, {
+      className: "dashboard__header",
+      onToggleMenu: onToggleDrawer,
+      brand: brand,
+      brandAddon: brandAddon,
+      description: description,
+      addons: headerAddon,
+      homeUrl: homeUrl,
+      logo: logo
+    }), /*#__PURE__*/_jsxs(Box, {
+      display: "flex",
+      className: "dashboard__body",
+      children: [/*#__PURE__*/_jsx(Drawer, {
+        variant: drawerMode,
+        className: "drawer",
+        classes: {
+          paper: 'drawerPaper'
+        },
+        open: drawerOpen,
+        onClose: onToggleDrawer,
+        ModalProps: {
+          disablePortal: true,
+          keepMounted: true
+        },
+        children: /*#__PURE__*/_jsx(Sidebar, {
+          className: "dashboard__sidebar",
+          images: images,
+          links: links,
+          prefix: prefix,
+          logo: logo
+        })
+      }), /*#__PURE__*/_jsxs(Box, {
+        className: "dashboard__main",
+        children: [/*#__PURE__*/_jsx(Container, {
+          maxWidth: isFullWidth ? false : 'lg',
+          className: "dashboard__content",
+          children: children
+        }), /*#__PURE__*/_jsx(Footer, {})]
+      })]
+    })]
+  });
+}
+Dashboard.propTypes = {
+  children: PropTypes.any.isRequired,
+  title: PropTypes.string,
+  brand: PropTypes.string.isRequired,
+  links: PropTypes.array.isRequired,
+  images: PropTypes.object.isRequired,
+  brandAddon: PropTypes.object,
+  description: PropTypes.any.isRequired,
+  headerAddon: PropTypes.any,
+  prefix: PropTypes.string,
+  // 兼容旧版的设置，新版使用 fullWidth 进行设置
+  contentLayout: PropTypes.oneOf(['row', 'column']),
+  fullWidth: PropTypes.bool,
+  className: PropTypes.string,
+  homeUrl: PropTypes.string,
+  logo: PropTypes.any
+};
+Dashboard.defaultProps = {
+  title: 'Home',
+  contentLayout: 'column',
+  headerAddon: null,
+  brandAddon: null,
+  prefix: '/images',
+  fullWidth: false,
+  className: '',
+  homeUrl: '/',
+  logo: null
+};

package/es/Layout/dashboard-legacy/sidebar.js

@@ -0,0 +1,129 @@
+import { memo } from 'react';
+import PropTypes from 'prop-types';
+import { Link, useLocation } from 'react-router-dom';
+import Button from '@mui/material/Button';
+import Typography from '@mui/material/Typography';
+import { teal } from '@mui/material/colors';
+import ImageIcon from '../../Icon/image';
+import Logo from '../../Logo';
+import { styled, useTheme } from '../../Theme';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+export default function Sidebar({
+  images,
+  links,
+  prefix,
+  addons,
+  logo,
+  ...rest
+}) {
+  const theme = useTheme();
+  const location = useLocation();
+  const isSelected = (url, name) => {
+    const pattern = new RegExp(`/${name}`);
+    return pattern.test(location.pathname);
+  };
+  return /*#__PURE__*/_jsxs(MenuItems, {
+    ...rest,
+    children: [/*#__PURE__*/_jsx(Link, {
+      to: "/",
+      className: "sidebar-logo",
+      children: logo || /*#__PURE__*/_jsx(Logo, {
+        showText: false,
+        size: 20
+      })
+    }), links.map(({
+      url,
+      name,
+      title,
+      showBadge
+    }) => {
+      const selected = isSelected(url, name);
+      return /*#__PURE__*/_jsxs(MenuItem, {
+        component: Link,
+        selected: selected,
+        to: url,
+        children: [/*#__PURE__*/_jsx(ImageIcon, {
+          name: images[name],
+          size: 36,
+          color: selected ? '#00c2c4' : theme.typography.color.main,
+          prefix: prefix,
+          showBadge: showBadge
+        }), /*#__PURE__*/_jsx(Typography, {
+          component: "span",
+          className: "menu-title",
+          children: title
+        })]
+      }, url);
+    }), /*#__PURE__*/_jsx("div", {
+      style: {
+        flex: 1
+      }
+    }), addons]
+  });
+}
+Sidebar.propTypes = {
+  images: PropTypes.object.isRequired,
+  links: PropTypes.array.isRequired,
+  prefix: PropTypes.string,
+  addons: PropTypes.any,
+  logo: PropTypes.any
+};
+Sidebar.defaultProps = {
+  prefix: '/images',
+  addons: null,
+  logo: null
+};
+const MenuItems = /*#__PURE__*/memo(styled('div')`
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+
+  && .sidebar-logo {
+    display: none;
+    border-bottom: 1px solid #eee;
+    background: ${props => props.theme.palette.background.default};
+    position: sticky;
+    top: 0;
+    z-index: 1;
+    padding: 10px 0;
+    text-align: center;
+    font-size: 0;
+  }
+  ${props => props.theme.breakpoints.down('md')} {
+    && .sidebar-logo {
+      display: block;
+    }
+  }
+`);
+const gradient = 'linear-gradient(32deg, rgba(144, 255, 230, 0.1), rgba(144, 255, 230, 0))';
+const MenuItem = styled(Button)`
+  && {
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    align-items: center;
+    width: 100%;
+    transition: all 200ms ease-in-out;
+    background: ${props => props.selected ? gradient : ''};
+    padding: 24px 0;
+    border-left: 2px solid ${props => props.selected ? teal.A700 : 'transparent'};
+    border-radius: 0;
+
+    &:hover {
+      background: ${gradient};
+      border-left-color: ${teal.A700};
+    }
+
+    .menu-title {
+      margin-top: 8px;
+      font-size: 12px;
+      font-weight: 500;
+      text-align: center;
+      text-transform: capitalize;
+      letter-spacing: normal;
+      width: 80%;
+      color: ${props => props.theme.palette.text.primary};
+    }
+  }
+`;