自定义变体
HeroUI 允许你通过扩展和自定义样式来为组件创建新变体。你可以覆盖组件的 variants、defaultVariants 和 compoundVariants。
注意:对于一次性自定义,请参阅 Override Styles 文档。
为非插槽组件创建新变体
让我们以 Button 组件为例。它是一个非插槽组件,你可以在此处查看其源样式。
注意:如果你不熟悉变体概念,请参考 Tailwind Variants 文档。
扩展原始组件变体
使用 extendVariants 函数来创建一个基于现有组件自定义变体的新组件。
在你的应用中使用自定义组件
然后,你现在可以在应用中使用自定义组件。在这里,MyButton 的颜色设置为 olive,大小设置为 xl。
新组件将包含 Button 组件的原始属性,以及你创建的新变体。
为插槽组件创建新变体
extendVariants 函数也可用于基于插槽的组件,例如 Input,以添加或覆盖变体。你可以在此处查看 Input 组件的源样式。
注意:如果你不熟悉 variants/slots 概念,请参阅 Tailwind Variants 文档。
扩展原始组件变体
使用 extendVariants 函数来创建一个基于原始组件自定义变体的新组件。
在你的应用中使用自定义组件
然后,你现在可以在应用中使用自定义组件。在这里,MyInput 的颜色设置为 slate,大小设置为 xl。
新组件将包含 Input 组件的原始属性,以及你创建的新变体。
使用每个组件页面顶部的
Styles source链接查看其源代码,以便参考自定义。
类型
主函数
选项
配置
注意:查看 Tailwind Merge 配置 了解更多信息。

