files/ja/web/api/window/content/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

---
title: Window.content
slug: Web/API/Window/content
translation_of: Web/API/Window/content
---
<p>{{APIRef}}{{non-standard_header}}</p>

<div class="note">
<p><strong>注</strong>: Firefox 57 以降 (当初はナイトリーのみ)、 <code>content</code> および <code>_content</code> の変化形はクロームの (特権) コードでのみ利用可能となり、ウェブではどこでも利用できなくなりました。</p>
</div>

<p>主となるコンテンツウィンドウを表す <a href="/ja/docs/Web/API/Window">Window object</a> オブジェクトを返します。これは、<code>type="content-primary"</code> 属性を持つ <code>&lt;browser&gt;</code> (もしくは <code>tabbrowser</code> や <code>&lt;iframe&gt;</code>) 要素のある XUL ウィンドウにおいて役立ちます。最も有名な例は、Firefox のメインウィンドウである <code>browser.xul</code> です。このような場合、<code>content</code> はブラウザーに現在表示されている文書のための <code>Window</code> オブジェクトへの参照を返します。これは、<code><var>browserRef</var>.contentWindow</code> のショートカットです。</p>
<p>特権のないコンテンツ (ウェブページ) では、<code>content</code> は通常 <a href="/ja/docs/Web/API/Window/top">top</a> と同じです (ウェブページがサイドバーに読み込まれた場合は例外で、 <code>content</code> は現在選択しているタブの <code>Window</code> を参照します)。</p>

<div class="note">
<p><strong>注</strong>: いくつかの例では、<code>content</code> の代わりに <code>_content</code> を使用しています。しかし、後者は長い間非推奨とされています。ですから、新しいコードでは <code>content</code> を使うべきです。</p>
</div>

<h3 id="Syntax">構文</h3>

<pre class="eval">var <var>windowObject</var> = window.content;
</pre>

<h3 id="Example">例</h3>

<p>以下のコードを <code>&lt;browser type="content-primary"/&gt;</code> 要素を持つ chrome XUL ウィンドウで実行すると、ブラウザーで現在表示されているページの最初の div 要素の周囲に赤い枠が描画されます。</p>

<pre class="eval">content.document.getElementsByTagName("div")[0].style.border = "solid red 1px";
</pre>

<h3 id="Specifications">仕様書</h3>

<p>なし。</p>

<h3 id="See_also">関連情報</h3>

<ul>
 <li><a href="/ja/docs/Working_with_windows_in_chrome_code">chrome コードでウィンドウを取り扱う</a></li>
 <li>特権コードからコンテンツの文書にアクセスする場合は、 <a href="/ja/XPCNativeWrapper">XPCNativeWrapper</a> 注意してください。</li>
</ul>