Skip to Content
JoyUI

关闭按钮

圆形 ✕,四种可配置尺寸,用于公告、吐司、模态与抽屉。

圆形 ✕,用于关闭紧凑表面、公告、吐司、模态框和抽屉。每个尺寸用自己的笔画画字形——2xs 为 1.6px,xs / sm 为 2px,md 为 2.5px——权重保持像素真实,而不是缩放同一图标。

通过 size 切换款式;下面预览是同一个 CloseButton 的四种配置。

安装

npx @joyui/cli add close-button --yes

或通过 JoyUI MCP / CLI 安装。

尺寸

四种尺寸由 size 控制:16、20、24、32 像素。控件没有可见文字,请始终传入 aria-label。

2xs
xs
SM
MD
<CloseButton size="2xs" aria-label="Close" /> {/* 16px, 1.6px stroke */}
<CloseButton size="xs" aria-label="Close" />  {/* 20px, 2px stroke */}
<CloseButton size="sm" aria-label="Close" />  {/* 24px, 2px stroke */}
<CloseButton size="md" aria-label="Close" />  {/* 32px, 2.5px stroke */}

在模态标题中

模态标题

<header className="flex items-center justify-between p-4">
  <p className="text-body-medium text-text-primary">模态标题</p>
  <CloseButton size="md" aria-label="关闭模态框" onClick={onClose} />
</header>

API

CloseButton
参数说明类型可选值默认值
size点击区域与笔画权重。每种尺寸单独绘制 ✕,避免缩放导致线宽失真。"2xs" | "xs" | "sm" | "md"2xs · xs · sm · mdxs
aria-label无障碍名称(必填)。控件没有可见文字。string——
className合并到根按钮上的额外类名。string——
onClick点击回调;其余原生 button 属性均可传入。MouseEventHandler——