﻿---
description: Индикатор для обозначения уведомления или другой важной информации, относящейся к пункту навигации.
tags: status
---

# Badge \[tag:component]

Индикатор для обозначения уведомления или другой важной информации,
относящейся к пункту навигации.

```jsx
<Badge>Есть новые уведомления</Badge>
```

## Использование

* Старайтесь снабжать компонент *кратким* текстом или числом.
* Размещайте компонент в непосредственной близости от целевого элемента.
* Для важных уведомлений дублируйте информацию в полноценной системе уведомлений.

```jsx
<Tabs selectedId="messages" layoutFillMode="shrinked">
  <TabsItem id="dialogs" after={<Badge mode="prominent">Требуется подтверждение</Badge>}>
    Настройки
  </TabsItem>
  <TabsItem id="messages" after={<Badge>Есть новые</Badge>}>
    Уведомления
  </TabsItem>
</Tabs>
```

## Доступность (a11y) \[#a11y]

* Всегда передавайте смысловое содержимое в `children`.
* Избегайте декоративного использования без текста.

```jsx
// ❌ Плохо: пустой значок
<Badge mode="prominent" />

// ✅ Хорошо: понятный контент
<Badge mode="prominent">Новые сообщения</Badge>
```

## Свойства и методы \[#api]

| Свойство     | Тип                                                                                                     | По умолчанию | Описание                                                                                                                                                                                                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Component`  | `ElementType<any, keyof IntrinsicElements>`                                                             | `-`          |                                                                                                                                                                                                                                                                                        |
| `getRootRef` | `Ref<HTMLSpanElement>`                                                                                  | `-`          |                                                                                                                                                                                                                                                                                        |
| `mode`       | `"new" \| "prominent"`                                                                                  | `new`        | Режим отображения компонента.                                                                                                                                                                                                                                                          |
| `ref`        | `Ref<HTMLSpanElement>`                                                                                  | `-`          |                                                                                                                                                                                                                                                                                        |
| `render`     | `((props: AllHTMLAttributes<HTMLSpanElement> & Omit<HasRootRef<HTMLSpanElement>, "ref">) => ReactNode)` | `-`          | Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные `className` и `style`). Используется вместо `Component`.  Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер. |
