mirror of
https://github.com/facebook/docusaurus.git
synced 2025-05-03 20:27:20 +02:00
* feat(sidebar): support external links and linking to docs from other sidebars * Update styles.css
64 lines
1.5 KiB
JavaScript
64 lines
1.5 KiB
JavaScript
import React from 'react';
|
|
|
|
import SidebarLink from './SidebarLink';
|
|
import SidebarCategory from './SidebarCategory';
|
|
import styles from './styles.css';
|
|
|
|
function Sidebar(props) {
|
|
const {metadata, docsSidebars, docsMetadatas} = props;
|
|
const {sidebar, language} = metadata;
|
|
|
|
if (!sidebar) {
|
|
return null;
|
|
}
|
|
|
|
const thisSidebar = docsSidebars[sidebar];
|
|
|
|
if (!thisSidebar) {
|
|
throw new Error(`Can not find ${sidebar} config`);
|
|
}
|
|
|
|
const convertDocLink = item => {
|
|
const linkID = (language ? `${language}-` : '') + item.id;
|
|
const linkMetadata = docsMetadatas[linkID];
|
|
|
|
if (!linkMetadata) {
|
|
throw new Error(
|
|
`Improper sidebars.json file, document with id '${linkID}' not found.`,
|
|
);
|
|
}
|
|
|
|
return {
|
|
type: 'link',
|
|
label: linkMetadata.sidebar_label || linkMetadata.title,
|
|
href: linkMetadata.permalink,
|
|
};
|
|
};
|
|
|
|
const renderItem = (item, {root} = {}) => {
|
|
switch (item.type) {
|
|
case 'category':
|
|
return (
|
|
<SidebarCategory
|
|
{...item}
|
|
key={item.label}
|
|
subCategory={!root}
|
|
renderItem={renderItem}
|
|
/>
|
|
);
|
|
case 'link':
|
|
return <SidebarLink {...item} key={item.href} />;
|
|
case 'ref':
|
|
default:
|
|
return renderItem(convertDocLink(item));
|
|
}
|
|
};
|
|
|
|
return (
|
|
<div className={styles.sidebar}>
|
|
{thisSidebar.map(item => renderItem(item, {root: true}))}
|
|
</div>
|
|
);
|
|
}
|
|
|
|
export default Sidebar;
|