# status-badge

- 分组：组合组件（Composite）
- 页面：/components/status-badge
- 源码：packages/react/src/components/status-badge.tsx

## 导出

```ts
import { BadgeGroup, StatusBadge, statusBadgeVariants } from "@modra/react";
```

## Props（BadgeGroupProps）

| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `items` | 否 | `React.ReactNode[]` | Badges to show. Alternatively pass them as children. |
| `max` | 否 | `number` | How many badges stay visible before the rest fold into a "+N" popover. Defaults to 2. |
| `wrap` | 否 | `boolean` | Shows every badge and wraps them onto further lines (same gap, no "+N" control; `max` is ignored). Use it in detail views where nothing may be hidden. Defaults to false. |
| `renderOverflow` | 否 | `(count: number) => React.ReactNode` | Replaces the "+N" label. |
| `empty` | 否 | `React.ReactNode` | Rendered when there are no badges (`items` / children empty, or only `null`, `false` and `""` entries). Defaults to the shared `EmptyValue` placeholder (a muted em dash with an accessible label) so empty table cells stay consistent; pass `null` to render nothing. |