Примеры, рекомендации и сценарии использования — на странице CdsRadioGroup. Для независимой опции «вкл/выкл» возьмите CdsCheckbox.
API
Пропсы
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
activeColor | string | undefined | — | Цвет компонента, когда он находится в активном состоянии |
baseColor | string | undefined | — | Цвет неактивного компонента |
bgColor | string | undefined | — | Цвет фона компонента |
color | string | undefined | — | Цвет компонента |
defaultsTarget | string | undefined | — | Имя дочернего компонента, которому пробрасываются значения пропсов группы по умолчанию |
description | string | undefined | — | Описание компонента, отображаемое под меткой |
direction | "horizontal" | "vertical" | undefined | 'horizontal' | Переключение между горизонтальным или вертикальным отображением. |
disabled | boolean | null | undefined | null | Заблокированное состояние |
error | boolean | undefined | — | Переводит компонент в визуальное состояние ошибки |
falseIcon | IconValue | undefined | 'radio-off' | Иконка невыбранного состояния |
falseValue | any | — | Значение для false состояния. |
id | string | undefined | — | Уникальный идентификатор компонента |
inline | boolean | undefined | — | Отображает контрол как inline-элемент — контейнер не растягивается на всю ширину |
label | string | undefined | — | Текст метки (label) компонента |
modelValue | any | — | Значение компонента (v-model). В группе — значение выбранного контрола, при multiple — массив выбранных значений |
multiple | boolean | null | undefined | null | Разрешает выбор нескольких значений — модель становится массивом. Включается автоматически, если в modelValue передан массив |
name | string | undefined | — | Атрибут name нативного элемента input. В группе одно имя объединяет все вложенные контролы |
readonly | boolean | null | undefined | null | Только для чтения |
textColor | string | undefined | — | Цвет текста компонента |
theme | string | undefined | — | Тема компонента |
trueIcon | IconValue | undefined | 'radio-on' | Иконка выбранного состояния |
trueValue | any | — | Значение для true состояния. |
type | string | undefined | — | Тип нативного элемента input — например, radio или checkbox |
value | any | — | Значение, используемое при выборе компонента в группе. Если оно не указано, будет использоваться уникальный идентификатор. |
valueComparator | ValueComparator | undefined | true | Функция сравнения значения модели со значением value контрола. По умолчанию — глубокое сравнение |
Слоты
| Имя | Тип | Описание |
|---|---|---|
default | { backgroundColorClasses: Ref<string[], string[]>; backgroundColorStyles: Ref<CSSProperties, CSSProperties>; } | Слот по-умолчанию |
description | { description: string | undefined; props: Record<string, any>; } | Слот по умолчанию для компонента CdsDescription |
input | SelectionControlSlot | Слот для элемента ввода по умолчанию. |
label | { label: string | undefined; props: Record<string, any>; } | Слот по умолчанию для компонента CdsLabel |