自定义变体

HeroUI 允许您通过扩展和自定义组件的样式来为组件创建新的变体。您可以覆盖组件的 variantsdefaultVariantscompoundVariants

注意:对于一次性自定义,请参考 覆盖样式 文档。

为非插槽组件创建新变体

让我们以 Button 组件为例。它是一个非插槽组件,您可以在 这里 查看其源样式。

注意:如果您不熟悉变体概念,请参考 Tailwind Variants 文档。

扩展原始组件变体

使用 extendVariants 函数创建一个新组件,该组件具有基于现有组件的自定义变体。

在您的应用程序中使用自定义组件

然后,您现在可以在您的应用程序中使用自定义组件。这里,MyButton 组件的颜色设置为 olive,尺寸设置为 xl

新组件将包含 Button 组件的原始 props,以及您创建的新变体。

为插槽组件创建新变体

extendVariants 函数也可以与基于插槽的组件(如 Input)一起使用,以添加或覆盖变体。您可以在 这里 查看 Input 组件的源样式。

注意:如果您不熟悉变体/插槽概念,请参考 Tailwind Variants 文档。

扩展原始组件变体

使用 extendVariants 函数创建一个新组件,该组件具有基于原始组件的自定义变体。

在您的应用程序中使用自定义组件

然后,您现在可以在您的应用程序中使用自定义组件。这里,MyInput 组件的颜色设置为 slate,尺寸设置为 xl

新组件将包含 Input 组件的原始 props,以及您创建的新变体。

使用每个组件页面顶部的 样式来源 链接查看其源代码,作为自定义的参考。

类型

主要函数

选项

配置

注意:请参阅 Tailwind Merge Config 以了解更多信息。