# Label: API

## Пропсы корня

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `size` | `LabelSize` | `'md'` | Нет | Визуальный размер текста метки. Обычно соответствует значениям типографической шкалы дизайн-системы. |
| `htmlFor` | `string` | — | Нет | Связывает метку с полем по его `id`. Включает нативную передачу фокуса и связь для скринридеров. |
| `ref` | `Ref<HTMLSpanElement>` | — | Нет | Ref на нижележащий `<span>` или элемент в слоте. Полезен для измерений, фокуса или работы с DOM. |
| `asChild` | `boolean` | — | Нет | Если true, рендерит текст как дочерний компонент через `Slot`. Полезно для совместимости с нативными элементами или другими компонентами. |
| `fontWeight` | `400 \| 500 \| 600 \| 700 \| 900` | `500` | Нет | Насыщенность шрифта текста. Распространённые значения: 400: обычный; 500: средний; 600: полужирный; 700: жирный; 900: сверхжирный |

Также принимает все атрибуты `<label>`.

## Дочерние части

- Нет. `Label` — единственный экспортируемый примитив.

## Типы

- `LabelProps`

## Модель состояния

- У `Label` нет контролируемого состояния.
- Поведение клика делегируется нативной семантике подписи и связанному элементу управления.