自定义变体

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

注意:对于一次性自定义,请参阅 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 配置 了解更多信息。