1. ウェブ開発の学習
  2. 発展モジュール
  3. ウェブフォーム
  4. 初めてのフォーム

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

初めてのフォーム

このシリーズの最初の記事では、簡単なフォームの設計、HTML フォームコントロールとその他の HTML 要素を使用した正しい実装、 CSS によるとても簡単なスタイル付け、データをサーバーに送る方法を含めた、ウェブフォームを作成する本当に初歩的な経験をします。 サブトピックは、モジュールの後で詳しく展開していきます。

前提条件: HTML を理解するを理解していること。
目的: ウェブフォームとは何か、何に使うのか、どうデザインするのか、サンプル事例に必要な基本の HTML 要素について熟知する。

ウェブフォームとは何か?

ウェブフォームとは、ユーザーと ウェブサイトやアプリケーションとの対話の要となるもののひとつです。 ユーザーはフォームによって、ウェブサイトへデータを送ることができます。それらのデータはたいてい ウェブサーバーに送られて処理、保存されたり（このモジュール後半のサーバーにデータを送るを見てください）、クライアント側ですぐにインターフェイスを更新する（例えば、リストに他の項目を追加したり、UI の機能を表示/非表示にしたりする）こともあります。

ウェブフォームは 1 つ以上のフォームコントロール（ウィジェットともいいます）と、フォーム全体を構成するのに役立つ追加要素 — よく HTML フォームと呼ばれます — とで作られます。 それらのコントロールは単一行または複数行のテキストフィールド、ドロップダウンボックス、ボタン、チェックボックス、ラジオボタンがあります。たいていは <input> 要素を使って作成されますが、その他の要素もあります。

フォームコントロールは、特定フォームの値が入力されるのを強制するためにもプログラミングされ（フォーム検証）、目の見えるユーザーと目の不自由なユーザーの両方に対して用途を説明するテキストのラベルと対になります。

フォームを設計する

コードを書き始める前に、そこから離れてフォームについて考える時間をとるとよいでしょう。簡単なモデルを作ると、ユーザーに入力を依頼したいデータの適切なセットを定義することの助けになります。ユーザー体験 (UX) の観点では、フォームが大規模になるとユーザーが不満を持って離れるリスクが高まると覚えておくことが重要です。簡単に、かつ集中するようにしてください。本当に必要なことだけを尋ねてください。

フォームの設計は、サイトやアプリケーションを構築する際の大切なステップです。 フォームのユーザー体験まで扱うと本記事の対象を超えてしまいますが、そこまで踏み込みたい場合は以下の記事をご覧ください。

本記事では、シンプルな問い合わせフォームを作成します。簡単に図を描いてみましょう。

作成するフォームのラフスケッチ

このフォームには、3 つのテキストフィールドと 1 つのボタンがあります。要するに、ユーザーへ名前 (Name)、メールアドレス (E-mail)、送信したいメッセージ (Message) を尋ねます。ボタンを押すと、データをウェブサーバーへ送信します。

フォームの HTML の実装

これで、HTML に移ってフォームのコードを書く準備ができました。問い合わせフォームを作るために、以下の HTML 要素、 <form>、<label>、<input>、<textarea>、<button> を使用します。

前に進む前に、簡単な HTML テンプレートをローカルにコピーします。 — ここにフォームの HTML を入力します。

<form> 要素

すべてのフォームは、以下のように <form> 要素から始まります。

html
<form action="/my-handling-form-page" method="post">…</form>

これは、フォームを正式に定義します。これは <section> や <footer> 要素と同様にコンテナー要素ですが、フォームを含めるのに特化しています。フォームの動作方法を設定するための特有の属性にも対応しています。すべての属性は省略可能ですが、少なくとも action 属性と method 属性は常に設定するのがふつうです。

  • action 属性は、フォームで収集したデータを送信すべき場所 (URL) を定義します。
  • method 属性は、データを送信するために使用する HTTP メソッド（get または post）を定義します。

メモ: これらの属性がどのように働くかについて、詳しくはフォームデータの送信で説明しています。

今のところは、上の <form> 要素を HTML の <body> に追加します。

<label>、<input>、<textarea> 要素

問い合わせフォームはとてもシンプルで、 3 つのテキストフィールドがあり、それぞれに対応する <label> がついています。

  • 名前の入力フィールドは、基本的な単一行のテキストフィールドです。
  • メールアドレスの入力フィールドは、email 型の入力フィールドです。メールアドレスだけを受け付ける単一行のテキストフィールドです。
  • メッセージの入力フィールドは <textarea> です。複数行のテキストフィールドです。

これらのフォームウィジェットを実装するためには、 HTML コードとしては、以下のようなものが必要です。

html
<form action="/my-handling-form-page" method="post">
  <p>
    <label for="name">Name:</label>
    <input type="text" id="name" name="user_name" />
  </p>
  <p>
    <label for="mail">Email:</label>
    <input type="email" id="mail" name="user_email" />
  </p>
  <p>
    <label for="msg">Message:</label>
    <textarea id="msg" name="user_message"></textarea>
  </p>
</form>

フォームのコードを上記のようなものに更新してください。

<p> 要素はコードを扱いやすく構造化するとともに、スタイル設定を容易にするため (後述) に置いています。 ユーザビリティとアクセシビリティのため、それぞれのフォームコントロールに明示的にラベルをつけます。 for 属性をすべての <label> 要素に使用し、その値として関連付けるフォームコントロールの id を取ります。これで、フォームコントロールをラベルと関連付けることができます。

これには利点があります。フォームコントロールにラベルを関連付けて、ユーザーがマウス、トラックパッド、タッチ端末でラベルをクリックすると、対応するウィジェットがアクティブになり、スクリーンリーダーのユーザーに読み上げられるアクセシブルな名前が提供されます。 この属性の利点をさらに知りたいのであれば、ウェブフォームの構築方法 の記事ですべてを詳しく説明しています。

<input> 要素において、もっとも重要な属性は、type 属性です。 この属性は <input> 要素の見た目や動作を定義するため、とても重要です。 これについてもっと詳しいことは、基本的なネイティブフォームコントロールの記事にあります。

  • このシンプルな例では、最初の input に text という値を使用しています。これはこの属性のデフォルト値です。 これはあらゆるテキストを受け入れる、単一行のテキストフィールドを表します。
  • 2 番目の input では、 email という値を使用しています。これは正しい形式のメールアドレスのみを受け付ける単一行のテキストフィールドを定義します。 この値は基本的なテキストフィールドを、ユーザーによって入力されたデータをチェックするようにする「賢い」フィールドへと変化させます。 また、スマートフォンのように動的なキーボードのある端末で、メールアドレスを入力するのにふさわしいキーボードレイアウト（例えばデフォルトで @ 記号があるもの）が表示されるようにします。 フォームの検証について詳しく知りたい場合は、データフォームの検証の記事をご覧ください。

大事なことを言い忘れましたが、<input> と <textarea></textarea> の構文に注意してください。 これは HTML の奇妙な点の 1 つです。 <input> タグは空要素です。つまり、終了タグは不要です。 一方 <textarea> は空要素ではないので、適切な終了タグで閉じる必要があります。これは HTML フォームの特定の機能、つまりデフォルト値の定義方法に影響があります。 <input> 要素のデフォルト値を定義するには、次のように value 属性を使う必要があります。

html
<input type="text" value="デフォルトでこの要素にはこのテキストが挿入されます" />

一方、 <textarea> のデフォルト値を定義したい場合は、次のようにデフォルト値を <textarea> の開始タグと終了タグの間に書いてください。

html
<textarea>
デフォルトでこの要素にはこのテキストが挿入されます
</textarea>

<button> 要素

フォームはほぼできあがりました。あとは、ユーザーがフォームに記入したらデータを「送信」するためのボタンを追加します。 これは、<button> 要素を使用して簡単にできます。終了タグ </ul> の直前に次の行を追加してください。

html
<p class="button">
  <button type="submit">メッセージを送信</button>
</p>

<button> 要素は type 属性を受け入れます。これは submit、reset、button の 3 種類の値のうち 1 つを受け入れます。

  • submit ボタン（デフォルト値）をクリックすると、フォームのデータを <form> 要素の action 属性で定義したウェブページへ送信します。
  • reset ボタンをクリックすると、直ちにすべてのフォームウィジェットをデフォルト値にリセットします。 UX の観点では、このボタンは悪い行為であると考えられており、必要な理由がない限りこのボタンは使用しないようにしてください。
  • button ボタンをクリックすると何もしません! おかしなことのように見えますが、独自のボタンを作成するのに驚くほど役立ちます。 JavaScript でその機能を定義することができます。

メモ: <input> 要素を使用して、対応する type を指定してボタンを作成することもできます。例えば <input type="submit"> のように。<button> 要素との大きな違いは、<input> 要素ではラベルとしてプレーンテキストしか許容しませんが、<button> 要素ではすべての HTML コンテンツを使用して、もっと複雑でクリエイティブなボタンの内容を作成することができます。

基本的なフォームの整形

フォームの HTML コードの記述ができました。このフォームを保存してブラウザーで見てみてください。今のところ、かなり不格好であることがわかると思います。

メモ: 作成した HTML コードが正しくないと思われる場合は、完成例と比較してみてください — first-form.html にあります (ライブ版も参照)。

フォームをきれいにスタイル付けするのは、なかなか難しいものです。フォームのスタイル付けを詳しく教えるのはこの記事の範囲外なので、とりあえず見た目が問題ないように CSS を追加してもらうだけにしておきましょう。

最初に、ページの HTML の head 内に <style> 要素を追加します。次のようになります。

html
<style>
  /* CSS をここに配置 */
</style>

style タグの中に、以下の CSS を追加してください。

css
body {
  /* フォームをページの中央に配置 */
  text-align: center;
}

form {
  display: inline-block;
  /* フォームの外枠 */
  padding: 1em;
  border: 1px solid #cccccc;
  border-radius: 1em;
}

p + p {
  margin-top: 1em;
}

label {
  /* 大きさと配置を統一 */
  display: inline-block;
  min-width: 90px;
  text-align: right;
}

input,
textarea {
  /* すべてのテキストフィールドのフォント設定を一致させる
     デフォルトで、 textarea には等幅フォントが設定されている */
  font: 1em sans-serif;
  /* テキストフィールドの大きさを統一 */
  width: 300px;
  box-sizing: border-box;
  /* フォームフィールド境界に合わせる */
  border: 1px solid #999999;
}

input:focus,
textarea:focus {
  /* 概要の幅とスタイルを設定 */
  outline-style: solid;
  /* アクティブな要素に少しハイライトを設定 */
  outline-color: black;
}

textarea {
  /* 複数行のテキストフィールドをラベルに揃える */
  vertical-align: top;
  /* テキスト入力に十分な空間を与える */
  height: 5em;
}

.button {
  /* ボタンを他のテキストフィールドと同じ場所に置く */
  padding-left: 90px; /* label 要素と同じサイズ */
}

button {
  /* このマージンは、ラベルとテキストフィールドの間のスペースと
     おおよそ同じスペースを表す */
  margin-left: 0.5em;
}

保存して再読み込みすると、フォームがよりきれいになりました。

メモ: GitHub の first-form-styled.html にあります(ライブ版も確認)。

ウェブサーバーへのデータの送信

最後の、またもっともややこしいであろう部分が、サーバー側でのフォームデータの扱いです。 <form> 要素は action 属性と method 属性により、どこへどのようにデータを送信するかを定義できます。

フォームコントロールには name をつけます。これらの名前はクライアント側とサーバー側の両側で重要です。ブラウザー側ではそれぞれのデータにどのような名前をつけるかを示すものであり、サーバー側では名前によってそれぞれのデータを扱うことができます。フォームデータは名前/値のペアとしてサーバーに送信されます。

データに名前をつけるために、各々のデータを集めるフォームウィジェットの name 属性を使用しなければなりません。ここでもフォームのコードで見てみましょう。

html
<form action="/my-handling-form-page" method="post">
  <p>
    <label for="name">Name:</label>
    <input type="text" id="name" name="user_name" />
  </p>
  <p>
    <label for="mail">Email:</label>
    <input type="email" id="mail" name="user_email" />
  </p>
  <p>
    <label for="msg">Message:</label>
    <textarea id="msg" name="user_message"></textarea>
  </p>

  …
</form>

この例では、フォームから "user_name", "user_email", "user_message" という 3 つのデータが送信されます。 このデータは、 HTTP の POST メソッドを用いて /my-handling-form-page という URL に送信されます。

サーバー側では、 URL "/my-handling-form-page" にあるスクリプトが、 HTTP リクエストに含まれる 3 つのキー/値の項目のリストとしてデータを受け取ることになります。 このスクリプトがどのようにデータを処理するかは、あなた次第です。 各サーバーサイド言語 (PHP, Python, Ruby, Java, C# など) は、フォームデータを処理する独自のメカニズムを持っています。 そのことについて深く掘り下げることはこのガイドの範囲外ですが、もっと知りたい場合は、この後の フォームデータの送信 の記事でいくつかの例を示しています。

まとめ

おめでとうございます。初めてのウェブフォームが完成しました。こちらが最終結果のデモです。

これはほんの開始点です、しかし — より深く見ていくときが来ました。ウェブフォームはここで見てきたものよりさらに強力であり、このガイドの他の記事で残りの部分を習得できます。

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告