files/ja/web/api/document/title/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

---
title: Document.title
slug: Web/API/Document/title
tags:
  - API
  - Command API
  - Document
  - HTML DOM
  - NeedsSpecTable
  - Property
  - Reference
translation_of: Web/API/Document/title
---
<div>{{APIRef("DOM")}}</div>

<p><span class="seoSummary"><strong><code>document.title</code></strong> プロパティは、現在の文書の<a href="/ja/docs/Web/HTML/Element/title">題名</a>を取得または設定します。</span></p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="syntaxbox notranslate">var <var>docTitle</var> = <var>document</var>.title;
</pre>

<p><var>docTitle</var> は <var>document</var> の題名を含む文字列です。題名が <code>document.title</code> に設定することで上書きされている場合は、その値を含みます。そうでなければ、マークアップの中で指定された題名を含みます (下記の{{Anch("Notes", "メモ")}}を参照)。</p>

<pre class="syntaxbox notranslate"><var>document</var>.title = <var>newTitle</var>;
</pre>

<p><code><var>newTitle</var></code> は文書の新しい題名です。代入すると、 <code>document.title</code> の返値、文書に表示される題名 (ウィンドウのタイトルバーやタブなど)、文書の DOM (HTML 文書の <code>&lt;title&gt;</code> 要素の内容など) にも反映されます。</p>

<h2 id="Example" name="Example">例</h2>

<pre class="brush:js notranslate">&lt;!DOCTYPE html&gt;
&lt;html&gt;
&lt;head&gt;
  &lt;title&gt;Hello World!&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;

  &lt;script&gt;
    alert(document.title); // "Hello World!" と表示
    document.title = "Goodbye World!";
    alert(document.title); // "Goodbye World!" と表示
  &lt;/script&gt;

&lt;/body&gt;
&lt;/html&gt;
</pre>

<h2 id="Notes" name="Notes">注</h2>

<p>Gecko では、このプロパティは HTML, SVG, XUL, その他の文書に適用されます。</p>

<p>HTML 文書では、 <code>document.title</code> の初期値は <code>&lt;title&gt;</code> 要素のテキストの内容です。 XUL では、 {{XULElem("window")}} またはその他の最上位 XUL 要素の {{XULAttr("title")}} 属性の値です。</p>

<p>XUL では、文書の読み込みが完了する前に <code>document.title</code> にアクセスした時の動作は未定義です。 <code>document.title</code> が空文字を返す場合があり、また <code>document.title</code> を設定しても効果が表れないかもしれません。</p>

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG','#document.title','document.title')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<p>{{Compat("api.Document.title")}}</p>