Badge

徽标:在宿主元素角落展示 count 数字/dot 小圆点/自定义节点;无 children 时可独立使用。支持 type/theme/position/overflowCount。

设计文档

如何引入

import { Badge } from '@chenzy-design/svelte';

基本用法

count 为基本类型;dot 显示小圆点(优先于 count);count 为节点时直接渲染;也可传字符串。

BM 5 YL XZ WF NEW

显示最大值

设置 overflowCount,实际数值超过时以 {overflowCount}+ 格式显示。

ZH 99 HS 100 DY 10+ TT 999+

徽标位置

position 支持 leftTop / leftBottom / rightTop(默认)/ rightBottom。

ZH VIP HS VIP DY VIP TT VIP

徽标样式

theme 支持 solid(默认)/ light / inverted,作用于 count 与 dot。

XZ 5 YB 5 LX 5 YZ HW
XM

徽标类型

type 支持 primary(默认)/ secondary / tertiary / warning / danger / success。

MR 5 YL 5 ZW 5 JL 5 RT 5 YF

独立使用

Badge 作为独立元素时可单独使用,常与文字组合表达状态。

5 NEW 10+ 进行中 processing 信息 info 成功 success 提醒 warning 错误 error

API 参考

Badge

Props

属性说明类型默认值
count徽标内容;数字/字符串按 overflowCount 处理,Snippet 时直接渲染number|string|Snippetundefined
dot显示小圆点,优先于 countbooleanfalse
type'primary'|'secondary'|'tertiary'|'danger'|'warning'|'success''primary'
theme'solid'|'light'|'inverted''solid'
position'leftTop'|'leftBottom'|'rightTop'|'rightBottom''rightTop'
overflowCount超出显示 {n}+numberundefined
countStyle徽标内容区域样式stringundefined
countClass徽标内容区域类名stringundefined
style徽标内容区域内联样式(优先于 countStyle)stringundefined
class根节点类名stringundefined
onClick(e: MouseEvent) => voidundefined
onMouseEnter(e: MouseEvent) => voidundefined
onMouseLeave(e: MouseEvent) => voidundefined
children宿主子元素;省略时独立使用Snippetundefined

Slots

名称说明
children被徽标包裹的宿主元素
count自定义徽标内容(count 为 Snippet 时)

Accessibility

  • Badge 为纯展示元素;不进入 Tab 序,语义由宿主文案承载。

设计变量

变量默认值用法
--cd-color-badge-danger-inverted-text-default var(--cd-color-danger)文字颜色 - 白底
--cd-color-badge-danger-light-bg-default var(--cd-color-danger-light-default)背景颜色 - 浅版危险
--cd-color-badge-danger-light-text-default var(--cd-color-danger)文字颜色 - 浅版危险
--cd-color-badge-danger-solid-bg-default var(--cd-color-danger)背景颜色 - 危险
--cd-color-badge-default-bg-default var(--cd-color-bg-1)背景颜色 - 默认
--cd-color-badge-default-border-default var(--cd-color-bg-1)描边颜色 - 默认
--cd-color-badge-default-light-bg-default var(--cd-color-bg-2)背景颜色 - 浅版
--cd-color-badge-default-text-default var(--cd-color-bg-2)文字颜色 - 默认
--cd-color-badge-primary-inverted-text-default var(--cd-color-primary)文字颜色 - 白底
--cd-color-badge-primary-light-bg-default var(--cd-color-primary-light-default)背景颜色 - 浅版主色