ラジオグループ検証 Widget について

"ラジオグループ検証 Widget" は、選択項目の検証サポート機能を備えたラジオボタングループです。この Widget では、グループ内のラジオボタンが必ず 1 つ選択されるように検証が行われます。

いろいろな状態のラジオグループ検証 Widget の例を次に示します。

A.

ラジオグループ検証 Widget のエラーメッセージ

B.

ラジオグループ検証 Widget のグループ

ラジオグループ検証 Widget には、初期 (イニシャル) 状態の他に、有効、無効、必須の 3 つの状態があります。これらの状態のプロパティは、対応する CSS ファイル (SpryValidationRadio.css) を編集することにより、目的の検証結果に応じて変更できます。検証が実行されるタイミングとしては、ユーザーが Widget の外側をクリックしたとき、選択操作を実行したとき、またはフォームを送信しようとしたときを指定できます。

イニシャル状態

ページがブラウザに読み込まれたとき、またはユーザーがフォームをリセットしたときの状態。

有効状態

ユーザーが有効な項目を選択し、フォームを送信できる状態になったときの状態。

必須状態

ユーザーが必要な選択操作をしていないときの状態。

無効状態

受け入れられない値を持つラジオボタンをユーザーが選択したときの状態。

実行時、ユーザーの操作によってラジオグループ検証 Widget がこれらいずれかの状態に変化すると、Spry フレームワークロジックにより、この Widget の HTML コンテナに特定の CSS クラスが適用されます。たとえば、ユーザーがオプションを選択せずにフォームを送信しようとした場合、「項目を選択してください」というエラーメッセージを表示するクラスが Widget に適用されます。エラーメッセージのスタイルと表示状態を制御するルールは、この Widget に対応する SpryValidationRadio.css というファイル内にあります。

ラジオグループ検証 Widget の初期設定 HTML コードは、通常はフォームの内部に配置され、コンテナ span タグで構成されます。このタグは、ラジオグループの input type="radio" タグを囲みます。ラジオグループ検証 Widget の HTML コードには、ドキュメントの head 内とこの Widget の HTML コードの後に配置される script タグも含まれます。

ラジオグループ検証 Widget の動作およびコードの詳細については、www.adobe.com/go/learn_dw_spryradio_jp を参照してください。