HTMLElement.lang

HTMLElement.lang プロパティは、要素の属性値とテキストコンテンツの基本言語を取得または設定します。

このプロパティによって返される言語コードは、IETF 文書の言語を識別するタグ(BCP47)(英語)で定義されています。 一般的な例には、英語の "en"、日本語の "ja"、スペイン語の "es" などがあります。 この属性のデフォルト値は unknown(不明)です。 この属性は、ここで説明する個々の要素レベルで有効ですが、ほとんどの場合、ドキュメントのルート要素に対して指定されます。

これも lang 属性でのみ機能し、xml:lang では機能しません。

構文

var languageUsed = elementNodeReference.lang; // lang の値を取得
elementNodeReference.lang = NewLanguage; // lang に新しい値を設定

languageUsed は、現在の要素のテキストを記述している言語を取得する文字列変数です。 NewLanguage は、現在の要素のテキストを記述している言語を設定する値を持つ文字列変数です。

// このスニペットは基本言語を比較し、
// 言語に基づいて別の URL にリダイレクトするものです
if (document.documentElement.lang === "en") {
  window.location.href = "Some_document.html.en";
} else if (document.documentElement.lang === "ru") {
  window.location.href = "Some_document.html.ru";
}

仕様

仕様 状態 コメント
Document Object Model (DOM) Level 2 HTML Specification
lang の定義
廃止された

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
langChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 1IE ? Opera 完全対応 ありSafari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明