selection.html - 要素のHTMLを取得、変更する

投稿日:2016/03/03 / 更新日:2016/03/03

d3.jsのselection.html()は、要素内のHTMLを取得、または変更するためのAPIです。JavaScriptのinnerHTMLプロパティがベースとなっています。

サンプルコード

<p>SYN<mark>C</mark>ER</p>

// p要素を取得
var selection = d3.select( "p" ) ;

// p要素のHTMLを取得
var htmlContent = selection.html() ;

// p要素に新しいHTMLを指定
selection.html( "value", "<mark>SYNCER</mark>" ) ;

デモ

RUN
HTML
CSS
JavaScript

下のp要素の中身を操作するよ。 SYNCER <ul> <li><a id="method1">取得</a></li> <li><a id="method2">変更</a></li> <li><a id="method3">リセット</a></li> </ul>

#clone { background: #f2f2f2 ; } input { font-size: 16px ; height: 60px ; transition: width .3s ; box-sizing: border-box ; width: 100% ; } ul { margin: 24px 0 0 ; padding: 0 ; list-style-type: none ; } ul li { margin: 4px 0 0 ; padding: 0 ; } a { color: #333 ; display: block ; background: #f2f2f2 ; text-align: center ; padding: 8px ; font-weight: 700 ; } a:hover { cursor: pointer ; background: #e6e6e6 ; }

// p要素を取得 var selection = d3.select( "#element" ) ; // クリックイベント1 document.getElementById( "method1" ).onclick = function() { // p要素のHTMLを取得 var htmlContent = selection.html() ; // 下のp要素に反映する d3.select( "#clone" ).html( htmlContent ) ; } // クリックイベント2 document.getElementById( "method2" ).onclick = function() { // 変更する値を交互に変更 var newHTML = selection.html() == "SYNCER" ? "SYNCER" : "SYNCER" ; // 反映する selection.html( newHTML ) ; } // クリックイベント3 document.getElementById( "method3" ).onclick = function() { // HTMLを初期値に selection.html( "SYNCER" ) ; // 下のp要素を空に d3.select( "#clone" ).html( "" ) ; }

構文

value || selection = selection.html( [ value || function ] )

引数
項目	説明
value	省略可。要素に新しくセットしたいHTMLを指定する。省略して引数をなしにした場合は、現在のHTMLを取得する。
function	引数に指定する値を、関数にすることもできる。ここで指定した関数は、第1引数に要素に関連付けられたデータ、第2引数にインデックス番号をとる。また、`this`で要素を参照できる。戻り値が値として設定される。

戻り値
項目	説明
value	引数を指定しなかった場合、対象要素内のHTMLが戻り値となる。
selection	引数を指定してHTMLを変更した場合は、d3.selectionオブジェクトが戻り値となる。

ノート

引数なしなら取得: 引数を指定しない場合はHTMLの取得。
引数ありなら変更: 引数を指定した場合はHTMLの変更。
テキストだけの場合: 要素内に存在するのがテキストだけの場合、また、変更する時に指定するのがテキストだけの場合は、代わりにtext()を使った方がパフォーマンスは格段に良い。