selection.call - セレクションに関数を実行する

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

d3.jsのselection.call()は、d3.selectionオブジェクトに対して、指定した関数を実行するメソッドです。each()が各要素、それぞれに実行するのに対して、こちらはセレクション(各要素のまとまり)に実行します。

サンプルコード

<ul>
	<li>1つ目のLI</li>
	<li>2つ目のLI</li>
	<li>3つ目のLI</li>
	<li>4つ目のLI</li>
	<li>5つ目のLI</li>
</ul>

// 全てのli要素を選択する
d3.selectAll( "li" )

// 各要素に関数を実行する
.call( function( selection, a, b ) {
	// selection = d3.selectionオブジェクト
	// a = "1つ目の引数"
	// b = "2つ目の引数"
	// ... 引数は任意の数だけ指定可能
	// this = d3.selectionオブジェクト (第1引数と同じ)

	// セレクションのスタイルを変更する
	selection.style( "color", "red" ) ;
}, "1つ目の引数", "2つ目の引数" ) ;

デモ

RUN
HTML
CSS
JavaScript

<p>各li要素の文字色を<code>call()</code>を通して赤にするよ。</p> <ul id="target"> <li>1つ目のLI</li> <li>2つ目のLI</li> <li>3つ目のLI</li> <li>4つ目のLI</li> <li>5つ目のLI</li> </ul> <ul> <li><a id="method1">実行</a></li> <li><a id="method2">リセット</a></li> </ul>

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

// クリックイベント1 document.getElementById( "method1" ).onclick = function() { // 全てのli要素を選択する d3.selectAll( "#target li" ) // 各要素に関数を実行する .call( function( selection, a, b ) { // selection = d3.selectionオブジェクト // a = "1つ目の引数" // b = "2つ目の引数" // this = d3.selectionオブジェクト (第1引数と同じ) // セレクションのスタイルを変更する selection.style( "color", "red" ) ; }, "1つ目の引数", "2つ目の引数" ) ; } // クリックイベント2 document.getElementById( "method2" ).onclick = function() { // ulの中身を元に戻す d3.select( "#target" ).html( ulContent ) ; } // ul要素の最初の状態を保存しておく var ulContent = d3.select( "#target" ).node().innerHTML ;

構文

selection = selection.call( function [, argument [, arguments [, ... ] ] ] )

引数
項目	説明
function	セレクションに対して実行する関数を指定する。この関数は、第1引数にd3.selectionオブジェクトをとり、第2引数以降は指定した任意の値となる。この関数内の`this`は、第1引数と同じd3.selectionオブジェクト。
argument	第2引数以降に、第1引数に指定した関数へ渡す引数を指定できる。任意の数だけ指定できる。

戻り値
項目	説明
selection	関数を実行した後のd3.selectionオブジェクトが戻り値となる。