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

升级至Storybook 9后背景配置失效,发生了哪些变更?

Storybook 9 背景配置失效的修复方案

Storybook 9 对背景配置的参数结构做了调整,旧版(如v6)的写法不再兼容,按以下方式修改即可恢复生效:

全局背景配置(preview.tsx)

将原来的values字段替换为options,其余配置逻辑保持一致:

export const parameters = {
  backgrounds: {
    default: "light",
    options: [
      {
        name: "light",
        value: "#ffffff",
      },
      {
        name: "dark",
        value: "#000000",
      },
    ],
  },
};

单个Story的背景配置

单Story的参数写法无需改动,但必须先确保全局配置已更新为上述新结构,否则单独指定的背景不会生效:

export const OnDark: Story = {
  parameters: {
    backgrounds: { default: "dark" },
  },
};

若修改后仍不生效,检查.storybook/main.ts中是否启用了背景插件(Storybook 9通常默认集成,若手动移除过需重新添加):

export default {
  addons: ["@storybook/addon-backgrounds"],
};

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.12 16:34:50