Tag 设计文档

标签:light/solid/ghost 三态,16 色板 + white,可关闭(closable)、可交互(onClick/keydown)、头像(avatarSrc)、AI 多彩(colorful/gradient)、前后缀图标。受控 visible 不回写,仅通过 onClose 通知。配套 TagGroup(折叠 +N)与 SplitTagGroup(连接式组合),对齐 Semi 同页三组件。

← API 文档

使用建议

标签:light/solid/ghost 三态,16 色板 + white,可关闭(closable)、可交互(onClick/keydown)、头像(avatarSrc)、AI 多彩(colorful/gradient)、前后缀图标。受控 visible 不回写,仅通过 onClose 通知。配套 TagGroup(折叠 +N)与 SplitTagGroup(连接式组合),对齐 Semi 同页三组件。

Accessibility

  • clickable(有 onClick 或 closable)时根 div role=button + tabIndex;Enter 激活 onClick、Delete/Backspace 关闭、Esc 失焦。

设计变量

变量默认值用法
--cd-tag-avatar-bg var(--cd-color-bg-4)头像标签背景色(Semi $color-tag_avatar-bg-default)
--cd-tag-avatar-border var(--cd-color-border)头像标签描边色(Semi $color-tag_avatar-border-default)
--cd-tag-avatar-square-img-bg var(--cd-color-fill-1)方形头像图片背景色(Semi $color-tag_avatar_square_img-bg-default,近似 color-default)
--cd-tag-avatar-text var(--cd-color-text-0)头像标签文字色(Semi $color-tag_avatar-text-default)
--cd-tag-close-icon-active var(--cd-color-text-0)关闭按钮按下颜色(Semi $color-tag_close-icon-active)
--cd-tag-close-icon-default var(--cd-color-text-2)可删除标签删除按钮颜色(Semi $color-tag_close-icon-default)
--cd-tag-close-icon-hover var(--cd-color-text-1)关闭按钮悬浮颜色(Semi $color-tag_close-icon-hover)
--cd-tag-colorful-from #4d6bffcolorful(AI 多彩)蓝→紫渐变起始色
--cd-tag-colorful-to #a64dffcolorful(AI 多彩)蓝→紫渐变结束色
--cd-tag-colorful-via #7b5cffcolorful(AI 多彩)蓝→紫渐变中间色