Перейти к основному содержанию

Обзор

Badge отображает компактную встроенную информацию, включая короткие метки и количества. Используйте Tag для категорий, Chip для компактных элементов управления или Status для именованного состояния с индикатором.

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

Передавайте текст, числа или узлы в качестве дочерних элементов. Badge отображает предоставленное вами содержимое и не добавляет форматирование количества или правила видимости. Элементом по умолчанию является неинтерактивный span.

С иконкой

Иконки являются обычными дочерними узлами. Задайте для декоративных иконок aria-hidden и оставьте видимую метку, поясняющую содержимое.

Внешний вид

size принимает значения xs, sm или md. color принимает tertiary, inherit, primary, secondary или accent. Вариант accent сочетает заливку accent-tertiary с текстом accent11 в обеих темах. Сплошной вариант primary сохраняет синюю заливку и текст на акцентном фоне. shape принимает значения pill или circle. Значения по умолчанию: sm, tertiary и pill. Круглый вариант имеет фиксированную ширину, равную его высоте. Используйте pill для более длинного содержимого, включая сокращенные количества.

Количество и видимость

Ваше приложение отвечает за форматирование чисел, сокращения, ограничение значений, видимость нуля и переведенные метки. Если компактное количество является декоративным, укажите его полное значение в доступном имени окружающего элемента управления. Автономный Badge может использовать нативные атрибуты доступности, включая aria-label или aria-labelledby.

Нативная композиция

Нативные атрибуты, обработчики событий, className, style и ref применяются к фактическому корневому элементу. render принимает элемент или обратный вызов через композицию Base UI. Выберите подходящий нативный элемент-владелец для интерактивного содержимого:
Отрисованный Button отвечает за поведение навигации и семантику ссылки. Badge сохраняет свое представительное поведение по умолчанию и не определяет интерактивность на основе содержимого.

Свойства

Типы и значения по умолчанию генерируются из публичного типа BadgeProps. Также поддерживаются нативные атрибуты и обработчики событий.
ReactNode
Caller-provided text, numbers, icons, or other inline content.
"accent" | "inherit" | "primary" | "secondary" | "tertiary"
по умолчанию:"tertiary"
Neutral tertiary, inherited text, solid primary accent, soft accent tint, or secondary treatment.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Replaces the default span. Native props, handlers, and the ref target the rendered element.
"circle" | "pill"
по умолчанию:"pill"
Rounded pill label or fixed circle with width equal to its height. Use pill for longer content.
"md" | "sm" | "xs"
по умолчанию:"sm"
Compact height, font size, and spacing: xs, sm, or md.