ProComponents, templates & AI tooling
HeroUI
27.7k

CloseButton 关闭按钮

用于关闭对话框、模态框或 dismiss 内容的按钮组件

用法

import { CloseButton } from "@heroui/react";

示例

交互

自定义图标

自定义样式

Tailwind CSS

全局 CSS

可使用 @layer components 指令自定义 CloseButton 组件类。 了解更多

@layer components {
  .close-button {
    @apply bg-red-100 text-red-800 hover:bg-red-200;
  }

  .close-button--custom {
    @apply rounded-full border-2 border-red-300;
  }
}

样式参考

HeroUI 遵循 BEM 方法论,确保组件变体与状态可复用且易于自定义。

CSS 类

CloseButton 组件使用以下 CSS 类(查看源码样式):

基础类

  • .close-button - 基础组件样式

变体类

  • .close-button--default - 默认变体

交互状态

组件同时支持 CSS 伪类与 data 属性:

  • Hover:hover[data-hovered="true"]
  • Active/Pressed:active[data-pressed="true"]
  • Focus:focus-visible[data-focus-visible="true"]
  • Disabled:disabled[aria-disabled="true"]

API 参考

CloseButton

Prop类型默认值描述
variant"default""default"按钮视觉变体
childrenReactNode | function<CloseIcon />显示内容(默认为关闭图标)
onPress() => void-按下时的回调
isDisabledbooleanfalse是否禁用

React Aria Button Props

CloseButton 继承所有 React Aria Button 属性。常用属性包括:

Prop类型描述
aria-labelstring屏幕阅读器的无障碍标签
aria-labelledbystring标注按钮的元素 ID
aria-describedbystring描述按钮的元素 ID

Render Props

使用 render prop 模式时,提供以下值:

Prop类型描述
isHoveredboolean是否悬停
isPressedboolean是否按下
isFocusedboolean是否聚焦
isDisabledboolean是否禁用

相关组件

本页目录