使い方

複数の選択肢の中からひとつを選択するラジオボタングループを作成します。

ユーザーが画面上でラジオボタンをクリックして選択を切り替えると、「入力アイテムを編集して値が変わった時」が発生します。

ラジオボタンのアイテムとしての値は、選択されている項目に設定されている値になります。

設定するパラメーター

アイテム名を表示しない

アイテム名（ラベル）部分を表示しません。この場合、ラジオボタンのグループのみが表示されます。「必須項目にする」をオンにした場合の必須マークも表示されなくなります。ラベル要素自体が生成されませんので、後からページ内処理でラベルをセットすることもできなくなります。

編集不可にする

編集不可にすると、ラジオボタンの選択が変更できない状態になります。

このパラメーターで編集不可にしても、「入力アイテムを有効化する」で後から編集可能状態にできます。

必須項目にする

必須項目にすると、ラベル部分に必須マークがつき、「入力エラーをチェックする」時に必須チェックが行われるようになります。

「アイテム名」が空だったり「アイテム名を表示しない」がオンの場合は必須マークは表示されなくなりますが、「入力エラーをチェックする」のエラーチェックは行われます。

選択項目

グループ内に表示するラジオボタンの表示名と値を、１項目１行で入力します。

入力ダイアログ左側の「画面に表示する選択項目名」には、ラジオボタンの右側に表示する文字列を入力します。空にすることはできません。

「画面に表示する選択項目名」にカンマ区切りで項目の説明文を設定できます。例えば以下のように入力すると、メインの項目名は「飛車」で、その下に説明文として「縦横自由に動ける駒です。」と表示されます。

飛車, 縦横自由に動ける駒です。

入力ダイアログ右側の「選択項目の内部値」はその選択項目を選択した場合の、アイテムの値を入力します。ページ内処理から式で = item1 のようにこのアイテムの値を参照した場合に得られる値が、この値になります。

初期値

画面を表示した直後の状態で選択される選択項目の値を入力します。

空にした場合、何も選択されていない状態になります。kintone をお使いのユーザーは、この動きは kintone と異なっていますので注意してください。

「選択肢」に含まれない値をセットすることは避けてください。エラーにはなりませんが、想定外の動作を引き起こす原因になります。

並び

項目を横に並べるか、縦に並べるかを選択します。

カスタマイズ対応状況

注意事項

• 「入力アイテムの値をセットする」で値を空にセットしても、選択を解除したりリセットしたりするという意味にはなりません。選択項目の中に値が空の項目がなければ、動作結果は不定になります。

制限事項

• 「画面に表示する選択項目名」「選択項目の内部値」ともに、式を使用することはできません。

• 「入力フォーカスをセットする」でラジオボタンにフォーカスを移すことはできません。

• いずれかのラジオボタンを選択した状態から「すべてのラジオボタンが未選択」という状態に戻すことはできません。