diff options
Diffstat (limited to 'files/ja/web/api/htmlelement/innertext/index.html')
| -rw-r--r-- | files/ja/web/api/htmlelement/innertext/index.html | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/files/ja/web/api/htmlelement/innertext/index.html b/files/ja/web/api/htmlelement/innertext/index.html new file mode 100644 index 0000000000..e5db44dba4 --- /dev/null +++ b/files/ja/web/api/htmlelement/innertext/index.html @@ -0,0 +1,91 @@ +--- +title: HTMLElement.innerText +slug: Web/API/HTMLElement/innerText +tags: + - API + - HTML DOM + - HTMLElement + - Property + - Reference + - プロパティ +translation_of: Web/API/HTMLElement/innerText +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p><span class="seoSummary"><code><strong>innerText</strong></code> は {{domxref("HTMLElement")}} のプロパティで、ノードとその子孫の「レンダリングされた」テキスト内容を示します。</span>ゲッターとして、カーソルで要素の内容を選択しクリップボードにコピーした際のテキストに近いものを取得することができます。</p> + +<div class="blockIndicator note"> +<p><strong>メモ:</strong> <code>innerText</code> は {{domxref("Node.textContent")}} と混同しやすいのですが、両者には重要な違いがあります。基本的に <code>innerText</code> はテキストがレンダリングされる表示を意識しますが、 <code>textContent</code> はそうではありません。</p> +</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">const <em>renderedText</em> = <em>htmlElement</em>.innerText +<em>htmlElement</em>.innerText = <em>string</em></pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("DOMString")}} で、要素の表示されたテキストの内容を表します。要素自身が<a href="https://html.spec.whatwg.org/multipage/rendering.html#being-rendered">表示されないとき</a> (例えば、文書から切り離されたり、表示から隠されたりしている場合)、返値は {{domxref("Node.textContent")}} プロパティと同じ値になります。</p> + +<h2 id="Example" name="Example">例</h2> + +<p>この例では <code>innerText</code> と {{domxref("Node.textContent")}} を比較しています。 <code>innerText</code> が {{htmlElement("br")}} 要素のようなものをどのように意識するかや、非表示の要素を無視することに注意してください。</p> + +<h3 id="HTML">HTML</h3> + +<pre class="brush: html notranslate"><h3>元の要素:</h3> +<p id="source"> + <style>#source { color: red; }</style> + このテキストが<br>どのように扱われるか<br> + 下で見てみてください。 + <span style="display:none">隠しテキスト</span> +</p> +<h3>textContent の結果:</h3> +<textarea id="textContentOutput" rows="6" cols="30" readonly>...</textarea> +<h3>innerText の結果:</h3> +<textarea id="innerTextOutput" rows="6" cols="30" readonly>...</textarea></pre> + +<h3 id="JavaScript">JavaScript</h3> + +<pre class="brush: js notranslate">const source = document.getElementById('source'); +const textContentOutput = document.getElementById('textContentOutput'); +const innerTextOutput = document.getElementById('innerTextOutput'); + +textContentOutput.value = source.textContent; +innerTextOutput.value = source.innerText;</pre> + +<h3 id="Result" name="Result">結果</h3> + +<p>{{EmbedLiveSample("Example", 700, 450)}}</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', 'dom.html#the-innertext-idl-attribute', 'innerText')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>導入。 <a href="https://github.com/rocallahan/innerText-spec">innerText の仕様書の草稿</a>に基づく。履歴は <a href="https://github.com/whatwg/html/issues/465">whatwg/html#465</a> および <a href="https://github.com/whatwg/compat/issues/5">whatwg/compat#5</a> を参照。</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.HTMLElement.innerText")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("HTMLElement.outerText")}}</li> + <li>{{domxref("Element.innerHTML")}}</li> +</ul> |