refactor(v2): simplify and optimize sidebar (#4617)

* safe sidebar refactor

* simplify and optimize a bit the sidebar code

packages/docusaurus-theme-classic/src/theme/DocSidebar/index.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React, {useState, useCallback, useEffect, useRef, useMemo} from 'react';
+import React, {useState, useCallback, useEffect, useRef, memo} from 'react';
 import clsx from 'clsx';
 import {useThemeConfig, isSamePath} from '@docusaurus/theme-common';
 import useUserPreferencesContext from '@theme/hooks/useUserPreferencesContext';
@@ -44,6 +44,32 @@ const isActiveSidebarItem = (item, activePath) => {
   return false;
 };
 
+// Optimize sidebar at each "level"
+// TODO this item should probably not receive the "activePath" props
+// TODO this triggers whole sidebar re-renders on navigation
+const DocSidebarItems = memo(function DocSidebarItems({
+  items,
+  ...props
+}: any): JSX.Element {
+  return items.map((item, index) => (
+    <DocSidebarItem
+      key={index} // sidebar is static, the index does not change
+      item={item}
+      {...props}
+    />
+  ));
+});
+
+function DocSidebarItem(props): JSX.Element {
+  switch (props.item.type) {
+    case 'category':
+      return <DocSidebarItemCategory {...props} />;
+    case 'link':
+    default:
+      return <DocSidebarItemLink {...props} />;
+  }
+}
+
 function DocSidebarItemCategory({
   item,
   onItemClick,
@@ -104,8 +130,7 @@ function DocSidebarItemCategory({
     <li
       className={clsx('menu__list-item', {
         'menu__list-item--collapsed': collapsed,
-      })}
+      })}>
-      key={label}>
       <a
         className={clsx('menu__link', {
           'menu__link--sublist': collapsible,
@@ -128,16 +153,13 @@ function DocSidebarItemCategory({
             handleMenuListHeight(false);
           }
         }}>
-        {items.map((childItem) => (
+        <DocSidebarItems
-          <DocSidebarItem
+          items={items}
-            tabIndex={collapsed ? '-1' : '0'}
+          tabIndex={collapsed ? '-1' : '0'}
-            key={childItem.label}
+          onItemClick={onItemClick}
-            item={childItem}
+          collapsible={collapsible}
-            onItemClick={onItemClick}
+          activePath={activePath}
-            collapsible={collapsible}
+        />
-            activePath={activePath}
-          />
-        ))}
       </ul>
     </li>
   );
@@ -172,37 +194,24 @@ function DocSidebarItemLink({
   );
 }
 
-function DocSidebarItem(props): JSX.Element {
+function useShowAnnouncementBar() {
-  switch (props.item.type) {
+  const {isAnnouncementBarClosed} = useUserPreferencesContext();
-    case 'category':
+  const [showAnnouncementBar, setShowAnnouncementBar] = useState(
-      return <DocSidebarItemCategory {...props} />;
+    !isAnnouncementBarClosed,
-    case 'link':
+  );
-    default:
+  useScrollPosition(({scrollY}) => {
-      return <DocSidebarItemLink {...props} />;
+    if (!isAnnouncementBarClosed) {
-  }
+      setShowAnnouncementBar(scrollY === 0);
+    }
+  });
+  return showAnnouncementBar;
 }
 
-function DocSidebar({
+function useResponsiveSidebar() {
-  path,
-  sidebar,
-  sidebarCollapsible = true,
-  onCollapse,
-  isHidden,
-}: Props): JSX.Element | null {
   const [showResponsiveSidebar, setShowResponsiveSidebar] = useState(false);
-  const [showAnnouncementBar, setShowAnnouncementBar] = useState(true);
-  const {
-    navbar: {hideOnScroll},
-    hideableSidebar,
-  } = useThemeConfig();
-  const {isAnnouncementBarClosed} = useUserPreferencesContext();
-  useScrollPosition(({scrollY}) => {
-    setShowAnnouncementBar(scrollY === 0);
-  });
-
   useLockBodyScroll(showResponsiveSidebar);
-  const windowSize = useWindowSize();
 
+  const windowSize = useWindowSize();
   useEffect(() => {
     if (windowSize === windowSizes.desktop) {
       setShowResponsiveSidebar(false);
@@ -216,19 +225,99 @@ function DocSidebar({
     },
     [setShowResponsiveSidebar],
   );
-  const sidebarItems = useMemo(
+
-    () =>
+  const toggleResponsiveSidebar = useCallback(() => {
-      sidebar.map((item) => (
+    setShowResponsiveSidebar(!showResponsiveSidebar);
-        <DocSidebarItem
+  }, [setShowResponsiveSidebar]);
-          key={item.label}
+
-          item={item}
+  return {
-          onItemClick={closeResponsiveSidebar}
+    showResponsiveSidebar,
-          collapsible={sidebarCollapsible}
+    closeResponsiveSidebar,
-          activePath={path}
+    toggleResponsiveSidebar,
-        />
+  };
-      )),
+}
-    [sidebar, sidebarCollapsible, path, closeResponsiveSidebar],
+
+function HideableSidebarButton({onClick}) {
+  return (
+    <button
+      type="button"
+      title={translate({
+        id: 'theme.docs.sidebar.collapseButtonTitle',
+        message: 'Collapse sidebar',
+        description: 'The title attribute for collapse button of doc sidebar',
+      })}
+      aria-label={translate({
+        id: 'theme.docs.sidebar.collapseButtonAriaLabel',
+        message: 'Collapse sidebar',
+        description: 'The title attribute for collapse button of doc sidebar',
+      })}
+      className={clsx(
+        'button button--secondary button--outline',
+        styles.collapseSidebarButton,
+      )}
+      onClick={onClick}>
+      <IconArrow className={styles.collapseSidebarButtonIcon} />
+    </button>
   );
+}
+
+function ResponsiveSidebarButton({responsiveSidebarOpened, onClick}) {
+  return (
+    <button
+      aria-label={
+        responsiveSidebarOpened
+          ? translate({
+              id: 'theme.docs.sidebar.responsiveCloseButtonLabel',
+              message: 'Close menu',
+              description:
+                'The ARIA label for close button of mobile doc sidebar',
+            })
+          : translate({
+              id: 'theme.docs.sidebar.responsiveOpenButtonLabel',
+              message: 'Open menu',
+              description:
+                'The ARIA label for open button of mobile doc sidebar',
+            })
+      }
+      aria-haspopup="true"
+      className="button button--secondary button--sm menu__button"
+      type="button"
+      onClick={onClick}>
+      {responsiveSidebarOpened ? (
+        <span
+          className={clsx(styles.sidebarMenuIcon, styles.sidebarMenuCloseIcon)}>
+          &times;
+        </span>
+      ) : (
+        <IconMenu
+          className={styles.sidebarMenuIcon}
+          height={MOBILE_TOGGLE_SIZE}
+          width={MOBILE_TOGGLE_SIZE}
+        />
+      )}
+    </button>
+  );
+}
+
+function DocSidebar({
+  path,
+  sidebar,
+  sidebarCollapsible = true,
+  onCollapse,
+  isHidden,
+}: Props): JSX.Element | null {
+  const showAnnouncementBar = useShowAnnouncementBar();
+  const {
+    navbar: {hideOnScroll},
+    hideableSidebar,
+  } = useThemeConfig();
+  const {isAnnouncementBarClosed} = useUserPreferencesContext();
+
+  const {
+    showResponsiveSidebar,
+    closeResponsiveSidebar,
+    toggleResponsiveSidebar,
+  } = useResponsiveSidebar();
 
   return (
     <div
@@ -249,69 +338,20 @@ function DocSidebar({
               !isAnnouncementBarClosed && showAnnouncementBar,
           },
         )}>
-        <button
+        <ResponsiveSidebarButton
-          aria-label={
+          responsiveSidebarOpened={showResponsiveSidebar}
-            showResponsiveSidebar
+          onClick={toggleResponsiveSidebar}
-              ? translate({
+        />
-                  id: 'theme.docs.sidebar.responsiveCloseButtonLabel',
+        <ul className="menu__list">
-                  message: 'Close menu',
+          <DocSidebarItems
-                  description:
+            items={sidebar}
-                    'The ARIA label for close button of mobile doc sidebar',
+            onItemClick={closeResponsiveSidebar}
-                })
+            collapsible={sidebarCollapsible}
-              : translate({
+            activePath={path}
-                  id: 'theme.docs.sidebar.responsiveOpenButtonLabel',
+          />
-                  message: 'Open menu',
+        </ul>
-                  description:
-                    'The ARIA label for open button of mobile doc sidebar',
-                })
-          }
-          aria-haspopup="true"
-          className="button button--secondary button--sm menu__button"
-          type="button"
-          onClick={() => {
-            setShowResponsiveSidebar(!showResponsiveSidebar);
-          }}>
-          {showResponsiveSidebar ? (
-            <span
-              className={clsx(
-                styles.sidebarMenuIcon,
-                styles.sidebarMenuCloseIcon,
-              )}>
-              &times;
-            </span>
-          ) : (
-            <IconMenu
-              className={styles.sidebarMenuIcon}
-              height={MOBILE_TOGGLE_SIZE}
-              width={MOBILE_TOGGLE_SIZE}
-            />
-          )}
-        </button>
-        <ul className="menu__list">{sidebarItems}</ul>
       </div>
-      {hideableSidebar && (
+      {hideableSidebar && <HideableSidebarButton onClick={onCollapse} />}
-        <button
-          type="button"
-          title={translate({
-            id: 'theme.docs.sidebar.collapseButtonTitle',
-            message: 'Collapse sidebar',
-            description:
-              'The title attribute for collapse button of doc sidebar',
-          })}
-          aria-label={translate({
-            id: 'theme.docs.sidebar.collapseButtonAriaLabel',
-            message: 'Collapse sidebar',
-            description:
-              'The title attribute for collapse button of doc sidebar',
-          })}
-          className={clsx(
-            'button button--secondary button--outline',
-            styles.collapseSidebarButton,
-          )}
-          onClick={onCollapse}>
-          <IconArrow className={styles.collapseSidebarButtonIcon} />
-        </button>
-      )}
     </div>
   );
 }