@ gentleduck/ 变量
具有 " cva () " 的型号安全组件变体.
麻省理工学院 - 说吧 更改日志 - 说吧 捐款 - 说吧 文档
类型安全组件变体 cva()。 。 。 .
定义有完整TypeScript推断,复合变体,和默认值的变体驱动类名. 零从属.
快开始
npm install @gentleduck/variants
import { cva, type VariantProps } from '@gentleduck/variants'
const button = cva('px-4 py-2 rounded font-medium', {
variants: {
intent: {
primary: 'bg-blue-600 text-white',
secondary: 'bg-gray-100 text-gray-800',
},
size: {
sm: 'text-sm px-3 py-1',
md: 'text-base px-4 py-2',
lg: 'text-lg px-6 py-3',
},
},
defaultVariants: {
intent: 'primary',
size: 'md',
},
compoundVariants: [
{ intent: 'primary', size: 'lg', className: 'uppercase tracking-wide' },
],
})
button() // default: primary + md
button({ intent: 'secondary' }) // secondary + md
button({ size: 'lg' }) // primary + lg + compound applied
type ButtonVariants = VariantProps<typeof button>
特征
- 化合物变体 -- 当多个变量值匹配时应用分类
- 默认变体 -- 无道具传递时的倒置值
- 类型推论 - 说吧
VariantProps<typeof fn>提取组件接口的变体道具 - 可编曲 - 通过一个
cva()由另一个基数产生cva()调用 - 阵列和对象 -- 支持嵌入类阵列和有条件的对象
- 零依赖关系 - 没有运行时间道克,
"sideEffects": false
基准
这个包装一个基准脚本来比较 @gentleduck/variants 反对 class-variance-authority, (中文(简体) ), tailwind-variants,以及 clsx 横跨三轴:
- 套装大小 (叹气):
shipped(原始文件 npm 服务),fullApi(散会)export *精炼而成的,realImport(用副作用槽捆绑主要导出,精细化——应用实际支付多少). - 运行时间 (ns/op):四种情况(默认,一个变体,变体+大小,有类名合并),各在
warm模式(重复使用相同的道具——有利于纪念库)和cold模式(每个调用的独特类Name – 击败记忆)。 报告中位数,p95,p99,stdev,以及相对误差幅度. - 特征:自我报告的能力矩阵.
运行
# from this package
bun run benchmark
# from the monorepo root
bun run benchmark:variants
输出写入 public/benchmarks/results.json 并镜像到 apps/duck-ui-docs/public/data/benchmarks/variants.json。每个 JSON 包括主机环境(CPU、节点、包子、平台、git 承诺)、墙上小时和a reproCommand 绳取出处.
如何读取数字
纪念是图书馆的一流特色,所以 warm 模式反映了它的最佳情况。 这个 cold 报告模式的同时,还诚实地显示非计量成本——这比起没有记忆的图书馆来说是一个更公平的数字. Bundle大小是静态的;运行时数取决于机器,应该相对于同一运行中的其他库来解释,而不是绝对常数.