複数行のテキスト入力欄を表す

textarea要素は、複数行のテキスト入力欄を作成します。

入力欄の初期値について

textarea要素内の文字列は、初期値として入力欄に表示されることになります。

<textarea name="example">
この文字列が初期値として表示されます
</textarea>

• 初期値の文字列に<や>記号が含まれる場合は、<>と記述します。また、&記号も&と記述しておきます。

name属性について

name属性は、フォーム部品を識別するための名前を指定します。

この属性の値は、入力されたデータ（または初期値）とセットで送信されることになります。

<textarea name="comment">
Hello
</textarea>

上記の場合は、comment=Hello といった感じで送信されます。

cols属性とrows属性について

cols属性とrows属性は、入力欄の幅と高さを指定します。

次の例では、50文字分の幅と10行分の高さを指定しています。

<textarea name="example" cols="50" rows="10"></textarea>

minlength属性について

minlength属性は、入力できる最小文字数を指定します。

次の例では、最小文字数を10文字に指定しています。

<textarea name="example" minlength="10"></textarea>

maxlength属性について

maxlength属性は、入力できる最大文字数を指定します。

次の例では、最大文字数を50文字に指定しています。

<textarea name="example" maxlength="50"></textarea>

wrap属性について

wrap属性は、入力テキストの折り返し部分を、送信データに反映させるかどうかを指定します。指定できる値は次の2つです。

soft

折り返しを反映せずに送信します。（既定値）

hard

折り返し部分に改行を入れて送信します。

<textarea name="example" cols="30" wrap="hard"></textarea>

• wrap="hard" を指定する場合は、cols属性の指定が必須となります。

form属性について

form属性は、そのフォーム部品をどのform要素に関連付けるかを指定します。この属性の値には、対応するform要素に指定したID名を記述します。

• この属性は、部品をform要素の外に配置する場合に使用します。（form要素の中に配置する場合は不要です）

<p>コメント：<textarea name="comment" form="example"></textarea></p>

<form method="post" action="example.cgi" id="example">
<p><input type="submit" value="送信する"></p>
</form>

• 古いブラウザでは、この機能に対応していない場合があります。
• form属性の使用例は、form要素のページでご覧になれます。

autocomplete属性について

autocomplete属性は、オートコンプリート機能（入力内容の自動補完）を有効にするかどうかを指定します。

値には on（有効にする）または off（無効にする）を指定します。この属性を省略した場合は、form要素の設定内容が使用されます。（form要素にも指定されていない場合は on の状態が適用されます）

<textarea name="example" autocomplete="off"></textarea>

• HTML 5.1以降では、フォーム部品のautocomplete属性に on / off 以外の値（詳細トークン）も指定できるようになりました（詳しくは仕様書をご覧ください）。これにより、詳細な設定を行うことができます。

placeholder属性について

placeholder属性は、入力の助けとなるような短いヒント（記入例やフォーマットの例など）を指定します。

対応しているブラウザでは、この値が入力欄に表示されます。（入力を開始すると消えます）

通信欄：<textarea name="message" placeholder="連絡事項等はこちらへ"></textarea>

次のように改行を入れることもできます。（この改行は入力欄に表示されるテキストにも反映されます）

通信欄：<textarea name="message" placeholder="連絡事項等はこちらへ
・納期
・ご予算
・その他" cols="50" rows="10"></textarea>

dirname属性について

dirname属性は、書字方向の送信に使う名前を指定します。

この値（名前）は、入力内容の書字方向（ltr または rtl）とセットで送信されることになります。（書字方向は自動的に判別されます）

<textarea name="comment" dirname="commentDir">Hello</textarea>

例えば、上記の内容を送信した場合、対応しているブラウザでは次のような形式で送られることになります。（ltr は自動的に付けられます）

comment=Hello&commentDir=ltr

readonly属性について

readonly属性は、そのフォーム部品が読み取り専用であることを指定します。

この属性が指定された部品は、書き換えだけができなくなります。選択することは可能で、データも送信されることになります。

<textarea name="example" readonly></textarea>

• この属性が指定されたフォーム部品は、妥当性のチェックから除外されます。

disabled属性について

disabled属性は、フォーム部品の無効化を指定します。

この属性が指定された部品は、選択や書き換えができなくなり、データも送信されなくなります。

<textarea name="example" disabled></textarea>

• この属性が指定されたフォーム部品は、妥当性のチェックから除外されます。

required属性について

required属性は、そのフォーム部品が入力必須であることを指定します。

<textarea name="example" required></textarea>