You need to enable JavaScript to run this app. 如何在Storybook中根据模态type参数取值有条件禁用content控件
优惠活动
大模型
产品
解决方案
定价
更多

如何在Storybook中根据模态type参数取值有条件禁用content控件

Storybook实现基于其他参数取值的条件控件禁用

之前试错方案的问题根源

两个尝试的方向从配置逻辑上就走不通:

  1. 把禁用逻辑写在table.disable的回调里:argTypes属于组件的静态配置块,这个块里的回调执行时拿不到运行时的实时参数值,也不存在能引用到当前type参数实时取值的上下文,根本没法做动态判断
  2. 用自定义propType校验器实现联动:Storybook解析参数类型时,只要检测到propType是函数,就会默认把这个参数对应的控件标记为函数类型,和需要的字符串文本输入控件冲突,没法正常展示

官方原生支持的正确实现

直接用Storybook 6.5+内置的if条件配置项,不需要自定义校验、不需要手动获取上下文引用,直接在argTypes里声明参数的展示规则即可:

export default {
  title: 'Global Design System/Modal',
  component: Modal,
  argTypes: {
    type: {
      control: {
        type: 'select',
        options: ['alert', 'confirmation', 'content', 'photo']
      },
      defaultValue: 'alert'
    },
    content: {
      control: {
        type: 'text'
      },
      // 动态判断规则
      if: {
        arg: 'type',
        neq: 'photo'
      }
    }
  },
};

实际生效效果

  • 当type取值为alert/confirmation/content时,content文本输入控件正常展示、可编辑
  • 当type切换为photo时,content控件会直接从侧边控制栏隐藏,从根本上避免用户在不需要该参数的场景下误修改配置,完全满足“photo类型下不允许操作content参数”的诉求

扩展能力

这个if规则支持的判断逻辑非常灵活,除了示例里的neq(不等于),还支持:

  • eq:当目标参数等于指定值时展示当前控件
  • not:对判断结果取反
  • 匹配数组值、检查参数是否存在等复杂规则,能覆盖绝大多数场景的条件控件展示需求

可选场景补充

如果不想让控件完全隐藏,只是想保留控件位置、置灰让用户不可编辑,可以在预览装饰器里读取实时args,动态给对应控件的DOM元素加禁用态。但绝大多数场景下用原生if配置的隐藏逻辑体验更清晰,不需要额外写自定义DOM操作。


内容的提问来源于stack exchange,提问作者Wil S.

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.18 08:36:04