Agent Skills
返回列表
小四的条件类名

小四的条件类名

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/qur20261996。

技能介绍

问题背景

列表行和按钮这类组件里,条件类名几乎无处不在:逾期行要高亮、选中行要有标记、按钮在 loading 或 disabled 时呈现不同样式。直接在模板里写 :class="row.overdue ? 'is-overdue' : ''",再叠加选中、高亮几个条件,三元表达式很快膨胀到难以阅读。更麻烦的是,同样的业务状态散落在几十处模板里,改一次状态样式就要全项目搜索替换;字符串相加 a + (b ? ' x' : '') 散落各处且不统一,是这类代码最常见的失控方式。

技能如何工作

核心做法是把长三元表达式收拢成命名清晰的辅助函数,比如 customerRowClass、actionBtnClass:统一接收状态参数,返回一个类名结果。

  • 用 clsx 拼接条件类名:falsy 值(false、null、undefined、0、空字符串)不会输出任何类名
  • 对象写法 { 'is-active': on }:键为类名、值为条件,一目了然
  • Vue 直接调用::class="customerRowClass({ tone, className: $attrs.class })",把组件外部传入的类名一并合并
  • 轻量替代:只有字符串拼接的简单场景可换 clsx/lite,体积更小

自测时重点验证两件事:所有条件都为 false 时只剩基础类;字符串与对象混用时顺序符合预期。

适用边界与注意点

  • clsx 会忽略 falsy 值,但不要把会渲染成 "0" 的意外值传进去
  • 类名字符串要保持可扫读,不要一次拼接几十个无语义工具类而不分组
  • 它只解决条件类名拼接,不要在本技能内引入完整的 CSS-in-JS 框架
  • 用 Tailwind 且需要处理类名冲突合并时,可以再叠 tailwind-merge,这不是本技能的强制要求
  • 实现要点注释中会标注「小四原创」,便于识别来源

使用场景

  • 维护数据列表,需要按逾期、高亮、选中等状态给行加不同样式
  • 开发按钮组件,要同时处理 loading、disabled、size 多种状态的类名
  • 模板里的 :class 三元表达式越写越长,读起来分不清每个条件
  • 使用 Tailwind 时需要合并冲突类名,想搭配 tailwind-merge 使用

适合人员

  • Vue 前端工程师,想在模板里用统一函数管理条件类名,替代散落的三元表达式
  • React 开发者,需要在 className 中按条件拼接多个状态类,同时保持可读性
  • 组件库作者,要为按钮、列表行封装可复用的状态类名拼接逻辑
  • 用 Tailwind 写业务组件的工程师,想在合并类名时保持条件逻辑清晰