Sidebar.tsx 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287
  1. import {
  2. type FC, memo, useCallback, useEffect, useState, useRef, type JSX,
  3. } from 'react';
  4. import withLoadingProps from 'next-dynamic-loading-props';
  5. import dynamic from 'next/dynamic';
  6. import SimpleBar from 'simplebar-react';
  7. import { useIsomorphicLayoutEffect } from 'usehooks-ts';
  8. import { SidebarMode } from '~/interfaces/ui';
  9. import { useIsSearchPage } from '~/states/context';
  10. import { useDeviceLargerThanXl, useDeviceLargerThanMd } from '~/states/ui/device';
  11. import { EditorMode, useEditorMode } from '~/states/ui/editor';
  12. import {
  13. useDrawerOpened,
  14. useSetPreferCollapsedMode,
  15. useSidebarMode,
  16. useCollapsedContentsOpened,
  17. useCurrentProductNavWidth,
  18. useSetSidebarScrollerRef,
  19. } from '~/states/ui/sidebar';
  20. import {
  21. } from '~/stores/ui';
  22. import { DrawerToggler } from '../Common/DrawerToggler';
  23. import { AppTitleOnSidebarHead, AppTitleOnEditorSidebarHead, AppTitleOnSubnavigation } from './AppTitle/AppTitle';
  24. import { ResizableAreaFallback } from './ResizableArea/ResizableAreaFallback';
  25. import type { ResizableAreaProps } from './ResizableArea/props';
  26. import { SidebarHead } from './SidebarHead';
  27. import { SidebarNav, type SidebarNavProps } from './SidebarNav';
  28. import 'simplebar-react/dist/simplebar.min.css';
  29. import styles from './Sidebar.module.scss';
  30. const SidebarContents = dynamic(() => import('./SidebarContents').then(mod => mod.SidebarContents), { ssr: false });
  31. const ResizableArea = withLoadingProps<ResizableAreaProps>(useLoadingProps => dynamic(
  32. () => import('./ResizableArea').then(mod => mod.ResizableArea),
  33. {
  34. ssr: false,
  35. loading: () => {
  36. // eslint-disable-next-line react-hooks/rules-of-hooks
  37. const { children, ...rest } = useLoadingProps();
  38. return <ResizableAreaFallback {...rest}>{children}</ResizableAreaFallback>;
  39. },
  40. },
  41. ));
  42. const resizableAreaMinWidth = 348;
  43. const sidebarNavCollapsedWidth = 48;
  44. const getWidthByMode = (isDrawerMode: boolean, isCollapsedMode: boolean, currentProductNavWidth: number | undefined): number | undefined => {
  45. if (isDrawerMode) {
  46. return undefined;
  47. }
  48. if (isCollapsedMode) {
  49. return sidebarNavCollapsedWidth;
  50. }
  51. return currentProductNavWidth;
  52. };
  53. type ResizableContainerProps = {
  54. children?: React.ReactNode,
  55. }
  56. const ResizableContainer = memo((props: ResizableContainerProps): JSX.Element => {
  57. const { children } = props;
  58. const { isDrawerMode, isCollapsedMode, isDockMode } = useSidebarMode();
  59. const [, setIsDrawerOpened] = useDrawerOpened();
  60. const [currentProductNavWidth, setCurrentProductNavWidth] = useCurrentProductNavWidth();
  61. const setPreferCollapsedMode = useSetPreferCollapsedMode();
  62. const [, setCollapsedContentsOpened] = useCollapsedContentsOpened();
  63. const [isClient, setClient] = useState(false);
  64. const [resizableAreaWidth, setResizableAreaWidth] = useState<number | undefined>(
  65. getWidthByMode(isDrawerMode(), isCollapsedMode(), currentProductNavWidth),
  66. );
  67. const resizeHandler = useCallback((newWidth: number) => {
  68. setResizableAreaWidth(newWidth);
  69. }, []);
  70. const resizeDoneHandler = useCallback((newWidth: number) => {
  71. setCurrentProductNavWidth(newWidth);
  72. }, [setCurrentProductNavWidth]);
  73. const collapsedByResizableAreaHandler = useCallback(() => {
  74. setPreferCollapsedMode(true);
  75. setCollapsedContentsOpened(false);
  76. }, [setCollapsedContentsOpened, setPreferCollapsedMode]);
  77. useIsomorphicLayoutEffect(() => {
  78. setClient(true);
  79. }, []);
  80. // open/close resizable container when drawer mode
  81. useEffect(() => {
  82. setResizableAreaWidth(getWidthByMode(isDrawerMode(), isCollapsedMode(), currentProductNavWidth));
  83. setIsDrawerOpened(false);
  84. }, [currentProductNavWidth, isCollapsedMode, isDrawerMode, setIsDrawerOpened]);
  85. return !isClient
  86. ? (
  87. <ResizableAreaFallback
  88. className="flex-expand-vert"
  89. width={resizableAreaWidth}
  90. >
  91. {children}
  92. </ResizableAreaFallback>
  93. )
  94. : (
  95. <ResizableArea
  96. className="flex-expand-vert"
  97. width={resizableAreaWidth}
  98. minWidth={resizableAreaMinWidth}
  99. disabled={!isDockMode()}
  100. onResize={resizeHandler}
  101. onResizeDone={resizeDoneHandler}
  102. onCollapsed={collapsedByResizableAreaHandler}
  103. >
  104. {children}
  105. </ResizableArea>
  106. );
  107. });
  108. type CollapsibleContainerProps = {
  109. Nav: FC<SidebarNavProps>,
  110. className?: string,
  111. children?: React.ReactNode,
  112. }
  113. const CollapsibleContainer = memo((props: CollapsibleContainerProps): JSX.Element => {
  114. const { Nav, className, children } = props;
  115. const { isCollapsedMode } = useSidebarMode();
  116. const [currentProductNavWidth] = useCurrentProductNavWidth();
  117. const [isCollapsedContentsOpened, setCollapsedContentsOpened] = useCollapsedContentsOpened();
  118. const sidebarScrollerRef = useRef<HTMLDivElement>(null);
  119. const setSidebarScrollerRef = useSetSidebarScrollerRef();
  120. // Set the ref once on mount
  121. useEffect(() => {
  122. setSidebarScrollerRef(sidebarScrollerRef);
  123. }, [setSidebarScrollerRef]);
  124. // open menu when collapsed mode
  125. const primaryItemHoverHandler = useCallback(() => {
  126. // reject other than collapsed mode
  127. if (!isCollapsedMode()) {
  128. return;
  129. }
  130. setCollapsedContentsOpened(true);
  131. }, [isCollapsedMode, setCollapsedContentsOpened]);
  132. // close menu when collapsed mode
  133. const mouseLeaveHandler = useCallback(() => {
  134. // reject other than collapsed mode
  135. if (!isCollapsedMode()) {
  136. return;
  137. }
  138. setCollapsedContentsOpened(false);
  139. }, [isCollapsedMode, setCollapsedContentsOpened]);
  140. const closedClass = isCollapsedMode() && !isCollapsedContentsOpened ? 'd-none' : '';
  141. const openedClass = isCollapsedMode() && isCollapsedContentsOpened ? 'open' : '';
  142. const collapsibleContentsWidth = isCollapsedMode() ? currentProductNavWidth : undefined;
  143. return (
  144. <div className={`flex-expand-horiz ${className}`} onMouseLeave={mouseLeaveHandler}>
  145. <Nav onPrimaryItemHover={primaryItemHoverHandler} />
  146. <div
  147. className={`sidebar-contents-container flex-grow-1 overflow-hidden ${closedClass} ${openedClass}`}
  148. >
  149. <SimpleBar
  150. scrollableNodeProps={{ ref: sidebarScrollerRef }}
  151. className="simple-scrollbar h-100"
  152. style={{ width: collapsibleContentsWidth }}
  153. autoHide
  154. >
  155. {children}
  156. </SimpleBar>
  157. </div>
  158. </div>
  159. );
  160. });
  161. // for data-* attributes
  162. type HTMLElementProps = JSX.IntrinsicElements &
  163. Record<keyof JSX.IntrinsicElements, { [p: `data-${string}`]: string | number }>;
  164. type DrawableContainerProps = {
  165. divProps?: HTMLElementProps['div'],
  166. className?: string,
  167. children?: React.ReactNode,
  168. }
  169. const DrawableContainer = memo((props: DrawableContainerProps): JSX.Element => {
  170. const { divProps, className, children } = props;
  171. const [isDrawerOpened, setIsDrawerOpened] = useDrawerOpened();
  172. const openClass = `${isDrawerOpened ? 'open' : ''}`;
  173. return (
  174. <>
  175. <div {...divProps} className={`${className} ${openClass}`}>
  176. {children}
  177. </div>
  178. {isDrawerOpened && (
  179. <div className="modal-backdrop fade show" onClick={() => setIsDrawerOpened(false)} />
  180. )}
  181. </>
  182. );
  183. });
  184. export const Sidebar = (): JSX.Element => {
  185. const {
  186. sidebarMode,
  187. isDrawerMode, isCollapsedMode, isDockMode,
  188. } = useSidebarMode();
  189. const isSearchPage = useIsSearchPage();
  190. const { editorMode } = useEditorMode();
  191. const [isMdSize] = useDeviceLargerThanMd();
  192. const [isXlSize] = useDeviceLargerThanXl();
  193. const isEditorMode = editorMode === EditorMode.Editor;
  194. const shouldHideSiteName = isEditorMode && isXlSize;
  195. const shouldHideSubnavAppTitle = isEditorMode && isMdSize && (isDrawerMode() || isCollapsedMode());
  196. const shouldShowEditorSidebarHead = isEditorMode && isXlSize;
  197. // css styles
  198. const grwSidebarClass = styles['grw-sidebar'];
  199. // eslint-disable-next-line no-nested-ternary
  200. let modeClass;
  201. switch (sidebarMode) {
  202. case SidebarMode.DRAWER:
  203. modeClass = 'grw-sidebar-drawer';
  204. break;
  205. case SidebarMode.COLLAPSED:
  206. modeClass = 'grw-sidebar-collapsed';
  207. break;
  208. case SidebarMode.DOCK:
  209. modeClass = 'grw-sidebar-dock';
  210. break;
  211. }
  212. return (
  213. <>
  214. {sidebarMode != null && isDrawerMode() && (
  215. <DrawerToggler className="position-fixed d-none d-md-block">
  216. <span className="material-symbols-outlined">reorder</span>
  217. </DrawerToggler>
  218. )}
  219. {sidebarMode != null && !isDockMode() && !isSearchPage && !shouldHideSubnavAppTitle && (
  220. <AppTitleOnSubnavigation />
  221. )}
  222. <DrawableContainer className={`${grwSidebarClass} ${modeClass} border-end flex-expand-vh-100`} divProps={{ 'data-testid': 'grw-sidebar' }}>
  223. <ResizableContainer>
  224. {sidebarMode != null && !isCollapsedMode() && (
  225. <AppTitleOnSidebarHead hideAppTitle={shouldHideSiteName} />
  226. )}
  227. {shouldShowEditorSidebarHead ? <AppTitleOnEditorSidebarHead /> : <SidebarHead />}
  228. <CollapsibleContainer Nav={SidebarNav} className="border-top">
  229. <SidebarContents />
  230. </CollapsibleContainer>
  231. </ResizableContainer>
  232. </DrawableContainer>
  233. </>
  234. );
  235. };