概要
文書のタイトルを取得 / 設定します。
構文
var docTitle = document.title;
上記の変数 docTitle
は文書のタイトルを含む文字列です。通常は title
要素でマークアップされたタイトルを返しますが、タイトルが document.title
の設定により上書きされている場合はその値を返します(※参照: Notes)
document.title = newTitle;
上記の変数 newTitle
は文書の新しいタイトルとなります。新しいタイトルは document.title
の戻り値、つまり文書に表示されるタイトル(※ウィンドウのタイトルバーなど)と文書の DOM (※ HTML 文書の <title>
要素の内容など)に反映されます。
例
<!DOCTYPE html> <html> <head> <title>Hello World!</title> </head> <body> <script> alert(document.title); // displays "Hello World!" document.title = "Goodbye World!"; alert(document.title); // displays "Goodbye World!" </script> </body> </html>
注記
Gecko に於いて、このプロパティは HTML 、SVG 、 XUL 、その他の文書に適用されます。
HTML 文書に於いては document.title
の初期値は <title>
要素のテキスト内容です。XUL に於いては、 window
またはその他のトップレベル XUL 要素の title
属性の値です。
XUL に於いて、文書が完全に読みこまれる前に document.title
にアクセスした時の動作は定義されていません(※ document.title
は空文字を返す場合があり、また document.title
を設定しても効果が表れないかもしれません)