<label>【ラベル (Caption for a form control / HTML 4.01:form field label text)】

概要 構文 DOMインタフェース (HTMLLabelElement)

概要

メモ

  • ラベルの定義
  • コントロールと関連付け可能
  • コントロールの関連付け方法
    • コントロールを<label>で囲む
    • for属性でコントロールを指定 (離れていても可能)
  • JavaScript 参照 (例 参照)
    • document.getElementById(~).innerHTML (タグ有効)
      document.getElementById(~).textContent (テキストのみ)

<label>テキストボックスのラベル<input type="text"></label><br>
<label><input type="checkbox">チェックボックスのラベル</label><br>
<label><input type="radio" name="radio" checked>ラジオボタンスのラベル A</label>
<label><input type="radio" name="radio">ラジオボタンスのラベル B</label>



<label for="checkbox2">2行下のチェックボックスのラベル (for属性)</label><br>
<input><br>
<input id="checkbox2" type="checkbox"><label>ラベル (関連付けなし)</label>



<script>
function funcCopy() {
  var text = document.getElementById("input3").value;
  document.getElementById("label3").textContent = text;
}
</script>

<input id="input3" value="入力データ">
<button type="button" onclick="funcCopy();">入力値をコピー</button>
<label id="label3" style="border:1px black solid; padding:1px 5px;">label</label>

関連DOM・Web API

処理プロパティ / メソッド備考
要素取得document.getElementById(【id】)HTMLLabelElement
ラベル 取得・設定innerHTML要素内のHTMLタグを有効として取得・設定
textContent要素内のHTMLタグを除いてテキストのみ取得、HTMLタグはテキストとして設定
innerText同上 (Windows版 Firefox 42.0 未サポート)
スタイル 取得・設定style.~color・backgroundColor 等

構文

<label必須開始タグ
for=【コントロール要素id】関連付けコントロール要素id属性
form=【form要素id】
関連付けform要素id属性 (コントロールをform要素外に定義可能)

【グローバル属性】

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 (翻訳対象外)翻訳可否
>

【ラベル】

</label>必須終了タグ

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

interface HTMLLabelElement : 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

HTMLLabelElement
interface HTMLLabelElement : HTMLElement

HTMLElement?control関連付けコントロール エレメント
HTMLFormElement?form; <form>【フォーム】 エレメント
DOMStringhtmlFor関連付けコントロール id

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

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.innerHTMLElement.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 = {})