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

目次: 概要 構文 DOMインタフェース

概要

メモ

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

CSS (一部)

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

DOM・Web API (一部)

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

関連要素

外部リンク

構文

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

【グローバル属性】

accesskey=【アクセスキー (複数:半角スペース区切り)】アクセスキー
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 (ドロップデータのリンク)
ドロップデータの扱い
hidden非表示
id=【id】id (ドキュメント中で一意 name【コントロール名 (送信データ名)】を含む)
(<a>【ハイパーリンク】のリンク先・CSS対象(#~)・スクリプト参照)
is=【定義名】定義名
itemid=【URL】アイテムのグローバル識別子
itemprop=【アイテムのプロパティ (複数:半角スペース区切り)】 アイテムのプロパティ
itemref=【要素IDのリスト】アイテムの参照リスト
itemscopeアイテムのプロパティ宣言
itemtype=【アイテムの型 (複数:半角スペース区切り)】アイテムの型
lang=【言語コード】言語コード (【主コード】-【副コード】 例:"ja":日本語 / "en":英語 / "en-US":アメリカ英語)
slot=<slot>【スロット】のname属性スロット名
spellcheck=true | falseスペルチェック有無
style=【スタイルシート (複数:セミコロン区切り / 最後のセミコロンは省略可)】スタイル
tabindex=【タブインデックス番号】タブインデックス
title=【説明文】説明 (多くはツールチップ表示)
<link>【メタデータリンク】:メタデータリンクのタイトル
<style>【スタイル情報】:スタイルシート名
translate="" (翻訳対象) | yes (翻訳対象) | no (翻訳対象外)翻訳可否
>

【対象テキスト】

</textarea>必須終了タグ

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

interface HTMLTextAreaElement : HTMLElement { W3C:interface HTMLTextAreaElement (英語)

【プロパティ】

HTMLTextAreaElement プロパティ】

autocomplete;オートコンプリート機能の有効・無効
autofocus;ページロード時、自動フォーカス
attribute unsigned longcols;文字幅 (半角文字数)
defaultValue;初期値
dirName;要素方向(ltr・rtl)のフィールド名
disabled;無効化
attribute HTMLFormElement?form; <form>【フォーム】 エレメント
labels; 関連付け<label>【ラベル】エレメント リスト  (W3c:NodeList (英語))
attribute longmaxLength;最大入力文字数
attribute longminLength;最小入力文字数
name;コントロール名
placeholder;ウォーターマーク (未入力時の表示文字列)
;読み取り専用
required;入力必須
attribute unsigned longrows;表示行数
selectionDirection;選択方向 ("forward" / "backward" / "none")
attribute unsigned longselectionEnd;選択終了位置
attribute unsigned longselectionStart;選択開始位置
attribute unsigned longtextLength;テキスト長
type;タイプ ("textarea")
validationMessage;妥当性チェックNG時メッセージ
attribute ValidityStatevalidity; 妥当性状態
interface ValidityState {
valueMissing;未入力
typeMismatch;タイプ不正
patternMismatch;パターン不正
tooLong;データ長超過
tooShort;データ長不足
rangeUnderflow;アンダーフロー
rangeOverflow;オーバーフロー
stepMismatch;ステップ不正
badInput;不正入力
customError;カスタムエラー
valid;有効
};
[TreatNullAs=EmptyString] value;
willValidate;妥当性チェック対象
wrap;送信時の自動改行有無

HTMLElement プロパティ】W3C:interface HTMLElement (英語) HTML 5.1HTML 5.2WHATWG

accessKey;アクセスキー
accessKeyLabel;アクセスキー表現文字列
contentEditable;編集可能状態 ("true":編集可能 / "false":編集不可 / "inherit":親要素継承)
Mapdataset;カスタムデータ属性 (data-*) マップ
dir;文字表記方向 ("ltr":左から右 / "rtl":右から左)
draggable;ドラッグ可否
[PutForwards=value] attribute DOMTokenListdropzone;ドロップデータの扱い
hidden;非表示状態
[TreatNullAs=EmptyString]innerText;内容 (テキスト形式)
isContentEditable;編集可否
lang;言語コード
spellcheck;スペルチェック有無
attribute longtabIndex;タブインデックス
title;説明
translate;翻訳可否

ElementCSSInlineStyle プロパティ】 HTMLElement implements ElementCSSInlineStyle; W3C:interface ElementCSSInlineStyle (英語)

attribute CSSStyleDeclarationstyle;スタイル

CSSStyleDeclaration プロパティ】 (仕様上、次と同等: CSSStyleDeclaration implements CSS2Properties) W3C:Interface CSS2Properties (英語)

style.~;スタイル属性 (例:style.color・style.backgroundColor)

Element プロパティ】interface HTMLElement : Element W3C:Interface Element (英語) HTML 5.1HTML 5.2WHATWG

[SameObject] attribute NamedNodeMapattributes;関連属性 マップ
[SameObject] attribute DOMTokenListclassList;クラス名 リスト
className;クラス名
id;id (ページ内で一意:name【コントロール(送信)名】を含む)
(innerHTML;)内容 (HTML形式) W3C:未定義 (参照:Element.outerHTMLNode.textContent (innerText))
localName;ローカル名
?namespaceURI;ネームスペースURI
(outerHTML;)タグを含む内容 (HTML形式) W3C:未定義 (参照:Element.innerHTMLNode.textContent (innerText))
?prefix;プリフィックス
tagName;タグ名

Node プロパティ】 interface Element : Node W3C:Interface Node (英語) HTML 5.1HTML 5.2WHATWG

?baseURI;ベースURI
[SameObject] childNodes;子ノード リスト
?firstChild;先頭子ノード
?lastChild;最終子ノード
?nextSibling;次の兄弟ノード
nodeName;ノード名
attribute 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)
?nodeValue;ノード値
?ownerDocument;オーナードキュメント
?parentElement;親エレメント
?parentNode;親ノード
?previousSibling;前の兄弟ノード
?textContent;
(IE:innerText)
内容 (Text形式) (参照:Element.innerHTMLElement.outerHTML)
取得:要素内のHTMLタグを除外しテキストのみ
設定:HTMLタグはテキスト変換

GlobalEventHandlers プロパティ (一部) 】 HTMLElement implements GlobalEventHandlers; W3C:interface GlobalEventHandlers (英語) HTML 5.1HTML 5.2WHATWG

attribute EventHandler onabort;on~;イベントハンドラ (例:onclick・onfocus)

ParentNode プロパティ】Element implements ParentNode; W3C:Interface ParentNode (英語)

attribute unsigned longchildElementCount;子エレメントの数
[SameObject] attribute HTMLCollectionchildren;子エレメント コレクション
?firstElementChild;最初の子エレメント
?lastElementChild;最後の子エレメント

NonDocumentTypeChildNode プロパティ】Element implements NonDocumentTypeChildNode; W3C:Interface NonDocumentTypeChildNode (英語)

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

【メソッド】

HTMLTextAreaElement メソッド】

boolean checkValidity();妥当性チェック
void select();
void setCustomValidity( error);妥当性エラーメッセージ設定
void setRangeText( replacement);
void setRangeText( replacement, unsigned long start, unsigned long end, optional SelectionMode selectionMode = "preserve");
void setSelectionRange(unsigned long start, unsigned long end, optional direction);選択

HTMLElement メソッド】W3C:interface HTMLElement (英語) HTML 5.1HTML 5.2WHATWG

void click();クリック 操作
void focus();フォーカス設定 操作
void forceSpellCheck();スペルチェック
void blur();フォーカス喪失 操作

Element メソッド】interface HTMLElement : Element W3C:Interface Element (英語)

? getAttribute( name);属性取得
? getAttributeNS(? namespace, localName);属性取得 (ネームスペース指定)
HTMLCollection getElementsByClassName( classNames);エレメント コレクション取得 (クラス名指定)
HTMLCollection getElementsByTagName( localName);エレメント コレクション取得 (タグ名指定)
HTMLCollection getElementsByTagNameNS(? namespace, localName);エレメント コレクション取得 (ネームスペース・タグ名指定)
boolean hasAttribute( name);属性チェック
boolean hasAttributeNS(? namespace, localName);属性チェック (ネームスペース指定)
void removeAttribute( name);属性削除
void removeAttributeNS(? namespace, localName);属性削除 (ネームスペース指定)
void setAttribute( name, value);属性設定
void setAttributeNS(? namespace, name, value);属性設定 (ネームスペース指定)

Node メソッド】 interface Element : Node W3C:Interface Node (英語)

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);指定子孫ノードの存在有無
boolean hasChildNodes();子ノードの存在有無
Node insertBefore(Node node, Node? child);指定ノード前挿入
boolean isDefaultNamespace(? namespace);デフォルトネームスペース チェック
boolean isEqualNode(Node? node);同一ノードチェック
? lookupNamespaceURI(? prefix);ネームスペースURI調査
? lookupPrefix(? namespace);ネームスペース プリフィックス調査
void normalize();標準化
Node removeChild(Node child);子ノード削除
Node replaceChild(Node node, Node child);子ノード置換

ParentNode メソッド】Element implements ParentNode; W3C:Interface ParentNode (英語)

Element? querySelector( selectors);指定セレクタ先頭エレメント取得
[NewObject] NodeList querySelectorAll( selectors);指定セレクタ ノードリスト取得

ChildNode メソッド】Element implements ChildNode; W3C:Interface ChildNode (英語)

void remove();削除
};