Close
Angular React Web Components Blazor Angular
Open Source

Radio Group (ラジオ グループ)

Angular Radio と Radio Group は、相互に排他的なオプションのセットからユーザーが 1 つのオプションのみを選択できるようにするコンポーネントです。各ラジオ ボタンは 1 つのオプションを表し、Radio Group はラジオ ボタンを縦方向または横方向のレイアウトで配置します。

ライブ デモ

構造

Angular Radio Group はラジオ ボタンを含み、各ラジオ ボタンはラジオ コントロールとラベルで構成されます。

ラベル、ラジオ コントロール、ラジオ ボタンのグループを示す Radio Group の構造
1. Radio Button ラベル: 選択または選択解除する内容を示します
2. Radio Button: 選択状態かどうかを示します。入力の既定の状態は未選択です
3. Button Group: 関連するオプションをグループ化し、一度に 1 つだけ選択できるようにするコンテナーです

次の図は、Angular Radio Group の要素構造を示しています。各ラジオ ボタンはラジオ コントロールとラベル コンテンツを組み合わせたもので、ラベル コンテンツはコントロールの前または後に配置できます。

igx-radio-group                  — groups the radio buttons
└── igx-radio                    — one per option
    ├── input.igx-radio__input   — the native radio input
    ├── .igx-radio__composite    — the radio control
    └── .igx-radio__label        — the projected label content

はじめに

Angular Radio と Radio Group を使用するには、基本的なプロジェクト設定について Ignite UI for Angular はじめに トピックに従い、対象プラットフォームに合わせてコンポーネントをインポートまたは登録します。

Radio コンポーネントと IgxRadioGroupDirective ディレクティブをインポートします。

import { IgxRadioComponent, IgxRadioGroupDirective } from 'igniteui-angular/radio';

両方をコンポーネントの imports コレクションに追加するか、両方を含む IGX_RADIO_GROUP_DIRECTIVES コレクションを追加してから、テンプレートで igx-radio-group 要素と igx-radio 要素を使用します。

登録後、Angular Radio コンポーネントを Radio Group 内に配置し、グループに name を指定して、ユーザーがオプションのうち 1 つだけを選択できるようにします。選択されたオプションを識別するために、各ラジオ ボタンに value を設定します。

<igx-radio-group name="fruit" alignment="vertical" value="apple">
  <igx-radio value="apple">Apple</igx-radio>
  <igx-radio value="banana">Banana</igx-radio>
  <igx-radio value="mango">Mango</igx-radio>
</igx-radio-group>

前提条件とバージョンの互換性

Angular Radio と Radio Group は、次のパッケージに含まれています。このトピックのサンプルは、パッケージの横に記載されているバージョンで作成されています。

パッケージ サンプルで使用されているバージョン
igniteui-angular 22.2.0

使用方法

レイアウト

Angular Radio は、既定でラベルをラジオ コントロールの後に配置します。ラベルをコントロールの前に配置するには、labelPosition プロパティを before に設定します。縦方向の Radio Group では、ラベルがコントロールの前にあるラジオ ボタンはグループの終端側に揃えられます。

<igx-radio-group name="color" alignment="vertical" value="yellow">
  <igx-radio value="yellow" labelPosition="before">Yellow</igx-radio>
  <igx-radio value="orange" labelPosition="before">Orange</igx-radio>
</igx-radio-group>

ラジオ ボタンには、その外部にある要素でラベルを付けることもできます。ラベルの位置と外観を完全に制御する必要がある場合は、aria-labelledby でその要素を参照します。

<span id="radio-label">Express delivery</span>
<igx-radio aria-labelledby="radio-label" value="express"></igx-radio>

方向

Angular Radio Group は、ラジオ ボタンを 1 列に積み重ねるか、1 行に並べて配置します。alignment プロパティを vertical または horizontal に設定します。既定の配置は horizontal です。

<igx-radio-group name="chart" alignment="horizontal" value="line">
  <igx-radio value="line">Line</igx-radio>
  <igx-radio value="bar">Bar</igx-radio>
  <igx-radio value="pie">Pie</igx-radio>
</igx-radio-group>

インタラクション状態

Angular Radio は、ポインターが上にあるときにホバー状態を表示し、キーボード フォーカスを受け取るとフォーカス リングを表示します。無効 (invalid) 状態を表示するには、invalid プロパティを設定します。この状態では、ラジオ コントロールがテーマのエラー色で描画されます。

<igx-radio value="daily" [invalid]="true">Daily Updates</igx-radio>

次のサンプルは、チェック済み、未チェック、無効 (invalid) のラジオ ボタンについて、ホバー、フォーカス、フォーカスとホバーの各状態を示しています。

無効状態

Angular Radio を無効にするには、disabled プロパティを設定します。無効なラジオ ボタンは選択できず、キーボードによる移動ではスキップされます。

<igx-radio-group name="age" alignment="vertical" value="18-27">
  <igx-radio value="18-27">18-27</igx-radio>
  <igx-radio value="28-39">28-39</igx-radio>
  <igx-radio value="40-55" [disabled]="true">40-55</igx-radio>
</igx-radio-group>

オン/オフ状態

Angular Radio は、オン (チェック済み) またはオフのいずれかの状態になります。ラジオ ボタンをオンにするには、そのラジオ ボタンに checked プロパティを設定します。または、Radio Group の value を設定すると、値が一致するラジオ ボタンがオンになります。ラジオ ボタンをオンにすると、グループ内の他のラジオ ボタンはオフになります。

<igx-radio-group name="age" alignment="vertical" value="18-27">
  <igx-radio value="18-27">18-27</igx-radio>
  <igx-radio value="28-39">28-39</igx-radio>
  <igx-radio value="40-55">40-55</igx-radio>
</igx-radio-group>

フォーム

Angular Radio は、選択されたラジオ ボタンの value を、グループの name に指定した名前で送信します。フォームの送信前に選択を必須にするには、グループ内のラジオ ボタンに required プロパティを設定します。

Radio Group は、テンプレート駆動フォームとリアクティブ フォームで動作します。igx-radio-group に ngModel またはフォーム コントロールを設定して、選択された値をバインドします。

<form [formGroup]="fruitsForm">
  <igx-radio-group name="fruit" alignment="vertical" formControlName="favoriteFruit">
    <igx-radio value="apple">Apple</igx-radio>
    <igx-radio value="banana">Banana</igx-radio>
    <igx-radio value="orange">Orange</igx-radio>
  </igx-radio-group>
</form>

使用すべき場合と使用すべきでない場合

Radio Group に項目を追加して拡張する場合は、項目の配置を揃え、1 列になるようにしてください。複数列のレイアウトや、オン状態の Radio 要素が同時に複数ある状況は避けてください。

推奨: グループのラジオ ボタンを 1 列に並べ、オンにするオプションを 1 つにします。非推奨: ラジオ ボタンを複数の列に分けたり、複数のオプションをオンにしたりします。

プロパティ

次のプロパティは、このページで説明する Angular Radio と Radio Group のオプションを対象としています。生成された完全な一覧については、API リファレンスを参照してください。

名前 型 既定値 説明
checked boolean false ラジオ ボタンがオンかどうかを取得または設定します。
disabled boolean false ラジオ ボタンが無効かどうかを取得または設定します。
invalid boolean false ラジオ ボタンが無効 (invalid) 状態かどうかを取得または設定します。
labelPosition LabelPosition after ラベルをラジオ コントロールの前と後のどちらに配置するかを設定します。
required boolean false 選択が必須かどうかを取得または設定します。
value any — ラジオ ボタンがオンのときにフォームと共に送信される値を取得または設定します。
alignment (Radio Group) RadioGroupAlignment horizontal ラジオ ボタンを 1 列に積み重ねるか、1 行に並べて配置するかを設定します。
value (Radio Group) any — オンになっているラジオ ボタンの値を取得または設定します。
name string — ラジオ ボタンをグループ化する名前を取得または設定します。
name (Radio Group) string — グループ内のすべてのラジオ ボタンに適用される名前を取得または設定します。

メソッド

Angular Radio は、次のメソッドを公開します。

名前 説明
select() ラジオ ボタンをオンにし、change イベントを発行します。ラジオ ボタンが既にオンの場合は何も行いません。
deselect() change イベントを発行せずに、ラジオ ボタンをオフにします。

イベント

Angular Radio は、ユーザーがラジオ ボタンをオンにしたときにイベントを発行します。

名前 説明
change (Radio and Radio Group) ラジオ ボタンのチェック状態が変更されたときに発行されます。イベント引数には、ラジオ ボタンの checked 状態と value が含まれます。

スタイル設定

Angular Radio は、Ignite UI for Angular テーマと、それが生成する CSS 変数によってスタイル設定されます。次のサンプルでは、カスタム パレットと書体を使用して配送フォームのラジオ ボタンを描画しています。

Sass テーマ

radio-theme 関数でテーマを作成し、tokens ミックスインで含めます。テーマが残りの色を $empty-color と $fill-color から派生させるため、この 2 つを設定するだけでラジオ ボタンのスタイルを完全に設定できます。

@use "igniteui-angular/theming" as *;

$custom-radio-theme: radio-theme(
  $empty-color: #345779,
  $fill-color: #2dabe8,
);

:host {
  @include tokens($custom-radio-theme);
}

プライマリ パラメーターを設定すると、テーマはその依存パラメーターを派生させます。

プライマリ パラメーター 依存パラメーター 変更内容
$empty-color $hover-color, $focus-outline-color (Indigo) 未チェックのラジオ ボタンの境界線。
$fill-color $fill-color-hover, $fill-hover-border-color, $focus-border-color (Bootstrap), $focus-outline-color (Bootstrap), $focus-outline-color-filled (Indigo) チェック済みのラジオ ボタンの境界線とドット。
$label-color $label-color-hover ラベルのテキスト。
$error-color $error-color-hover, $focus-outline-color-error 無効 (invalid) 状態のラベル、境界線、ドット。

CSS 変数

Sass テーマを使用せずに色を変更するには、ラジオ ボタンまたはその祖先要素に次の CSS 変数を設定します。

変数 変更内容
--ig-radio-label-color ラベルのテキスト。
--ig-radio-empty-color 未チェックのラジオ ボタンの境界線。
--ig-radio-empty-fill-color 未チェックのラジオ ボタンの塗りつぶし。
--ig-radio-fill-color チェック済みのラジオ ボタンの境界線とドット。
--ig-radio-hover-color ホバー時の境界線とドット。
--ig-radio-fill-color-hover ホバー時のチェック済みのラジオ ボタンのドット。
--ig-radio-error-color 無効 (invalid) 状態のラベル、境界線、ドット。
--ig-radio-disabled-color 無効なラジオ ボタンの境界線とドット。
--ig-radio-disabled-label-color 無効なラジオ ボタンのラベル。
--ig-radio-focus-outline-color フォーカスのアウトライン。

Tailwind によるスタイル設定

igniteui-theming のカスタム Tailwind ユーティリティ クラスを使用して、Angular Radio のスタイルを設定できます。最初に Tailwind をセットアップ してから、グローバル スタイルシートでユーティリティをインポートしてください。

@import "tailwindcss";
@import "igniteui-theming/tailwind/utilities/material.css";

テーマに対応する light-radio または dark-radio クラスを使用し、任意プロパティでその CSS 変数をオーバーライドします。

<igx-radio class="!light-radio ![--empty-color:#576E60] ![--fill-color:#7B9E89]" value="tokyo">Tokyo</igx-radio>

感嘆符 (!) により、Tailwind ユーティリティが Radio の既定のテーマ スタイルよりも優先されます。

アクセシビリティ

Angular Radio はネイティブのラジオ入力をレンダリングするため、支援技術は各ラジオ ボタンをそのロール、ラベル、チェック状態とともに読み上げます。

キーボード操作

Angular Radio Group では、矢印キーを使用して、有効なラジオ ボタン間でフォーカスと選択が移動します。無効なラジオ ボタンはスキップされます。

キー 動作
Tab / Shift+Tab Radio Group にフォーカスを移動するか、Radio Group からフォーカスを外します。
Arrow Down / Arrow Right 次の有効なラジオ ボタンにフォーカスを移動し、そのラジオ ボタンをオンにします。最後のラジオ ボタンからは最初のラジオ ボタンに移動します。右から左のレイアウトでは、Arrow Right で前のラジオ ボタンに移動します。
Arrow Up / Arrow Left 前の有効なラジオ ボタンにフォーカスを移動し、そのラジオ ボタンをオンにします。最初のラジオ ボタンからは最後のラジオ ボタンに移動します。右から左のレイアウトでは、Arrow Left で次のラジオ ボタンに移動します。
Space フォーカスされているラジオ ボタンをオンにします。

スクリーン リーダー / ARIA

  • 各 Angular Radio はネイティブの <input type="radio"> をレンダリングし、radio ロール、チェック状態、無効状態、必須状態を公開します。入力要素は、invalid プロパティに基づいて aria-invalid も設定します。

  • ラジオ ボタンのラベル コンテンツが、そのアクセシブルな名前になります。ラベルがコンポーネントの外部にある場合は、aria-labelledby で関連付けます。

  • igx-radio-group 要素は radiogroup ロールをレンダリングしません。グループを 1 つの質問として読み上げる必要がある場合は、role="radiogroup" と、aria-labelledby などによるアクセシブルな名前を追加します。

アクセシビリティ準拠

レンダリングされた Angular Radio と Radio Group が、アプリケーションのアクセシビリティ要件を満たしていることを確認してください。

基準 コンポーネントが要件をサポートする方法
2.1.1 Keyboard ユーザーは、矢印キーと Space キーを使用して有効なラジオ ボタン間を移動し、ラジオ ボタンをオンにします。
4.1.2 Name, Role, Value 各ラジオ ボタンは、ネイティブのラジオ入力を通じて、ラベルをアクセシブルな名前として公開し、radio ロールとチェック状態も公開します。

ユーザー側の責任:

  • すべてのラジオ ボタンに意味のあるラベル コンテンツを指定し、Radio Group にアクセシブルな名前を付けます。
  • Radio の色をカスタマイズする場合は、フォーカス リングを表示したままにし、十分なコントラストを維持します。
  • エラーが色だけで伝わることのないように、Radio が無効 (invalid) な場合は検証メッセージを表示します。周囲のフォームにメッセージを表示します。
  • レンダリングされた Radio Group を、キーボードによる移動と、ユーザーが利用する支援技術でテストします。

既知の制限

Angular Radio と Radio Group には、次の既知の制限があります。

  • igx-radio-group 要素は radiogroup ロールをレンダリングしません。要素にロールとアクセシブルな名前を手動で追加してください。

API リファレンス

Angular Radio と Radio Group の完全な API リファレンスを参照してください。

依存関係

Angular Radio には、ビジュアル スタイルを適用するためのテーマ スタイルシートが必要です。フレームワーク固有のセットアップについては、はじめにを参照してください。また、Radio はリップル効果に IgxRipple Theme を使用します。

その他のリソース

API の詳細とプロジェクトのサポートについては、次の Angular リソースを参照してください。

関連コンポーネント

Angular Radio は、相互に排他的なオプションの短いリストから 1 つを選択するためのものです。その他の種類の選択には、次の関連コンポーネントを使用します。

  • Checkbox - ユーザーが複数のオプションを選択できる場合は Checkbox を使用します。
  • Switch - コントロールで 1 つの設定を即座にオンまたはオフにする場合は Switch を使用します。
  • Select - オプションのリストが長い場合やスペースが限られている場合は Select を使用します。

FAQ

ここでは、Angular Radio と Radio Group の選択、フォーム、状態に関する一般的なシナリオについて、よくある質問に回答します。

ユーザーが選択を変更したときに、選択された値を取得するにはどうすればよいですか?

Angular Radio Group の change イベントを処理します。change イベントの引数には、ユーザーがオンにしたラジオ ボタンの value が含まれます。igx-radio-group に ngModel またはフォーム コントロールを設定して、選択された値をバインドすることもできます。コードで Radio Group の value を設定した場合、change イベントは発生しません。

コードからラジオ ボタンを選択するにはどうすればよいですか?

Angular Radio Group の value を、オンにするラジオ ボタンの value に設定します。Radio Group の value を設定しても、change イベントは発生しません。ラジオ ボタンを選択して change イベントを発生させるには、そのラジオ ボタンの select() メソッドを呼び出します。

Radio Group の選択をクリアするにはどうすればよいですか?

標準的なラジオ ボタンの動作として、ユーザーは選択された Angular Radio を再度クリックしてオフにすることはできません。コードで選択をクリアするには、Radio Group の value、またはグループにバインドされたフォーム コントロールを null に設定します。ユーザー自身が選択をクリアできるようにする必要がある場合は、“なし” オプションまたは個別のクリア ボタンを追加します。

複数のラジオ ボタンが同時にオンになるのはなぜですか?

Angular Radio コンポーネントは、同じ igx-radio-group 内に配置されると相互に排他的になります。name を設定しない場合は、グループが共有の名前を生成します。単独のラジオ ボタンを使用するのではなく、関連するラジオ ボタンを 1 つの Radio Group にまとめて配置します。

フォームで選択を必須にするにはどうすればよいですか?

Angular Radio Group に required を設定するか、グループにバインドされたフォーム コントロールに Validators.required を追加します。ユーザーがいずれかのラジオ ボタンをオンにするまで、フォームは無効 (invalid) のままです。

Radio Group のすべてのラジオ ボタンを無効にするにはどうすればよいですか?

Angular Radio Group がリアクティブ フォーム コントロールにバインドされている場合は、そのコントロールで disable() を呼び出して、すべてのラジオ ボタンを無効にします。フォーム コントロールを使用しない場合は、Radio Group に disabled 入力プロパティがないため、各 igx-radio に disabled を設定します。