You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何配置Storybook隐藏Docs页面中重复显示的首个故事?

解决Storybook Docs页面移除首个故事预览区域的方法

你可以通过以下几种方式配置,只保留集合标题和描述,移除那个带控件的首个故事副本:

方式一:全局生效(所有组件集合)

在.storybook/preview.js文件中添加配置,全局禁用所有Docs页面的预览区域:

export const parameters = {
  docs: {
    preview: {
      disable: true,
    },
  },
};

方式二:单个组件集合生效

如果只需要针对某个组件的故事集合修改,在该组件的故事文件(比如Button.stories.js)的默认导出中添加参数:

export default {
  title: 'Components/Button',
  description: '按钮组件用于触发操作,支持多种尺寸和状态',
  parameters: {
    docs: {
      preview: {
        disable: true,
      },
    },
  },
};

备选方案:自定义Docs页面布局

如果上述参数配置不生效,可以自定义Docs页面组件,手动保留标题和描述,剔除预览区域:

  1. 创建自定义Docs页面组件(比如.storybook/CustomDocsPage.jsx):
import { DocsPage, Title, Description } from '@storybook/addon-docs';

export const CustomDocsPage = ({ children, context }) => {
  return (
    <DocsPage context={context}>
      <Title />
      <Description />
      {/* 仅保留标题和描述,跳过默认的预览模块 */}
      {children}
    </DocsPage>
  );
};
  1. 在.storybook/preview.js中配置使用自定义页面:
import { CustomDocsPage } from './CustomDocsPage';

export const parameters = {
  docs: {
    page: CustomDocsPage,
  },
};

这样就能精准保留你需要的标题和描述,移除无意义的首个故事预览副本了。

内容的提问来源于stack exchange,提问作者geoffrey

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.17 03:00:57