RadioButton
Отображает переключатель для выбора варианта из ограниченного набора
Имеет следующие режимы работы:
- Multiple: отображает список вариантов, определенных в свойстве State, с возможностью выбора с помощью переключателя;
- Single: отображает только один вариант.
<RadioButton
Mode="Single"
Value={3}
Checked={fooSingle => fooSingle === 3}
OutputValue-var="fooSingle"
Label="RadioButton"
/>
Свойства
| Имя | Описание | Тип | Значение по умолчанию | Возможные значения |
|---|---|---|---|---|
| Autofocus | Признак установки фокуса на компонент | boolean | False | |
| Badge | Количественная информация в компонентах Menu, Accordion, Link, Text. В качестве значения может использоваться объект с полями: counter (число), position ("post" или "pre"), color (цвет) | any | ||
| CSS | Массив строк-классов CSS-стилей компонента | array | ||
| Checked | Признак выбранного варианта | boolean | False | |
| CombineConfig | Конфигурация всех событий компонента. Служебное свойство для генерации фрагментов кода в визуальном режиме редактора форм. Не рекомендуется указывать значение вручную | object | ||
| DataHint | Подсказка к компоненту | string | ||
| Disabled | Признак запрета на редактирование компонента | boolean | False | |
| Error | Тескт ошибки при валидации компонента или undefined/false, если при валидации не обнаружены ошибки | boolean | False | |
| ErrorMessage | Сообщение об ошибке при валидации компонента. Устаревшее свойство, используется только для совместимости с версиями Платформы до 3.0. Вместо ErrorMessage рекомендуется использовать свойство Error | string | ||
| Focused | Признак фокусировки на компоненте | boolean | False | |
| Hidden | Признак состояния компонента Скрыт | boolean | False | |
| HighlightError | Признак подсвечивания ошибки | boolean | True | |
| Hint | Подсказка над компонентом | string | ||
| HintPosition | Сторона — правая или левая — для отображения подсказки | enum | right | left - Слеваright - Справаtop - Сверхуbottom - СнизуtopRight - Сверху справаtopLeft - Сверху слеваbottomRight - Снизу справаbottomLeft - Снизу слева |
| Id | Идентификатор компонента для навигации к нему на HTML-странице | string | ||
| KeyField | Ключ для отрисовки компонента | string | ||
| Label | Надпись на компоненте | string | ||
| MaxLength | Максимальная длина вводимой строки | number | 30 | |
| Mode | Режим работы компонента | enum | Multiple | Multiple - Набор значений из свойства StateSingle - Одно значение; использует свойства Name, Value и OutputValue |
| Model | Псевдоним свойств Value и OutputValue | any | ||
| Name | Имя варианта | string | name | |
| NoWriteOnInit | Признак отказа от записи данных в переменную, заданную в свойствах OutputValue или Model, при создании компонента | boolean | False | |
| OnBlur | Парам етры команды, отправляемой при потере фокуса компонентом | undefined | ||
| OnChange | Параметры команды, отправляемой при изменении компонента, например, при вводе текста, выборе из списка | undefined | ||
| OnClick | Обработчик события нажатия кнопки мыши | undefined | ||
| OnDelay | Параметры команды, отправляемой по истечении секунды (для предотвращения ложного срабатывания обработчика события) после последнего изменения модели данных | undefined | ||
| OnEnterKeyDown | Параметры команды, отправляемой по нажатию Enter | undefined | ||
| OnKeyDown | Обработчик события KeyDown | undefined | ||
| OnKeyUp | Обработчик события KeyUp | undefined | ||
| OnMouseDown | Обработчик события MouseDown | undefined | ||
| OnMouseEnter | Обработчик события MouseEnter | undefined | ||
| OnMouseLeave | Обработчик события MouseLeave | undefined | ||
| OnMouseMove | Обработчик события MouseMove | undefined | ||
| OnMouseOut | Обработчик события MouseOut | undefined | ||
| OnMouseOver | Обработчик события MouseOver | undefined | ||
| OnMouseUp | Об работчик события MouseUp | undefined | ||
| OnUnmount | Обработчик события Unmount | undefined | ||
| OutputState | Имя переменной для записи информации, относящейся к состоянию компонента, но не относящейся к данным | any | ||
| OutputValue | Привязка отрисованного компонента к модели | any | ||
| ReadOnly | Признак запрета на редактирование компонента c возможностью копирования содержимого | boolean | False | |
| Required | Признак обязательности заполнения. Не влияет на валидацию, отображает звездочку справа от надписи | boolean | False | |
| Slot | Метка для динамического добавления другого компонента по его идентификатору | string | ||
| State | Массив объектов допустимых значений | array | ||
| Text | Заполнитель (Placeholder) | string | ||
| TitleField | Ключ для подсказки к компоненту | string | ||
| Tooltip | Всплывающая подсказка над компонентом, чаще используемая для пояснения назначения значка | any | ||
| TraceId | Идентификатор для отслеживания состояния компонента исходя из хронологической последовательности: создание, отрисовка, обновление, удаление; используется для выполнения фрагмента кода по изменению состояния компонента | string | ||
| Validation | Признак ошибки валидации компонента. Устаревшее свойство, используется только для совместимости с версиями Платформы до 3.0. Вместо Validation рекомендуется использовать свойство Error | boolean | False | |
| Value | Привязка модели к отрисованному компоненту | any | ||
| ValueField | Ключ для записи в модель | string | ||
| Visible | Признак инверсии состояния компонента Скрыт | boolean | True | |
| WriteMode | Имя события, по которому меняется значение переменной состояния (экранной формы), переданной в качестве OutputValue | enum | - Режим ввода без контроля состояния компонента |
Примеры
JSX:
<Group Mode={"Column"}>
<Group Mode="Row" Height="auto" CSS={['mb-24']}>
<Group Mode="Column">
<Text Mode="Medium_20" Value="Без текста" CSS={['mb-24']} />
<Text Mode="Regular_14_2" Value="Использутся в таблице" />
</Group>
<Group Mode="Column" CSS={['mt-24']}>
<Text Mode="Medium_18" Value="" CSS={['mb-24']} />
<RadioButton
Name="textLess"
Mode="Single"
Value={1}
Checked={fooSingle1 => fooSingle1 === 1}
OutputValue-var="fooSingle1"
Label=""
CSS={['mb-8']}
/>
</Group>
<Group Mode="Column" CSS={['mt-24']}>
<Text Mode="Medium_18" Value="" CSS={['mb-24']} />
<RadioButton
Name="textLess"
Mode="Single"
Value={2}
Checked={fooSingle1 => fooSingle1 === 2}
OutputValue-var="fooSingle1"
Label=""
Error={() => 'Описание ошибки'}
CSS={['mb-8']}
/>
</Group>
</Group>
<Group Mode="Row">
<Group Mode="Column">
<Text Mode="Medium_20" Value="С текстом" CSS={['mb-24']} />
<Text Mode="Regular_14_2" Value="Использутся везде кроме таблицы" />
</Group>
<Group Mode="Column" CSS={['mt-24']}>
<Text Mode="Medium_18" Value="" CSS={['mb-24']} />
<RadioButton
Name="withText"
Mode="Single"
Value={3}
Checked={fooSingle2 => fooSingle2 === 3}
OutputValue-var="fooSingle2"
Label="Название опции"
CSS={['mb-8']}
/>
</Group>
<Group Mode="Column" CSS={['mt-24']}>
<Text Mode="Medium_18" Value="" CSS={['mb-24']} />
<RadioButton
Name="withText"
Mode="Single"
Value={4}
Checked={fooSingle2 => fooSingle2 === 4}
OutputValue-var="fooSingle2"
Label="Название опции"
Error={() => 'Описание ошибки'}
CSS={['mb-8']}
/>
</Group>
</Group>
</Group>