<textarea>要素

Technical Summary

意味・category・content model

ページの本文を編集するリッチテキスト領域とは異なり、textareaが扱うのはplain textです。表示上の行の折り返しと、フォーム送信時の値に追加される改行は同じとは限りません。

初期値・raw value・現在値

要素の内容はdefault valueです。ユーザーが入力するとraw valueが変わり、現在のAPI valueはtextarea.valueで取得します。textareaにはinputのような初期値用のvalue content attributeはありません。

<textarea id="note" name="note" rows="3">HTMLに書いた初期値</textarea>

<script>
  const note = document.querySelector('#note');
  note.value;        // 現在値
  note.defaultValue; // リセット時の基準値
</script>

ユーザー操作で値が変更されるとdirty value flagが立ちます。dirty value flagが立った後は、子テキストをDOMから変更しても現在値が同じように更新されるとは限りません。フォームリセットでは、dirty value flagが戻り、子テキストを基準に値が再設定されます。

編集可能性・readonly・disabled

textareaは、disabledでもreadonlyでもない場合にmutableです。mutableなとき、ユーザーエージェントは文字やLFの改行を編集できるようにします。

readonlyとdisabledは見た目を変えるための同義語ではありません。編集の可否、検証への参加、送信対象かどうかを別々に確認します。

主なcontent attributes

改行の正規化とwrap

textareaの値には、目的に応じて3つの見方があります。raw valueは正規化されませんが、API valueでは改行がLF（U+000A）に正規化されます。フォーム送信で使われるvalueには、wrap="hard"の条件に応じて折り返し改行が追加されます。

wrapの状態	表示上の折り返し	送信値
soft（既定）	表示上は折り返されうる	表示上の折り返しだけでは改行を追加しない
hard	colsを基準に折り返されうる	ユーザーエージェントが折り返し改行を追加する

このため、画面で見えている行数と送信された文字列の改行位置を同一視できません。サーバー側で改行を処理する場合は、実際に受け取った値とwrapの条件を確認します。

フォーム送信と制約検証

textareaはform-associatedなsubmittable elementです。form ownerがあり、disabledでなく、送信に必要なnameなどの条件を満たす場合、textareaのform valueがentry listに関係します。

<form action="/messages" method="post">
  <label for="body">本文</label>
  <textarea id="body" name="body" required minlength="10"></textarea>
  <button type="submit">送信</button>
</form>

requiredが指定され、textareaがmutableで、valueが空ならconstraint validationでmissingになります。minlengthとmaxlengthは値の長さ、readonlyやdisabledは検証参加の可否に影響します。ブラウザーの検証はサーバー側検証の代替ではありません。

DOM Interface

textarea要素はHTMLTextAreaElementとして公開されます。

ユーザーによるraw valueの変更ではinputイベントが発生します。イベント処理で値を読む場合も、raw value、API value、送信時のvalueの境界を目的に応じて確認します。

Fact / Evidence（主張 / 根拠）

主要Factを、適用条件・確認状態・仕様上の根拠位置と対応付けています。ブラウザー実装やアクセシビリティツリーの観測は、仕様上の主張とは別に下のImplementation Evidenceへ分けています。

Evidence

1. HTML Standard: The textarea element — 意味、category、content model、属性、値、リセット、DOM interface
2. HTML Standard: Form control infrastructure — form owner、disabled、constraint validation、フォーム送信共通基盤
3. HTML Accessibility API Mappings: textarea — textbox role、multiline state、accessible nameと状態のmapping
4. WPT: textarea element tests — textareaの値、属性、フォーム連携に関係するテスト群
5. WPT: input events and textarea editing — 編集操作とinput eventに関係するテスト例

Implementation Evidence

仕様上の主張とは別に、ブラウザー実装・WPT・アクセシビリティ観測を記録します。未実施の項目は確認済みとは扱いません。

実測fixture / 環境: <form id="evidence-form" method="get">内に、初期値付きtextarea、空のrequired textarea、minlength・maxlength、readonly、disabled、wrap="hard"、外部form owner、reset buttonを配置しました。Chrome 152.0.0.0（HeadlessChrome / Windows NT 10.0）で2026-09-13にDOM・ValidityState・FormDataを実測しています。

WPTの対応付けにはWPT repository、アクセシビリティの基準にはHTML-AAMを参照します。

Coverage / Open Issues

• 確認済みtextareaの意味、category、content model、初期値・現在値・defaultValue、主要属性、HTMLTextAreaElement APIの概要
• 確認済みrequired、minlength、maxlength、readonly、disabled、form owner、フォーム送信の主要な境界
• 確認済みraw value・API value・form value、LF正規化、wrapの基本的な関係
• 未完了form submission algorithm、entry list、dirname、encoding、formdata eventの全分岐
• 未完了wrap="hard"の折り返しアルゴリズム、改行・Unicode・文字数の実装差
• 未完了実装Evidence、複数ブラウザー、WPT実行、HTML-AAM全mapping、支援技術観測、互換性、歴史的変更、Expert-gap Review

このページは初期Coverageです。確認済みの範囲を示すものであり、textarea要素全体の検証完了、すべてのブラウザーで同じ値や表示になること、または支援技術で同じ結果になることを主張しません。

Related surface

初心者向けの複数行入力、label、初期値、フォーム送信はYugienのtextarea要素ページを参照してください。フォーム送信の共通処理はAtlasのform要素、labelとの関連付けはAtlasのlabel要素、他のフォームコントロールとの境界はinput要素、select要素、button要素でも確認できます。