ユーザーが一度に 1 つだけ選択できる複数のオプションを表示する入力コントロール。
Description
標準的な HTML 入力コントロールである 無線 コントロールは、相互に排他的なオプションのほんの一部でのみ使用するのが最適です。
コントロールには、水平方向または垂直方向のレイアウトを使用できます。
重要なプロパティ
既定値 – ユーザーがコントロールを変更する前のコントロールの値。
アイテム – ギャラリー、リスト、グラフなどのコントロールに表示されるデータのソース。
レイアウト – オプションを垂直方向または水平方向にレイアウトするかどうか。
値 – 入力コントロールの値。
選択済み – 選択した項目を表すデータ レコード。
すべてのプロパティ
[配置] – コントロールの水平方向の中心を基準にしたテキストの位置。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
色 – コントロール内のテキストの色。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色。
DisabledColor – DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色。
DisabledFill – DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色。
塗りつぶし – コントロールの背景色。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
フォント – テキストが表示されるフォントファミリの名前。
FontWeight – コントロール内のテキストの重み: 太字、 半ボルト、 標準、 または太さ。
Height – コントロールの上端と下端の間の距離。
HoverColor – ユーザーがマウス ポインターを置いたままにしたときのコントロール内のテキストの色。
HoverFill – ユーザーがマウス ポインターをその上に置いたままにしたときのコントロールの背景色。
斜体 – コントロール内のテキストが斜体かどうかを指定します。
LineHeight – リスト内のテキストまたは項目の行間の距離です。
OnChange – ユーザーがコントロールの値を変更したときに実行するアクション (スライダーを調整するなど)。
OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。
PaddingBottom – コントロール内のテキストとそのコントロールの下端との間の距離。
PaddingLeft – コントロール内のテキストとそのコントロールの左端との間の距離。
PaddingRight – コントロール内のテキストとそのコントロールの右端との間の距離。
PaddingTop – コントロール内のテキストとそのコントロールの上端との間の距離。
PressedColor – ユーザーがそのコントロールをタップまたはクリックしたときのコントロール内のテキストの色。
PressedFill – ユーザーがそのコントロールをタップまたはクリックしたときのコントロールの背景色。
RadioBackgroundFill – ラジオ ボタン コントロール内の円の背景色。
RadioBorderColor – ラジオ ボタン コントロールの各オプションの円の色。
RadioSelectionFill – ラジオ ボタン コントロールで選択したオプションの円の内側に表示される色。
RadioSize – ラジオ ボタン コントロールの円の直径。
リセット – コントロールが既定値に戻るかどうか。
SelectedText (非推奨) – 選択した項目を表す文字列値。
サイズ – コントロールに表示されるテキストのフォント サイズ。
取り消し線 – コントロールに表示されるテキストを線で表示するかどうかを指定します。
TabIndex – 他のコントロールに対するキーボード ナビゲーションの順序。
ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。
下線 – コントロールに表示されるテキストの下に行を表示するかどうかを指定します。
表示 – コントロールが表示されるか非表示になっているか。
幅 – コントロールの左端と右端の間の距離。
X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。
Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。
関連する関数
Distinct( DataSource, ColumnName )
Example
ラジオ コントロールを追加し、Pricing という名前を付け、その Items プロパティを次の式に設定します。
["Standard"、"Premium"]
Label コントロールを追加し、ラジオ コントロールの下に移動し、Label コントロールの Text プロパティを次の数式に設定します。
If("Premium" in Pricing.Selected.Value, "$200 per day", "$150 per day")
Alt キーを押しながら、 ラジオ コントロールでいずれかのオプションを選択します。
[ラベル] コントロールには、選択したテキストが表示されます。
(省略可能)Alt キーを押しながら、他のオプションを選択して、適切なテキストが表示されることを確認します。
アクセシビリティ ガイドライン
色のコントラスト
標準のカラー コントラスト要件に加えて、次の間で適切な色コントラストを確保します。
- RadioSelectionFill と RadioBackgroundFill
- RadioBackgroundFill と Fill
スクリーン リーダーのサポート
キーボードのサポート
- キーボード ユーザーが移動できるように 、TabIndex プロパティを 0 以上に設定します。
- フォーカス インジケーターが明確に表示されるように、 FocusedBorderColor プロパティと FocusedBorderThickness プロパティを設定します。