<textarea>【複数行入力コントロール (Multiline text field)】

概要 ( 改行 入力制御 )  構文 DOMインタフェース (HTMLTextAreaElement)

概要

メモ

例

<textarea cols="10" rows="4">テキスト
テキスト
テキスト</textarea>

CSS (一部)

スタイルスタイル定義備考
マウスカーソル変更cursor【マウスカーソル】 例：style="cursor:pointer"
フォーカス時のスタイル変更outline
IMEモード ime-mode【IMEモード】
値説明
auto自動 (変更なし)
activeON状態 (手動切替可)
inactiveOFF状態 (手動切替可)
disabled無効化
MS独自仕様：一部ブラウザサポート
参照：
inputmode【入力モード】属性
入力制御

DOM・Web API (一部)

処理プロパティ / メソッド備考
フォーカス取得イベントonfocus
フォーカス喪失イベントonblur
変更イベントonchange即時 あるいは フォーカス喪失時
入力不正イベントoninvalidrequired【入力必須】 チェック
要素取得document.getElementById(【id】)HTMLTextAreaElement
テキスト 取得・設定value
無効化 取得・設定disabled (true / false)複数のコントロールを操作する場合は、fieldset利用
スタイル 取得・設定style.～color・backgroundColor 等

関連要素

外部リンク

構文

<textarea必須開始タグ
autocomplete=off | onオートコンプリート機能の有効・無効 (入力候補表示)
autofocus
ページロード時、自動フォーカス
※：グローバル属性の autofocus 参照
cols=【文字幅】文字幅 (半角文字数)
dirname=【フィールド名】要素方向(ltr・rtl)のフィールド名 (このフィールド名で要素方向を送信)
disabledコントロール無効化
form=【form要素id】関連付けform要素id属性 (コントロールをform要素外に定義可能)
inputmode=【入力モード】
入力モード (実装依存)
※：グローバル属性の inputmode【入力モード】 参照
maxlength=【最大入力文字数】最大入力文字数
minlength=【最小入力文字数】最小入力文字数
name=【コントロール名】コントロール名 (送信データ名) id との重複は不可
placeholder=【表示文字列】ウォーターマーク (未入力時の表示文字列)
readonly読み取り専用
required入力必須
rows=【表示行数】表示行数
wrap=soft | hard送信時の自動改行有無 (soft：折り返しで改行挿入なし | hard：折り返しで改行挿入あり)

【グローバル属性】

accesskey=【アクセスキー (複数：半角スペース区切り )】アクセスキー
autocapitalize=【変換方法】自動大文字化
"characters"全て大文字
"on"
"sentences"		各文の最初を大文字
"off"
"none"		変換なし
"words"各単語の最初を大文字
autofocusページロード時、自動フォーカス
※：<button>【ボタン】・<input>【汎用入力コントロール】・<textarea>【複数行入力コントロール】・<select>【選択リスト】はW3C定義の同名個別属性も参照
class=【クラス名 (複数：半角スペース区切り)】所属クラス (複数指定：<style>【スタイル情報】)・外部スタイルシートで後の定義が優先
contenteditable [ ="" (可能) | true (可能) | false (不可) | inherit (親要素継承) ]編集可否
contextmenu=<menu>【メニュー】 のid
コンテキストメニューのid
data-*=【カスタムデータ】カスタムデータ属性
dir=ltr (左から右) | rtl (右から左) | auto (自動)文字表記方向 (ltr：left to right text or table / rtl：right to left text or table)
※<bdo>【テキスト方向形式】の場合、ltr または rtlが必須
draggable=true (ドラッグ可能) | false (ドラッグ不可) | auto (ブラウザ既定)ドラッグ可否
dropzone=copy (ドロップデータのコピー) | move (ドロップデータを移動) | link (ドロップデータのリンク)
ドロップデータの扱い
enterkeyhint=【ヒント】[Enter]キーのアクション ヒント (対応するラベル・アイコン等を表示)
"done"入力完了
"enter"改行挿入
"go"ターゲット移動
"next"次フィールド移動
"previous"前フィールド移動
"search"検索結果移動
"send"送信
hidden非表示
id=【id】id (ドキュメント中で一意 name【コントロール名 (送信データ名)】を含む)
スペース文字 (SP：U+0020・tab：U+0009・LF：U+000A・FF：U+000C・CR：U+000D) 以外の全ての文字が使用可能 (大文字小文字の区別あり)
(<a>【ハイパーリンク】のリンク先・CSS対象(#～)・スクリプト参照)
inputmode=【入力モード】入力モード (参照：CSS ime-mode【IMEモード】)
※：<input>【汎用入力コントロール】・<textarea>【複数行入力コントロール】はW3C定義の同名個別属性も参照
"decimal"小数数値入力 (フォーマット区切り文字表示)
"email"Eメールアドレス入力 (補助入力：'@'・'.' 等)
"none"未指定
"numeric"数値入力
"search"検索入力
"tel"電話番号入力 ('0'〜'9'・'#'・'*'・ロケールにより対応アルファベット)
"text"テキスト入力
"url"URL入力 (補助入力：'/'・'.'・'www.'・'.com' 等)
is=【定義名】定義名
itemid=【URL】アイテムのグローバル識別子
itemprop=【アイテムのプロパティ (複数：半角スペース区切り)】アイテムのプロパティ
itemref=【要素IDのリスト】アイテムの参照リスト
itemscopeアイテムのプロパティ宣言
itemtype=【アイテムの型 (複数：半角スペース区切り)】アイテムの型
lang=【言語コード】言語コード (【主コード】-【副コード】 例："ja"：日本語 / "en"：英語 / "en-US"：アメリカ英語)
nonce=【ワンタイム トークン (文字列)】CSP(コンテンツ セキュリティ ポリシー)のチェックで使用されるワンタイム トークン(nonce：number used once)
※：<link>【メタデータリンク】・<script>【スクリプト】・<style>【スタイル情報】はW3C定義の同名個別属性も参照
slot=【スロット名】スロット (<slot>【スロット】の name属性に対応)
spellcheck=true | falseスペルチェック有無
style=【スタイルシート (複数：セミコロン区切り / 最後のセミコロンは省略可)】スタイル
tabindex=【タブインデックス番号】タブインデックス
title=【説明文】説明 (多くはツールチップ表示)
※<link>【メタデータリンク】：メタデータリンクのタイトル
※<style>【スタイル情報】：スタイルシート名
translate="" (翻訳対象) | yes (翻訳対象) | no (翻訳対象外)翻訳可否
>

【対象テキスト】

</textarea>必須終了タグ

DOMインタフェース (HTMLTextAreaElement : HTMLElement)

interface HTMLTextAreaElement : HTMLElement

interface HTMLElement : Element
HTMLElement includes GlobalEventHandlers
HTMLElement includes DocumentAndElementEventHandlers
HTMLElement includes ElementContentEditable
HTMLElement includes HTMLOrSVGElement

interface Element : Node
Element includes ParentNode
Element includes NonDocumentTypeChildNode
Element includes ChildNode
Element includes Slottable

HTMLTextAreaElement
interface HTMLTextAreaElement : HTMLElement

DOMStringautocomplete入力自動補完の有無
booleanautofocusページロード時、自動フォーカス
unsigned longcols文字幅 (半角文字数)
DOMStringdefaultValue初期値
DOMStringdirName要素方向(ltr・rtl)のフィールド名
booleandisabled無効化
HTMLFormElement?form <form>【フォーム】 エレメント
NodeListlabels 関連付け<label>【ラベル】エレメント リスト  (NodeList (英語))
longmaxLength最大入力文字数
longminLength最小入力文字数
DOMStringnameコントロール名
DOMStringplaceholderウォーターマーク (未入力時の表示文字列)
booleanreadonly読み取り専用
booleanrequired入力必須
unsigned longrows表示行数
DOMStringselectionDirection選択方向 ("forward" / "backward" / "none")
unsigned longselectionEnd選択終了位置
unsigned longselectionStart選択開始位置
unsigned longtextLengthテキスト長
DOMStringtypeタイプ ("textarea")
DOMStringvalidationMessage妥当性チェックNG時メッセージ
ValidityStatevalidity 妥当性状態

interface ValidityState

booleanvalueMissing未入力
booleantypeMismatchタイプ不正
booleanpatternMismatchパターン不正
booleantooLongデータ長超過
booleantooShortデータ長不足
booleanrangeUnderflowアンダーフロー
booleanrangeOverflowオーバーフロー
booleanstepMismatchステップ不正
booleanbadInput不正入力
booleancustomErrorカスタムエラー
booleanvalid有効
DOMStringvalue値
booleanwillValidate妥当性チェック対象
DOMStringwrap送信時の自動改行有無
boolean checkValidity()妥当性チェック
boolean reportValidity()妥当性レポート
undefined select()
undefined setCustomValidity(DOMString error)妥当性エラーメッセージ設定
undefined setRangeText(DOMString replacement)
undefined setRangeText (DOMString replacement, unsigned long start, unsigned long end, optional SelectionMode selectionMode = "preserve")
undefined setSelectionRange (unsigned long start, unsigned long end, optional DOMString direction)選択

HTMLElement
interface HTMLElement : Element
HTMLElement includes ElementContentEditable
HTMLElement includes HTMLOrSVGElement
HTMLElement includes GlobalEventHandlers
HTMLElement includes DocumentAndElementEventHandlers
HTMLElement includes ElementCSSInlineStyle〔CSSOM〕

DOMStringaccessKeyアクセスキー
DOMStringautocapitalize自動大文字化
DOMStringaccessKeyLabelアクセスキー表現文字列
DOMStringcontentEditable編集可能状態 ("true"：編集可能 / "false"：編集不可 / "inherit"：親要素継承) ( ElementContentEditable に移動 )
DOMStringMapdatasetカスタムデータ属性 (data-*) マップ ( HTMLOrSVGElement に移動 )
DOMStringdir文字表記方向 ("ltr"：左から右 / "rtl"：右から左)
booleandraggableドラッグ可否
[PutForwards=value] DOMTokenListdropzoneドロップデータの扱い
booleanhidden非表示状態
[LegacyNullToEmptyString]DOMStringinnerText要素内容 (テキスト形式)
booleanisContentEditable編集可否 ( ElementContentEditable に移動 )
DOMStringlang言語コード
[LegacyNullToEmptyString]DOMStringouterTextタグを含む要素内容 (テキスト形式)
booleanspellcheckスペルチェック有無
longtabIndexタブインデックス ( HTMLOrSVGElement に移動 )
DOMStringtitle説明
booleantranslate翻訳可否
ElementInternals attachInternals()
undefined blur()フォーカス喪失 操作 ( HTMLOrSVGElement に移動 )
undefined click()クリック 操作
undefined focus()フォーカス設定 操作 ( HTMLOrSVGElement に移動 )
undefined forceSpellCheck()スペルチェック

ElementContentEditable
interface mixin ElementContentEditable

DOMStringcontentEditable編集可能状態
DOMStringenterKeyHint[Enter]キーのアクション ヒント
DOMStringinputMode入力モード
booleanisContentEditable編集可否

HTMLOrSVGElement
interface mixin HTMLOrSVGElement

booleanautofocusページロード時、自動フォーカス
DOMStringMapdatasetカスタムデータ属性 (data-*) マップ
DOMStringnonceワンタイム トークン
longtabIndexタブインデックス
undefined focus(optional FocusOptions options = {})フォーカス設定 操作
undefined blur()フォーカス喪失 操作

GlobalEventHandlers
interface mixin GlobalEventHandlers

EventHandleron～各種イベントハンドラ (onclick・onfocus 等)

DocumentAndElementEventHandlers
interface mixin DocumentAndElementEventHandlers

EventHandleroncopyコピー イベントハンドラ
EventHandleroncutカット イベントハンドラ
EventHandleronpasteペースト イベントハンドラ

ElementCSSInlineStyle【CSSOM定義】
interface mixin ElementCSSInlineStyle

CSSStyleDeclarationstyleスタイル

CSSStyleDeclaration
interface CSSStyleDeclaration

DOMStringstyle.～スタイル属性 (CSS2Properties)
(例：style.color・style.backgroundColor)

Element
interface Element : Node
Element includes ParentNode
Element includes NonDocumentTypeChildNode
Element includes ChildNode
Element includes Slottable

[SameObject] NamedNodeMapattributes関連属性 マップ
[SameObject] DOMTokenListclassListクラス名 リスト
DOMStringclassNameクラス名
DOMStringidid (ページ内で一意：name【コントロール(送信)名】を含む)
(DOMStringinnerHTML)要素内容 (HTML形式)〔 DOM Parsing and Serialization 定義 〕
DOMStringlocalNameローカル名
DOMString?namespaceURIネームスペースURI
(DOMStringouterHTML)タグを含む要素内容 (HTML形式)〔 DOM Parsing and Serialization 定義 〕
DOMString?prefixプレフィックス
DOMStringtagNameタグ名
ShadowRoot attachShadow(ShadowRootInit init)
Element? closest(DOMString selectors)
DOMString? getAttribute(DOMString qualifiedName)属性取得
DOMString? getAttributeNS(DOMString? namespace, DOMString localName)属性取得 (ネームスペース指定)
sequence<DOMString> getAttributeNames()
Attr? getAttributeNode(DOMString qualifiedName)
Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName)
HTMLCollection getElementsByClassName(DOMString classNames)エレメント コレクション取得 (クラス名指定)
HTMLCollection getElementsByTagName(DOMString qualifiedName)エレメント コレクション取得 (タグ名指定)
HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName)エレメント コレクション取得 (ネームスペース・タグ名指定)
boolean hasAttribute(DOMString qualifiedName)属性チェック
boolean hasAttributeNS(DOMString? namespace, DOMString localName)属性チェック (ネームスペース指定)
boolean hasAttributes()
Element? insertAdjacentElement(DOMString where, Element element)
undefined insertAdjacentText(DOMString where, DOMString data)
boolean matches(DOMString selectors)
undefined removeAttribute(DOMString qualifiedName)属性削除
undefined removeAttributeNS(DOMString? namespace, DOMString localName)属性削除 (ネームスペース指定)
Attr removeAttributeNode(Attr attr)
undefined setAttribute(DOMString qualifiedName, DOMString value)属性設定
undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value)属性設定 (ネームスペース指定)
Attr? setAttributeNode(Attr attr)
Attr? setAttributeNodeNS(Attr attr)
boolean toggleAttribute(DOMString qualifiedName, optional boolean force)
boolean webkitMatchesSelector(DOMString selectors)matches のエイリアス

ParentNode
interface mixin ParentNode

unsigned longchildElementCount子エレメントの数
[SameObject] HTMLCollectionchildren子エレメント コレクション
Element?firstElementChild最初の子エレメント
Element?lastElementChild最後の子エレメント
undefined append((Node or DOMString)... nodes)
undefined prepend((Node or DOMString)... nodes)
Element? querySelector(DOMString selectors)指定セレクタ先頭エレメント取得
[NewObject] NodeList querySelectorAll(DOMString selectors)指定セレクタ ノードリスト取得

ChildNode
interface mixin ChildNode

undefined after((Node or DOMString)... nodes)
undefined before((Node or DOMString)... nodes)
undefined remove()削除
undefined replaceWith((Node or DOMString)... nodes)

NonDocumentTypeChildNode
interface mixin NonDocumentTypeChildNode

Element?previousElementSibling前の兄弟エレメント
Element?nextElementSibling次の兄弟エレメント

Slottable
interface mixin Slottable

HTMLSlotElement?assignedSlot

Node
interface Node : EventTarget

USVStringbaseURIベースURI
[SameObject] NodeListchildNodes子ノード リスト
Node?firstChild先頭子ノード
booleanisConnected
Node?lastChild最終子ノード
Node?nextSibling次の兄弟ノード
DOMStringnodeNameノード名
unsigned shortnodeTypeノードタイプ
(ELEMENT_NODE / ATTRIBUTE_NODE / TEXT_NODE / CDATA_SECTION_NODE / ENTITY_REFERENCE_NODE / ENTITY_NODE / PROCESSING_INSTRUCTION_NODE / COMMENT_NODE / DOCUMENT_NODE / DOCUMENT_TYPE_NODE / DOCUMENT_FRAGMENT_NODE / NOTATION_NODE)
DOMString?nodeValueノード値
Document?ownerDocumentオーナードキュメント
Element?parentElement親エレメント
Node?parentNode親ノード
Node?previousSibling前の兄弟ノード
DOMString?textContent
(IE：innerText)		内容 (Text形式) (参照：Element.innerHTML・Element.outerHTML)
取得：要素内のHTMLタグを除外しテキストのみ
設定：HTMLタグはテキスト変換
Node appendChild(Node node)子ノード追加
[NewObject] Node cloneNode(optional boolean deep = false)クローンノード作成
unsigned short compareDocumentPosition(Node other)他ノードとの位置比較
(DOCUMENT_POSITION_DISCONNECTED / DOCUMENT_POSITION_PRECEDING / DOCUMENT_POSITION_FOLLOWING / DOCUMENT_POSITION_CONTAINS / DOCUMENT_POSITION_CONTAINED_BY / DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC)
boolean contains(Node? other)指定子孫ノードの存在有無
Node getRootNode(optional GetRootNodeOptions options = {})
boolean hasChildNodes()子ノードの存在有無
Node insertBefore(Node node, Node? child)指定ノード前挿入
boolean isDefaultNamespace(DOMString? namespace)デフォルトネームスペース チェック
boolean isEqualNode(Node? node)同一ノードチェック
boolean isSameNode(Node? otherNode)
DOMString? lookupNamespaceURI(DOMString? prefix)ネームスペースURI調査
DOMString? lookupPrefix(DOMString? namespace)ネームスペース プレフィックス調査
undefined normalize()標準化
Node removeChild(Node child)子ノード削除
Node replaceChild(Node node, Node child)子ノード置換

EventTarget
interface EventTarget

undefined addEventListener(DOMString type, EventListener? callback, optional (AddEventListenerOptions or boolean) options = {})
boolean dispatchEvent(Event event)
undefined removeEventListener(DOMString type, EventListener? callback, optional (EventListenerOptions or boolean) options = {})