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

RadioButton

Отображает переключатель для выбора варианта из ограниченного набора

Имеет следующие режимы работы:

  • Multiple: отображает список вариантов, определенных в свойстве State, с возможностью выбора с помощью переключателя;
  • Single: отображает только один вариант.
  <RadioButton
Mode="Single"
Value={3}
Checked={fooSingle => fooSingle === 3}
OutputValue-var="fooSingle"
Label="RadioButton"
/>

Свойства

ИмяОписаниеТипЗначение по умолчаниюВозможные значения
AutofocusПризнак установки фокуса на компонентbooleanFalse
BadgeКоличественная информация в компонентах Menu, Accordion, Link, Text. В качестве значения может использоваться объект с полями: counter (число),
position ("post" или "pre"), color (цвет)
any
CSSМассив строк-классов CSS-стилей компонентаarray
CheckedПризнак выбранного вариантаbooleanFalse
CombineConfigКонфигурация всех событий компонента. Служебное свойство для генерации фрагментов кода в визуальном режиме редактора форм.
Не рекомендуется указывать значение вручную
object
DataHintПодсказка к компонентуstring
DisabledПризнак запрета на редактирование компонентаbooleanFalse
ErrorТескт ошибки при валидации компонента или undefined/false, если при валидации не обнаружены ошибкиbooleanFalse
ErrorMessageСообщение об ошибке при валидации компонента. Устаревшее свойство, используется только для совместимости с версиями Платформы до 3.0. Вместо ErrorMessage рекомендуется использовать свойство Errorstring
FocusedПризнак фокусировки на компонентеbooleanFalse
HiddenПризнак состояния компонента СкрытbooleanFalse
HighlightErrorПризнак подсвечивания ошибкиbooleanTrue
HintПодсказка над компонентомstring
HintPositionСторона — правая или левая — для отображения подсказкиenumrightleft - Слева
right - Справа
top - Сверху
bottom - Снизу
topRight - Сверху справа
topLeft - Сверху слева
bottomRight - Снизу справа
bottomLeft - Снизу слева
IdИдентификатор компонента для навигации к нему на HTML-страницеstring
KeyFieldКлюч для отрисовки компонентаstring
LabelНадпись на компонентеstring
MaxLengthМаксимальная длина вводимой строкиnumber30
ModeРежим работы компонентаenumMultipleMultiple - Набор значений из свойства State
Single - Одно значение; использует свойства Name, Value и OutputValue
ModelПсевдоним свойств Value и OutputValueany
NameИмя вариантаstringname
NoWriteOnInitПризнак отказа от записи данных в переменную, заданную в свойствах OutputValue или Model, при создании компонентаbooleanFalse
OnBlurПараметры команды, отправляемой при потере фокуса компонентомundefined
OnChangeПараметры команды, отправляемой при изменении компонента, например, при вводе текста, выборе из спискаundefined
OnClickОбработчик события нажатия кнопки мышиundefined
OnDelayПараметры команды, отправляемой по истечении секунды (для предотвращения ложного срабатывания обработчика события) после последнего изменения модели данныхundefined
OnEnterKeyDownПараметры команды, отправляемой по нажатию Enterundefined
OnKeyDownОбработчик события KeyDownundefined
OnKeyUpОбработчик события KeyUpundefined
OnMouseDownОбработчик события MouseDownundefined
OnMouseEnterОбработчик события MouseEnterundefined
OnMouseLeaveОбработчик события MouseLeaveundefined
OnMouseMoveОбработчик события MouseMoveundefined
OnMouseOutОбработчик события MouseOutundefined
OnMouseOverОбработчик события MouseOverundefined
OnMouseUpОбработчик события MouseUpundefined
OnUnmountОбработчик события Unmountundefined
OutputStateИмя переменной для записи информации, относящейся к состоянию компонента, но не относящейся к даннымany
OutputValueПривязка отрисованного компонента к моделиany
ReadOnlyПризнак запрета на редактирование компонента c возможностью копирования содержимогоbooleanFalse
RequiredПризнак обязательности заполнения. Не влияет на валидацию, отображает звездочку справа от надписиbooleanFalse
SlotМетка для динамического добавления другого компонента по его идентификаторуstring
StateМассив объектов допустимых значенийarray
TextЗаполнитель (Placeholder)string
TitleFieldКлюч для подсказки к компонентуstring
TooltipВсплывающая подсказка над компонентом, чаще используемая для пояснения назначения значкаany
TraceId
Идентификатор для отслеживания состояния компонента исходя из хронологической последовательности:
создание, отрисовка, обновление, удаление; используется для выполнения фрагмента кода по изменению состояния компонента
string
ValidationПризнак ошибки валидации компонента. Устаревшее свойство, используется только для совместимости с версиями Платформы до 3.0. Вместо Validation рекомендуется использовать свойство ErrorbooleanFalse
ValueПривязка модели к отрисованному компонентуany
ValueFieldКлюч для записи в модельstring
VisibleПризнак инверсии состояния компонента СкрытbooleanTrue
WriteModeИмя события, по которому меняется значение переменной состояния (экранной формы), переданной в качестве OutputValueenum- Режим ввода без контроля состояния компонента

Примеры

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>