このプロパティは、要素の属性の値とテキストの内容の基になる言語を設定します。

このプロパティによって返される言語コードは、 RFC 1766に定義されているものです。 一般的な例として、英語であれば"en"が、日本語であれば"ja"が、スペイン語であれば"es"といったものが含まれます。 この属性のデフォルト値は不明です。 このページでは個々の要素レベルで有効にして説明するものの、 この属性はほぼ全てのケースでdocumentのルート要素で指定されます。

これは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";
}

注意事項

仕様

 Back to top