SYNCERのロゴ
アイキャッチ画像

Text.wholeText - 連結するテキストを含めた文字列

wholeTextは、Textのプロパティです。元のテキストノードに連結するテキストをまとめた文字列を返します。

概要

名前
wholeText
所属
Text
IDL
readonly attribute DOMString wholeText;
仕様書
https://dom.spec.whatwg.org/#dom-text-wholetext

説明

引数はありません。返り値はTextではなく、文字列です。

チュートリアル

Text.wholeTextは連結するテキストをまとめて文字列で返します。例えば、下記の通り、3つのテキストを連続してドキュメントに追加した場合、これらは"hogefugapiyo"と表示されますが、内部的には3つにノードが分かれています。

var text1 = "hoge" ;
var text2 = "fuga" ;
var text3 = "piyo" ;

document.body.appendChild( text1 ) ;
document.body.appendChild( text2 ) ;
document.body.appendChild( text3) ;

例えば、2つ目のテキストノード(text2)のプロパティを参照すると、論理的に連結している前後の"hoge"、"piyo"をまとめた文字列を返してくれます。もちろん、他のテキストノードでも同じです。

text2.wholeText ;	// "hogefugapiyo"

デモ

Text.wholeTextのデモです。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<html>
<body>
<script>
var text1 = new Text( "hoge" ) ;
var text2 = new Text( "fuga" ) ;
var text3 = new Text( "piyo" ) ;

var documentFragment = document.createDocumentFragment() ;
documentFragment.appendChild( text1 ) ;
documentFragment.appendChild( text2 ) ;
documentFragment.appendChild( text3 ) ;

var value = text2.wholeText ;

console.log( value ) ;
document.body.appendChild( new Text( value ) ) ;
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月7日 (土)
コンテンツを公開しました。