@toolpad/core
Version:
Dashboard framework powered by Material UI.
460 lines (459 loc) • 19.5 kB
JavaScript
"use strict";
'use client';
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.DashboardLayout = DashboardLayout;
var React = _interopRequireWildcard(require("react"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _material = require("@mui/material");
var _AppBar = _interopRequireDefault(require("@mui/material/AppBar"));
var _Box = _interopRequireDefault(require("@mui/material/Box"));
var _Drawer = _interopRequireDefault(require("@mui/material/Drawer"));
var _IconButton = _interopRequireDefault(require("@mui/material/IconButton"));
var _Stack = _interopRequireDefault(require("@mui/material/Stack"));
var _Toolbar2 = _interopRequireDefault(require("@mui/material/Toolbar"));
var _Tooltip = _interopRequireDefault(require("@mui/material/Tooltip"));
var _useMediaQuery = _interopRequireDefault(require("@mui/material/useMediaQuery"));
var _Menu = _interopRequireDefault(require("@mui/icons-material/Menu"));
var _MenuOpen = _interopRequireDefault(require("@mui/icons-material/MenuOpen"));
var _warnOnce = _interopRequireDefault(require("@toolpad/utils/warnOnce"));
var _context = require("../shared/context");
var _Account = require("../Account");
var _DashboardSidebarSubNavigation = require("./DashboardSidebarSubNavigation");
var _ToolbarActions = require("./ToolbarActions");
var _AppTitle = require("./AppTitle");
var _utils = require("./utils");
var _shared = require("./shared");
var _jsxRuntime = require("react/jsx-runtime");
var _MenuOpenIcon, _MenuIcon, _Toolbar;
function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
const AppBar = (0, _material.styled)(_AppBar.default)(({
theme
}) => ({
borderWidth: 0,
borderBottomWidth: 1,
borderStyle: 'solid',
borderColor: (theme.vars ?? theme).palette.divider,
boxShadow: 'none',
zIndex: theme.zIndex.drawer + 1
}));
/**
*
* Demos:
*
* - [Dashboard Layout](https://mui.com/toolpad/core/react-dashboard-layout/)
*
* API:
*
* - [DashboardLayout API](https://mui.com/toolpad/core/api/dashboard-layout)
*/
function DashboardLayout(props) {
const {
children,
branding: brandingProp,
navigation: navigationProp,
defaultSidebarCollapsed = false,
disableCollapsibleSidebar = false,
hideNavigation = false,
sidebarExpandedWidth = 320,
renderPageItem,
slots,
slotProps,
sx
} = props;
if (navigationProp && process.env.NODE_ENV !== 'production') {
(0, _warnOnce.default)('The navigation prop in the DashboardLayout component is deprecated and will eventually be removed. Set the navigation prop in the AppProvider instead (https://mui.com/toolpad/core/react-app-provider/#navigation).');
}
const theme = (0, _material.useTheme)();
const brandingContext = React.useContext(_context.BrandingContext);
const navigationContext = React.useContext(_context.NavigationContext);
const appWindowContext = React.useContext(_context.WindowContext);
const branding = {
...brandingContext,
...brandingProp
};
const navigation = navigationProp ?? navigationContext;
const [isDesktopNavigationExpanded, setIsDesktopNavigationExpanded] = React.useState(!defaultSidebarCollapsed);
const [isMobileNavigationExpanded, setIsMobileNavigationExpanded] = React.useState(false);
const isOverSmViewport = (0, _useMediaQuery.default)(theme.breakpoints.up('sm'), appWindowContext && {
matchMedia: appWindowContext.matchMedia
});
const isOverMdViewport = (0, _useMediaQuery.default)(theme.breakpoints.up('md'), appWindowContext && {
matchMedia: appWindowContext.matchMedia
});
const isNavigationExpanded = isOverMdViewport ? isDesktopNavigationExpanded : isMobileNavigationExpanded;
const setIsNavigationExpanded = React.useCallback(newExpanded => {
if (isOverMdViewport) {
setIsDesktopNavigationExpanded(newExpanded);
} else {
setIsMobileNavigationExpanded(newExpanded);
}
}, [isOverMdViewport]);
const [isNavigationFullyExpanded, setIsNavigationFullyExpanded] = React.useState(isNavigationExpanded);
const [isNavigationFullyCollapsed, setIsNavigationFullyCollapsed] = React.useState(!isNavigationExpanded);
React.useEffect(() => {
if (isNavigationExpanded) {
const drawerWidthTransitionTimeout = setTimeout(() => {
setIsNavigationFullyExpanded(true);
}, theme.transitions.duration.enteringScreen);
return () => clearTimeout(drawerWidthTransitionTimeout);
}
setIsNavigationFullyExpanded(false);
return () => {};
}, [isNavigationExpanded, theme]);
React.useEffect(() => {
if (!isNavigationExpanded) {
const drawerWidthTransitionTimeout = setTimeout(() => {
setIsNavigationFullyCollapsed(true);
}, theme.transitions.duration.leavingScreen);
return () => clearTimeout(drawerWidthTransitionTimeout);
}
setIsNavigationFullyCollapsed(false);
return () => {};
}, [isNavigationExpanded, theme]);
const handleSetNavigationExpanded = React.useCallback(newExpanded => () => {
setIsNavigationExpanded(newExpanded);
}, [setIsNavigationExpanded]);
const toggleNavigationExpanded = React.useCallback(() => {
setIsNavigationExpanded(!isNavigationExpanded);
}, [isNavigationExpanded, setIsNavigationExpanded]);
const handleNavigationLinkClick = React.useCallback(() => {
setIsMobileNavigationExpanded(false);
}, [setIsMobileNavigationExpanded]);
const isDesktopMini = !disableCollapsibleSidebar && !isDesktopNavigationExpanded;
const isMobileMini = !disableCollapsibleSidebar && !isMobileNavigationExpanded;
const getMenuIcon = React.useCallback(isExpanded => {
const expandMenuActionText = 'Expand';
const collapseMenuActionText = 'Collapse';
return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Tooltip.default, {
title: `${isExpanded ? collapseMenuActionText : expandMenuActionText} menu`,
enterDelay: 1000,
children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_IconButton.default, {
"aria-label": `${isExpanded ? collapseMenuActionText : expandMenuActionText} navigation menu`,
onClick: toggleNavigationExpanded,
children: isExpanded ? _MenuOpenIcon || (_MenuOpenIcon = /*#__PURE__*/(0, _jsxRuntime.jsx)(_MenuOpen.default, {})) : _MenuIcon || (_MenuIcon = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Menu.default, {}))
})
})
});
}, [toggleNavigationExpanded]);
const hasDrawerTransitions = isOverSmViewport && (!disableCollapsibleSidebar || isOverMdViewport);
const ToolbarActionsSlot = slots?.toolbarActions ?? _ToolbarActions.ToolbarActions;
const ToolbarAccountSlot = slots?.toolbarAccount ?? _Account.Account;
const SidebarFooterSlot = slots?.sidebarFooter ?? null;
const getDrawerContent = React.useCallback((isMini, viewport) => /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
children: [_Toolbar || (_Toolbar = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Toolbar2.default, {})), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box.default, {
component: "nav",
"aria-label": `${viewport.charAt(0).toUpperCase()}${viewport.slice(1)}`,
sx: {
height: '100%',
display: 'flex',
flexDirection: 'column',
justifyContent: 'space-between',
overflow: 'auto',
scrollbarGutter: isMini ? 'stable' : 'auto',
overflowX: 'hidden',
pt: navigation[0]?.kind === 'header' && !isMini ? 0 : 2,
...(hasDrawerTransitions ? (0, _utils.getDrawerSxTransitionMixin)(isNavigationFullyExpanded, 'padding') : {})
},
children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_DashboardSidebarSubNavigation.DashboardSidebarSubNavigation, {
subNavigation: navigation,
onLinkClick: handleNavigationLinkClick,
isMini: isMini,
isFullyExpanded: isNavigationFullyExpanded,
isFullyCollapsed: isNavigationFullyCollapsed,
hasDrawerTransitions: hasDrawerTransitions,
sidebarExpandedWidth: sidebarExpandedWidth,
renderPageItem: renderPageItem
}), SidebarFooterSlot ? /*#__PURE__*/(0, _jsxRuntime.jsx)(SidebarFooterSlot, {
mini: isMini,
...slotProps?.sidebarFooter
}) : null]
})]
}), [SidebarFooterSlot, handleNavigationLinkClick, hasDrawerTransitions, isNavigationFullyCollapsed, isNavigationFullyExpanded, navigation, sidebarExpandedWidth, renderPageItem, slotProps?.sidebarFooter]);
const getDrawerSharedSx = React.useCallback((isMini, isTemporary) => {
const drawerWidth = isMini ? _shared.MINI_DRAWER_WIDTH : sidebarExpandedWidth;
return {
displayPrint: 'none',
width: drawerWidth,
flexShrink: 0,
...(0, _utils.getDrawerWidthTransitionMixin)(isNavigationExpanded),
...(isTemporary ? {
position: 'absolute'
} : {}),
[`& .MuiDrawer-paper`]: {
position: 'absolute',
width: drawerWidth,
boxSizing: 'border-box',
backgroundImage: 'none',
...(0, _utils.getDrawerWidthTransitionMixin)(isNavigationExpanded)
}
};
}, [isNavigationExpanded, sidebarExpandedWidth]);
return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box.default, {
sx: {
position: 'relative',
display: 'flex',
overflow: 'hidden',
height: '100vh',
width: '100vw',
...sx
},
children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(AppBar, {
color: "inherit",
position: "absolute",
sx: {
displayPrint: 'none'
},
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Toolbar2.default, {
sx: {
backgroundColor: 'inherit',
mx: {
xs: -0.75,
sm: -1
}
},
children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Stack.default, {
direction: "row",
justifyContent: "space-between",
alignItems: "center",
sx: {
flexWrap: 'wrap',
width: '100%'
},
children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_Stack.default, {
direction: "row",
children: [!hideNavigation ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
sx: {
mr: {
sm: disableCollapsibleSidebar ? 0 : 1
},
display: {
md: 'none'
}
},
children: getMenuIcon(isMobileNavigationExpanded)
}), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
sx: {
display: {
xs: 'none',
md: disableCollapsibleSidebar ? 'none' : 'block'
},
mr: disableCollapsibleSidebar ? 0 : 1
},
children: getMenuIcon(isDesktopNavigationExpanded)
})]
}) : null, slots?.appTitle ? /*#__PURE__*/(0, _jsxRuntime.jsx)(slots.appTitle, {
...slotProps?.appTitle
}) :
/*#__PURE__*/
/* Hierarchy of application of `branding`
* 1. Branding prop passed in the `slotProps.appTitle`
* 2. Branding prop passed to the `DashboardLayout`
* 3. Branding prop passed to the `AppProvider`
*/
(0, _jsxRuntime.jsx)(_AppTitle.AppTitle, {
branding: branding,
...slotProps?.appTitle
})]
}), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Stack.default, {
direction: "row",
alignItems: "center",
spacing: 1,
sx: {
marginLeft: 'auto'
},
children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(ToolbarActionsSlot, {
...slotProps?.toolbarActions
}), /*#__PURE__*/(0, _jsxRuntime.jsx)(ToolbarAccountSlot, {
...slotProps?.toolbarAccount
})]
})]
})
})
}), !hideNavigation ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Drawer.default, {
container: appWindowContext?.document.body,
variant: "temporary",
open: isMobileNavigationExpanded,
onClose: handleSetNavigationExpanded(false),
ModalProps: {
keepMounted: true // Better open performance on mobile.
},
sx: {
display: {
xs: 'block',
sm: disableCollapsibleSidebar ? 'block' : 'none',
md: 'none'
},
...getDrawerSharedSx(false, true)
},
children: getDrawerContent(false, 'phone')
}), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Drawer.default, {
variant: "permanent",
sx: {
display: {
xs: 'none',
sm: disableCollapsibleSidebar ? 'none' : 'block',
md: 'none'
},
...getDrawerSharedSx(isMobileMini, false)
},
children: getDrawerContent(isMobileMini, 'tablet')
}), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Drawer.default, {
variant: "permanent",
sx: {
display: {
xs: 'none',
md: 'block'
},
...getDrawerSharedSx(isDesktopMini, false)
},
children: getDrawerContent(isDesktopMini, 'desktop')
})]
}) : null, /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box.default, {
sx: {
display: 'flex',
flexDirection: 'column',
flex: 1,
minWidth: 0
},
children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Toolbar2.default, {
sx: {
displayPrint: 'none'
}
}), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
component: "main",
sx: {
display: 'flex',
flexDirection: 'column',
flex: 1,
overflow: 'auto'
},
children: children
})]
})]
});
}
process.env.NODE_ENV !== "production" ? DashboardLayout.propTypes /* remove-proptypes */ = {
// ┌────────────────────────────── Warning ──────────────────────────────┐
// │ These PropTypes are generated from the TypeScript type definitions. │
// │ To update them, edit the TypeScript types and run `pnpm proptypes`. │
// └─────────────────────────────────────────────────────────────────────┘
/**
* Branding options for the dashboard.
* @default null
*/
branding: _propTypes.default.shape({
homeUrl: _propTypes.default.string,
logo: _propTypes.default.node,
title: _propTypes.default.string
}),
/**
* The content of the dashboard.
*/
children: _propTypes.default.node,
/**
* Whether the sidebar should start collapsed in desktop size screens.
* @default false
*/
defaultSidebarCollapsed: _propTypes.default.bool,
/**
* Whether the sidebar should not be collapsible to a mini variant in desktop and tablet viewports.
* @default false
*/
disableCollapsibleSidebar: _propTypes.default.bool,
/**
* Whether the navigation bar and menu icon should be hidden.
* @default false
*/
hideNavigation: _propTypes.default.bool,
/**
* Navigation definition for the dashboard. [Find out more](https://mui.com/toolpad/core/react-dashboard-layout/#navigation).
* @default []
* @deprecated Set the navigation in the [AppProvider](https://mui.com/toolpad/core/react-app-provider/#navigation) instead.
*/
navigation: _propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.shape({
action: _propTypes.default.node,
children: _propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.object, _propTypes.default.shape({
kind: _propTypes.default.oneOf(['header']).isRequired,
title: _propTypes.default.string.isRequired
}), _propTypes.default.shape({
kind: _propTypes.default.oneOf(['divider']).isRequired
})]).isRequired),
icon: _propTypes.default.node,
kind: _propTypes.default.oneOf(['page']),
pattern: _propTypes.default.string,
segment: _propTypes.default.string,
title: _propTypes.default.string
}), _propTypes.default.shape({
kind: _propTypes.default.oneOf(['header']).isRequired,
title: _propTypes.default.string.isRequired
}), _propTypes.default.shape({
kind: _propTypes.default.oneOf(['divider']).isRequired
})]).isRequired),
/**
* Render each page item.
*
* @param {NavigationPageItem} item
* @param {{ mini: boolean }} params
* @returns {ReactNode}
*/
renderPageItem: _propTypes.default.func,
/**
* Width of the sidebar when expanded.
* @default 320
*/
sidebarExpandedWidth: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
/**
* The props used for each slot inside.
* @default {}
*/
slotProps: _propTypes.default.shape({
appTitle: _propTypes.default.shape({
branding: _propTypes.default.shape({
homeUrl: _propTypes.default.string,
logo: _propTypes.default.node,
title: _propTypes.default.string
})
}),
sidebarFooter: _propTypes.default.shape({
mini: _propTypes.default.bool.isRequired
}),
toolbarAccount: _propTypes.default.shape({
localeText: _propTypes.default.object,
slotProps: _propTypes.default.shape({
popover: _propTypes.default.object,
popoverContent: _propTypes.default.object,
preview: _propTypes.default.object,
signInButton: _propTypes.default.object,
signOutButton: _propTypes.default.object
}),
slots: _propTypes.default.shape({
popover: _propTypes.default.elementType,
popoverContent: _propTypes.default.elementType,
preview: _propTypes.default.elementType,
signInButton: _propTypes.default.elementType,
signOutButton: _propTypes.default.elementType
})
}),
toolbarActions: _propTypes.default.object
}),
/**
* The components used for each slot inside.
* @default {}
*/
slots: _propTypes.default.shape({
appTitle: _propTypes.default.elementType,
sidebarFooter: _propTypes.default.elementType,
toolbarAccount: _propTypes.default.elementType,
toolbarActions: _propTypes.default.elementType
}),
/**
* The system prop that allows defining system overrides as well as additional CSS styles.
*/
sx: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object, _propTypes.default.bool])), _propTypes.default.func, _propTypes.default.object])
} : void 0;