<link>【メタデータリンク (Link metadata)】

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

概要

メモ

  • メタデータリンクの定義
    • 用途:rel属性 参照 (一部抜粋)
      rel属性備考
      "icon"
      ("shortcut icon")
      アイコン〔
      "apple-touch-icon"
      (拡張定義)
      モバイル端末アイコン (主にApple製デバイス)
      "stylesheet" 外部スタイルシート (一部ブラウザでユーザ切替可能)〔
      "canonical" SEO 優先URL (重複コンテンツ回避)〔
      (使用例:wwwの有無・色違いの同一商品ページ・クエリパラメータの有無)

【アイコン】
<link rel="icon" type="image/vnd.microsoft.icon" href="~.ico">

このページで外部スタイルシート切替に対応 (一部ブラウザで切替可能)

【外部スタイルシート】
<link rel="stylesheet" type="text/css" href="~.css">

【外部スタイルシート切替】
切替操作:[メニュー]-[表示]-[スタイル(シート)] (一部未サポート):
(内部スタイルシート切替は、<style>【スタイル情報】参照)

<link rel="stylesheet" type="text/css" href="sample-bg-white.css" title="外部スタイルシート (背景色:白)">

<link rel="stylesheet" type="text/css" href="sample-bg-gray.css" title="外部スタイルシート (背景色:グレイ)">
<link rel="canonical" href="~">

構文

<link必須開始タグ
as=【プリロード要求の宛先】プリロード要求の宛先 (rel="preload"・rel="modulepreload" で利用)
charset=【リンク先文字コード】リンク先文字コード
color=【色 (CSSの色)】アイコンのカスタマイズ色 (rel="mask-icon" で利用)
crossorigin=anonymous | use-credentialsCORS(Cross-Origin Resource Sharing) 指定 (anonymous:認証情報未使用 | use-credentials:認証情報使用)
disabledリンクの無効化
href=【リソースの URL】リソースの URL
hreflang=【リソースの言語】リソースの言語
imagesizes=【画像サイズ】画像サイズ (rel="preload" で利用)
imagesrcset=【画像ファイルのセット】画像ファイルのセット (rel="preload" で利用)
integrity=【整合性メタデータ】SRI(サブリソース整合性)チェックで使用される整合性メタデータ
media=【メディアクエリ】メディア
nonce=【ワンタイム トークン (文字列)】
CSP(コンテンツ セキュリティ ポリシー)チェックで使用される ワンタイム トークン (nonce:number used once)
グローバル属性に移動
referrerpolicy=【リファラー ポリシー】 リファラー ポリシー (W3C:Referrer Policy (英語))
参照元情報の送信
"" (空文字列)上位ポリシー利用
"no-referrer"送信なし
"no-referrer-when-downgrade"セキュリティレベルが低下(TLS 保護:あり → なし):送信なし
その他:送信あり
"origin"オリジンのみ送信
"origin-when-cross-origin"クロスオリジン:オリジンのみ送信
その他:送信あり
"same-origin"同一オリジンへ移動:送信あり
その他:送信なし
"strict-origin"セキュリティレベルが低下(TLS 保護:あり → なし):送信なし
その他:オリジンのみ送信
"strict-origin-when-cross-origin"セキュリティレベルが上昇(TLS 保護:なし → あり):オリジンのみ送信
セキュリティレベルが低下(TLS 保護:あり → なし):送信なし
その他:送信あり
"unsafe-url"送信あり (安全でない)
rel=【リンク先の関係 (複数:半角スペース区切り)】 リンク先の関係 (大文字・小文字の区別なし)
定義 (Link types)機能備考
alternateハイパーリンク代替文書
authorハイパーリンク作成者
bookmarkハイパーリンクブックマーク
canonicalハイパーリンク優先URL (重複コンテンツ回避)
href:正規化された絶対URL
dns-prefetch 外部リソースDNS プリフェッチ
external 付記外部サイト
helpハイパーリンクヘルプ
icon
('shortcut icon')
外部リソースアイコン
license
(互換性:copyright)
ハイパーリンクライセンス
manifest 外部リソースアプリケーション マニフェスト
modulepreload 外部リソースモジュール プリロード
nextハイパーリンク次の文書
nofollow付記非承認ドキュメント (不適切なページ等)
noopener 付記トップレベル ブラウジングコンテキスト作成
(オープナー無効化:リンク先はリンク元のアクセス不可)
noreferrer付記HTTP Refer(r)er ヘッダの送信なし (参照元情報の漏洩防止)
opener 付記補助ブラウジングコンテキスト作成
(target="_blank" の場合)
pingback 外部リソースピンバック サーバのアドレス
preconnect 外部リソース先行接続
prefetch 外部リソース先行キャッシュ
preload 外部リソースプリロード
prerender 外部リソース高速応答
prev
(互換性:previous)
ハイパーリンク前の文書
searchハイパーリンク検索
stylesheet外部リソーススタイルシート
tagハイパーリンクタグ
※ <body>内の指定可
拡張定義 (実装依存)機能備考
apple-touch-icon外部リソースモバイル端末アイコン
(主にApple製デバイス)
mask-icon外部リソースアイコン表示のカスタマイズ色
その他: HTML5 link type extensions
rev=【リンク先からの関係 (複数:半角スペース区切り)】

リンク先からの関係 (reverse link)
(rel属性参照)
sizes=【アイコンサイズ (複数:半角スペース区切り)】アイコンサイズ(rel="icon" または "apple-touch-icon" )
例:"16x16 32X32"・"any"
type=【MIMEタイプ】リンク先ドキュメントタイプ

【グローバル属性】

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

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

interface HTMLLinkElement : HTMLElement
HTMLLinkElement includes LinkStyle

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

HTMLLinkElement
interface HTMLLinkElement : HTMLElement
HTMLLinkElement includes LinkStyle

DOMStringasプリロード要求の宛先
DOMString?crossOriginCORSの認証情報使用有無
booleandisabledリンクの無効化
USVStringhrefリソースの URL
DOMStringhreflangリソースの言語
DOMStringimageSizes画像サイズ
USVStringimageSrcset画像ファイルのセット
DOMStringintegrity整合性メタデータ
DOMStringmediaメディア
DOMStringnonce ワンタイム トークン ( HTMLElementに移動 )
DOMStringreferrerPolicyリファラー ポリシー
DOMStringrelリンク先の関係
DOMTokenListrelListリンク先の関係 リスト
DOMStringrev リンク先からの関係
[PutForwards=value] DOMSettableTokenListsizesアイコンサイズ リスト
DOMStringtypeリンク先ドキュメントタイプ

LinkStyle〔CSSOM 定義〕
interface mixin LinkStyle

CSSStyleSheet?sheet

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