チェックボックス検証 Widget について

Spry チェックボックス検証 Widget は、ユーザーが HTML フォーム内のあるチェックボックスを選択したとき、または選択しなかったときに、有効状態または無効状態を表示する (単独またはグループの) チェックボックスです。 たとえば、ユーザーが 3 つのオプションを選択する必要があるフォームにチェックボックス検証 Widget を追加します。 ユーザーが 3 つのオプションを選択していない場合は、最小選択数が満たされていないことを示すメッセージが返されます。

次にチェックボックス検証 Widget の例を示します。この例では有効状態を示しています。


A.
チェックボックス検証 Widget グループ、最小選択数状態

B.
チェックボックス検証 Widget、必須状態

チェックボックス検証 Widget には、有効、無効、必須などのいくつかの状態が含まれます。 これらの状態のプロパティは、使用する検証結果に応じて、プロパティインスペクタで変更できます。 検証が実行されるタイミングは、たとえばユーザーが Widget の外側をクリックしたとき、選択したとき、フォームを送信しようとしたときなど、さまざまに設定できます。

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

有効状態
ユーザーが適切な数のオプションを選択し、フォームを送信できるようになったときの Widget の状態。

必須状態
ユーザーが必要な数のオプションを選択し忘れたときの Widget の状態。

最小選択数状態
ユーザーが選択したチェックボックスの数が必要最小数に満たないときの Widget の状態。

最大選択数状態
ユーザーが選択したチェックボックスの数が許容最大数を超えているときの Widget の状態。

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

チェックボックス検証 Widget の初期設定 HTML は、通常はフォームの内部に配置され、チェックボックスの <input type="checkbox"> タグを囲むコンテナ <span> タグで構成されます。 チェックボックス検証 Widget の HTML には、ドキュメントの head 内とこの Widget の HTML マークアップの後の script タグも含まれます。

チェックボックス検証 Widget の動作およびコードの詳細については、www.adobe.com/go/learn_dw_sprycheckbox_jp を参照してください。