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