RadioButton

選択肢の中から単一の値を選択して入力できるコンポーネントです。 input[type='radio']の代わりとして使用します。

SmartHR UI

処理中

ドラッグして幅を変更

ドラッグして高さを変更

処理中

使用上の注意

基本的に、選択肢の中から単一の値を選択して入力させる場合は、初期状態で選択肢が一覧しやすいラジオボタンを使用します。

選択肢のラベルテキストが長大になる場合や、選択肢が表示領域内にすべて表示しきれないほど存在する場合では、SelectやSingleComboBoxも検討します。
- ただし選択肢の一覧性が下がり、操作の手間が増えるので、選択肢の数が不定で予測できないなどの理由がない限りはラジオボタンの使用を推奨します。

ラジオボタンのラベルテキストは、同程度の文量や行数になるように調整してください。ラジオボタンは性質上、テキストの文量によって幅が変化します。極端に行数や文量の異なる選択肢が混ざると、ユーザーが視認できる領域の差異が大きくなるため、選択肢を間違える恐れがあります。

選択肢を適切に選択させるために補足説明のテキストやステータスラベルを含む複数の要素を追加したい場合や、ラベルテキストが短く画面内の他の要素と比べて認識しづらいなどの理由で、選択肢を視覚的に強調して表示したい場合はRadioButtonPanelを検討してください。

ラジオボタンは入力後に、送信や保存といったtype属性がsubmitのボタンなどを押すことで入力内容が反映される場合に使用してください。ラジオボタンは1クリックで選択肢ごとに異なる結果となるため、誤入力によって意図しない結果が反映されてしまう可能性あります。

コレクションなどでオブジェクトの表示方法を切り替える場合や、表示領域上submitのボタンの配置が難しい場合など、即時反映を前提とする箇所ではTabBarやSegmentedControl、またはSwitchを使用してください。

ラジオボタン内には、ヘルプページへのリンクやInputなど、ユーザーが値を選択する以外の操作可能な要素は配置しないでください。これらを配置してしまうと、ユーザーがフォーム入力するための操作難易度が上がり、誤操作などにつながるためです。（※1）

リンクを置きたい場合は、FieldsetのhelpMessage propsなどを使用します。
ComboBoxなどで選択肢に応じて段階的に別の操作をさせたい場合は、RadioButtonとdisabled状態を組み合わせるか、ステップを複数に分けたモードを検討します。

ユーザーは選択する操作に集中でき、それ以外の操作と区別しやすい

Don't

ユーザーが選択操作に集中できず、操作難易度が上がる