feat(content-docs): add custom props front matter

packages/docusaurus-plugin-content-docs/src/__tests__/docFrontMatter.test.ts

@@ -210,6 +210,19 @@ describe('validateDocFrontMatter sidebar_position', () => {
   });
 });
 
+describe('validateDocFrontMatter sidebar_custom_props', () => {
+  testField({
+    prefix: 'sidebar_custom_props',
+    validFrontMatters: [
+      {sidebar_custom_props: {}},
+      {sidebar_custom_props: {prop: 'custom', number: 1, boolean: true}},
+    ],
+    invalidFrontMatters: [
+      [{sidebar_custom_props: ''}, 'must be of type object'],
+    ],
+  });
+});
+
 describe('validateDocFrontMatter custom_edit_url', () => {
   testField({
     prefix: 'custom_edit_url',

packages/docusaurus-plugin-content-docs/src/docFrontMatter.ts

@@ -30,6 +30,7 @@ const DocFrontMatterSchema = Joi.object<DocFrontMatter>({
   sidebar_label: Joi.string(),
   sidebar_position: Joi.number(),
   sidebar_class_name: Joi.string(),
+  sidebar_custom_props: Joi.object().unknown(),
   displayed_sidebar: Joi.string().allow(null),
   tags: FrontMatterTagsSchema,
   pagination_label: Joi.string(),

packages/docusaurus-plugin-content-docs/src/props.ts

@@ -52,7 +52,8 @@ Available document ids are:
       label: sidebarLabel || item.label || title,
       href: permalink,
       className: item.className,
-      customProps: item.customProps,
+      customProps:
+        item.customProps ?? docMetadata.frontMatter.sidebar_custom_props,
       docId: docMetadata.unversionedId,
     };
   };

packages/docusaurus-plugin-content-docs/src/types.ts

@@ -58,6 +58,7 @@ export type DocFrontMatter = {
   sidebar_label?: string;
   sidebar_position?: number;
   sidebar_class_name?: string;
+  sidebar_custom_props?: Record<string, unknown>;
   displayed_sidebar?: string | null;
   pagination_label?: string;
   custom_edit_url?: string | null;

website/_dogfooding/_docs tests/tests/custom-props/_category_.json

@@ -0,0 +1,3 @@
+{
+  "label": "Custom Props"
+}

website/_dogfooding/_docs tests/tests/custom-props/doc-with-custom-props.md

@@ -0,0 +1,10 @@
+---
+sidebar_custom_props:
+  prop: custom
+  number: 1
+  boolean: true
+---
+
+# Doc with Custom Props
+
+This doc has custom props.

website/_dogfooding/_docs tests/tests/custom-props/doc-without-custom-props.md

@@ -0,0 +1,3 @@
+# Doc Without Custom Props
+
+This doc doesn't have custom props.

website/_dogfooding/_docs tests/tests/custom-props/index.md

@@ -0,0 +1,22 @@
+# Custom Props
+
+```mdx-code-block
+import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
+
+export const DocPropsList = ({items}) => (
+  <table>
+    <tr>
+      <th>Doc Page</th>
+      <th>Custom Props</th>
+    </tr>
+    {items.map((item, index) => (
+      <tr>
+        <td>{item.label}</td>
+        <td>{JSON.stringify(item.customProps)}</td>
+      </tr>
+    ))}
+  </table>
+);
+
+<DocPropsList items={useCurrentSidebarCategory().items}/>
+```