ラジオグループ検証 Widget の挿入と編集



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

    1. [挿入]-[Spry]-[Spry ラジオグループ検証] を選択します。
    2. [名前] テキストボックスに、ラジオグループの名前を入力します。
    3. プラス (+) ボタンをクリックしてグループのラジオボタンを追加、または、マイナス (-) ボタンをクリックして減らします。
    4. [ラベル] 列で、各ラジオボタンの名前をクリックしてフィールドを編集可能な状態にし、ラジオボタンごとに固有の名前を付けます。
    5. [値] 列で、それぞれの値をクリックしてフィールドを編集可能な状態にし、ラジオボタンごとに固有の値を割り当てます。
    6. (オプション) ラジオボタンまたはその値をクリックして特定の行を選択し、上向き矢印と下向き矢印をクリックして行を上下に移動します。
    7. ラジオグループのレイアウトのタイプを選択します。
      改行
      各ラジオボタンを、改行 (br タグ) を使用して別々の行に配置します。

      テーブル
      各ラジオボタンを、テーブル行 (tr タグ) を使用して行別に配置します。

    8. 「OK」をクリックします。
    注意： [挿入] パネルの [Spry] カテゴリを使用してラジオグループ検証 Widget を挿入することもできます。

    検証を実行するタイミングの指定

    検証がどの時点で実行されるかを指定できます。指定できるのは、ユーザーが Widget の外側をクリックしたとき、ユーザーが選択すると同時、またはユーザーがフォームの送信を試みたときのいずれかです。

    1. ドキュメントウィンドウで、ラジオグループ検証 Widget の青いタブをクリックして選択します。
    2. プロパティインスペクタ ([ウィンドウ]-[プロパティ]) で、検証をどの時点で行うかを指定するオプションを選択します。 すべてのオプションを選択することも、[送信] のみを選択することもできます。
      onBlur
      ユーザーがそのラジオグループの外側をクリックしたときに常に検証します。

      onChange
      ユーザーが選択したときに検証します。

      onSubmit
      ユーザーがフォームの送信を試みたときに検証します。送信オプションは初期設定で選択され、選択解除することはできません。

    デザインビューでの Widget の状態の表示

    1. ドキュメントウィンドウで、ラジオグループ検証 Widget の青いタブをクリックして選択します。
    2. プロパティインスペクタ ([ウィンドウ]-[プロパティ]) で、[プレビューの状態] ポップアップメニューから表示する状態を選択します。たとえば、初期状態の Widget を表示する場合は [イニシャル] を選択します。

    ラジオボタンの必須状態の変更

    ラジオグループ検証 Widget の初期設定では、フォームを送信する前に項目を選択することが必須です。ただし、ユーザーの選択操作をオプションにすることもできます。

    1. ドキュメントウィンドウで、ラジオグループ検証 Widget の青いタブをクリックして選択します。
    2. プロパティインスペクタ ([ウィンドウ]-[プロパティ]) で、[必須] オプションをオフにします。

    空または無効な値の指定

    ユーザーが選択するラジオボタンに空または無効と見なされる値を指定できます。空の値を持つラジオボタンをユーザーが選択すると、ブラウザに「項目を選択してください」というエラーメッセージが表示されます。無効な値を持つラジオボタンをユーザーが選択すると、ブラウザに「有効な値を選択してください」というエラーメッセージが表示されます。

    空の値を持つラジオボタンを含んだラジオグループ Widget。

    1. 空の値または無効な値を持つラジオボタンを作成するラジオグループ Widget 内で、該当するラジオボタンを選択します。ラジオグループ Widget で空または無効と見なされる値を指定する前に、それらの値をラジオボタンに割り当てておく必要があります。
    2. ラジオボタンのプロパティインスペクタ ([ウィンドウ]-[プロパティ]) で、該当するラジオボタンにチェック済み値を割り当てます。空の値を持つラジオボタンを作成するには、[チェック済み値] テキストボックスに「none」と入力します。無効な値を持つラジオボタンを作成するには、[チェック済み値] テキストボックスに「invalid」と入力します。
    3. ラジオグループ検証 Widget の青いタブをクリックして Widget 全体を選択します。
    4. プロパティインスペクタで、空の値または無効な値を指定します。空の値に対して「項目を選択してください」というエラーメッセージを表示する Widget を作成するには、[空の値] テキストボックスに「none」と入力します。無効な値に対して「有効な値を選択してください」というエラーメッセージを表示する Widget を作成するには、[無効な値] テキストボックスに「invalid」と入力します。

      エラーメッセージを正常に表示するには、ラジオボタン自体とラジオグループ Widget の両方に none または invalid の値を割り当てる必要があります。