Form モジュール

since: 31st/Aug./2001; last modified: 29th/Sep./2001

Form モジュールはフォームをつくる為の諸要素タイプを定義しています。内容セットでは Form に属し、 form 要素タイプは、DTD では %BlkSpecial.class; に定義されており、その内容モデルで定義されている諸要素タイプは %Inline.class; に定義されています。

フォーム・モジュール [私訳]

button, fieldset, form, input, label, legend, select, optgroup, option, textarea

このモジュールは二つの内容セットを定義する：

Form

form | fieldset

Formctrl

input | select | textarea | label | button

このモジュールが使われるときは、テキスト・モジュールで定義されている、内容セット Block に内容セット Form を加え、内容セット Inline に内容セット Formctrl を加える。

ここで挙げた属性の他に、組み込みイベントモジュールによる追加属性が定義される。

form 要素タイプ

form 要素はフォーム内容のコンテナとして機能するブロックレベルの要素です。フォームコントロールの内容は、 action 属性値の URI が指し示す処理エージェントに受け渡されます。

内容モデル

内容モデルは基本的にはブロックレベル要素です。但し、別の form 要素は内容に持てません。フォームコントロールは全てテキストレベルの要素なので、これらは別のブロックレベル要素の内容として現れます：

<form action="http://somesite.com/prog/adduser" method="post">
    <p>
    First name: <input type="text" name="firstname" /><br />
    Last name: <input type="text" name="lastname" /><br />
    email: <input type="text" name="email" /><br />
    <input type="radio" name="sex" value="Male" /> Male<br />
    <input type="radio" name="sex" value="Female" /> Female<br />
    <input type="submit" value="send" /> <input type="reset" />
    </p>
</form>

フォームに構造を与える為に、 fieldset 要素を用いることもあります：

<form action="..." method="post">
 <fieldset>
 <legend>個人情報</legend>
    ...フォームコントロール省略...
 </fieldset>

 <fieldset>
 <legend>ステータス</legend>
    ...フォームコントロール省略...
 </fieldset>

 <fieldset>
 <legend>スキル</legend>
    ...フォームコントロール省略...
 </fieldset>
</form>

属性

action = uri

• 必須属性
• フォームを処理するエージェントを指し示します。
• HTTP 以外の URI スキームの動作は未定義。

method = get|post

• This attribute specifies which HTTP method will be used to submit the form data set：
  • get:
    • 初期値。
    • ユーザエージェントは action 属性の値に"?" を加え、ここに MIMEタイプ application/x-www-form-urlencoded で符号化したフォームデータ集合を加える。このケースでは、フォームデータは ASCII コードに限られる。
    • a 要素で URI に "?" を記述しても全く同じ。このときは「値＝名前」を & で区切る。
    • CGI では、当該フォームデータは環境変数 QUERY_STRING に格納される。長さ制限がある場合があるので、一般には post が使われる。
  • post:
    • ユーザエージェントは、enctype 属性が指定する MIME タイプによってメッセージを生成し、 action 属性値が示す相手と HTTP の post トランザクションを行なう。
    • CGI では、当該フォームデータは標準入力で受け渡される。環境変数 CONTENT_LENGTH にはデータのバイト数がセットされており、この長さだけ標準入力からデータを読み取る。

enctype = content-type

• method="post" のとき、フォームをサーバに受け取らせる場合のコンテンツタイプを指定する。
• "application/x-www-form-urlencoded"
  • 初期値。
  • ASCII コードに URI エンコードされるので、 ASCII データ以外は処理前にデコードする必要がある。
• "multipart/form-data"
  • type="file" の input 要素と併用する場合に使われる。
  • ASCII コードにエンコードされないので、直接処理できる。

accept-charset = charset list

• 当該フォームを処理するサーバが受け入れる入力データの文字符号化方法のリストを指定する。
• 値は文字セット値の半角のスペース区切りか、コンマ区切り。
• 初期値は "UNKNOWN"。このとき、通常はフォームを含む当該文書の文字符号化方法が採用される。

accept = content-type-list

• 当該フォームを処理するサーバが受け入れられるコンテンツタイプの半角区切りリスト。
• これに合致しないファイルは送信前に拒否され得る。
• type="file" の input 要素を参照。

Common

多くの要素タイプに共通して定義されている属性のセット。

onsubmit = Script

• 組み込みイベントモジュールで追加される属性。
• フォームをサーバに受け入れさせるときに発生。
• 属性セット Events も参照のこと。

onreset = Script

• 組み込みイベントモジュールで追加される属性。
• フォームがリセットされたときに発生。
• 属性セット Events も参照のこと。

formfield 要素

formfield 要素は、 form 要素の内容にだけ現れ、フォームコントロールを構造化するために用います。

内容モデル

内容は、処理対象の文字列 (PCDATA) と legend 要素と任意のブロックレベル及びテキストレベルの要素です。但し、別のフォーム要素や別の fieldset 要素は内容に持たないようにすべきでしょう。

fieldset 要素の内容にだけ定義されている legend 要素は、当該フィールドの領域名、キャプションをマークアップします。この要素のお陰で、非視覚ユーザエージェントでも、当該フィールドにアクセスできるようになります。

legend 要素タイプの内容は、処理対象の文字列と任意のインライン要素です。但し、フォームコントロールに含まれる要素は内容に持たないようにすべきでしょう。

属性

fieldset 要素の属性

Common

多くの要素で共通に定義されている属性の集合

legend 要素の属性

Common

多くの要素で共通に定義されている属性の集合

accesskey = Character

当該フィールドにアクセスする為のキーを指定します。 a 要素の accesskey 属性と同じです。

サンプル

<form action="...省略..." method="post">
  <fieldset>
    <legend accesskey="p">個人情報</legend>
    <p>...省略...</p>
  </fieldset>
  <fieldset>
    <legend accesskey="m">変額</legend>
    <p>...省略...</p>
  </fieldset>
</form>

フォームコントロールに付いては、実際の場面に応じて様々な要求があり、説明が煩雑になるので割愛します。注意点として、以下のものを挙げておきます：

• 個々のフォームコントロール要素には、アクセス可能性の拡大の見地から、 accesskey と tabindex を指定するようにしましょう。
• また、多くの要素が空要素になっているので、記述方法に注意してください。通常の要素の開始タグの末尾が " />" になります。
• フォームコントロールの全ての要素はテキストレベルなので、 form 要素の内容に直接記述することは出来ません。 fieldset 要素か、その他のブロックレベル要素の内容に記述してください。