feat(theme-default): collapsible nested item in sidebar (close #883) (#1158)

Co-authored-by: meteorlxy <meteor.lxy@foxmail.com>

Author: pplr

docs/reference/default-theme/config.md

@@ -313,7 +313,7 @@ export default {
 
   To configure the sidebar items manually, you can set this option to a _sidebar array_, each item of which could be a `SidebarItem` object or a string:
 
-  - A `SidebarItem` object should have a `text` field, could have an optional `link` field and an optional `children` field. The `children` field should be a _sidebar array_. When a `SidebarItem` object is placed at the root-level, it could have an extra optional `collapsible` field to control whether it is collapsible.
+  - A `SidebarItem` object should have a `text` field, could have an optional `link` field, an optional `children` field and an optional `collapsible` field. The `children` field should be a _sidebar array_. The `collapsible` field controls whether the item is collapsible.
   - A string should be the path to the target page file. It will be converted to a `SidebarItem` object, whose `text` is the page title, `link` is the page route path, and `children` is automatically generated from the page headers.
 
   If you want to set different sidebar for different sub paths, you can set this option to a _sidebar object_:

docs/zh/reference/default-theme/config.md

@@ -313,7 +313,7 @@ export default {
 
   为了手动配置侧边栏元素，你可以将其设置为 _侧边栏数组_ ，其中的每个元素是一个 `SidebarItem` 对象或者一个字符串：
 
-  - `SidebarItem` 对象应该有一个 `text` 字段，有一个可选的 `link` 字段和一个可选的 `children` 字段。 `children` 字段同样是一个 _侧边栏数组_ 。当 `SidebarItem` 对象处于根节点时，它还有一个额外可选的 `collapsible` 字段来控制它是否可折叠。
+  - `SidebarItem` 对象应该有一个 `text` 字段，有一个可选的 `link` 字段、一个可选的 `children` 字段和一个可选的 `collapsible` 字段。 `children` 字段同样是一个 _侧边栏数组_ 。 `collapsible` 字段来控制它是否可折叠。
   - 字符串应为目标页面文件的路径。它将会被转换为 `SidebarItem` 对象，将页面标题作为 `text` ，将页面路由路径作为 `link` ，并根据页面小标题自动生成 `children` 。
 
   如果你想在不同子路径中使用不同的侧边栏，你可以将该配置项设置为 _侧边栏对象_ ：

ecosystem/theme-default/src/client/styles/sidebar.scss

@@ -83,15 +83,15 @@
       @include dropdown_wrapper;
       margin-bottom: 0.75rem;
     }
+  }
 
-    &.collapsible {
-      cursor: pointer;
+  &.collapsible {
+    cursor: pointer;
 
-      .arrow {
-        position: relative;
-        top: -0.12em;
-        left: 0.5em;
-      }
+    .arrow {
+      position: relative;
+      top: -0.12em;
+      left: 0.5em;
     }
   }
 

ecosystem/theme-default/src/shared/nav.ts

@@ -39,15 +39,10 @@ export type ResolvedNavbarItem = NavbarItem | NavGroup<ResolvedNavbarItem>
 // user config
 export type SidebarItem = NavItem & Partial<NavLink>
 export type SidebarGroup = SidebarItem &
-  NavGroup<SidebarItem | SidebarGroup | string>
-export type SidebarGroupCollapsible = SidebarGroup & {
-  collapsible?: boolean
-}
-export type SidebarConfigArray = (
-  | SidebarItem
-  | SidebarGroupCollapsible
-  | string
-)[]
+  NavGroup<SidebarItem | SidebarGroup | string> & {
+    collapsible?: boolean
+  }
+export type SidebarConfigArray = (SidebarItem | SidebarGroup | string)[]
 export type SidebarConfigObject = Record<string, SidebarConfigArray>
 export type SidebarConfig = SidebarConfigArray | SidebarConfigObject
 // resolved