zoom.scale - ズーム操作におけるscaleの値を取得、変更する

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

d3.jsのzoom.scaleは、現在のズーム操作におけるscaleの値を取得、変更するためのプロパティです。値はX方向、Y方向、2つの値を持った配列リテラルとなります。

サンプルコード

<img src="/image.png">

// ズーム操作のインスタンスを作成
var zoom = d3.behavior.zoom() ;

// ズーム操作に対応するイベントリスナーを指定する
zoom.on( "zoom", function() {
	// 処理内容
} ) ;

// img要素に対して、call()メソッドでズーム操作を適用
d3.select( "img" ).call( zoom ) ;

// scaleの値を取得
var scale = zoom.scale() ;

// scaleの値を変更
zoom.scale( 1 ) ;

デモ

下のボタンを押すと、zoom.scaleを使って、scaleの値を取得したり、変更します。取得するscale値は別途、小数点以下を切り捨てています。

RUN
HTML
CSS
JavaScript

<div id="parent"> <img src="/character.png" id="target"> </div> scale: ? translate: [ ?, ? ] <a id="method1">1に変更</a> <a id="method2">取得→?</a>

#parent { text-align: center ; } #target { width: 150px ; height: 150px ; background: #D36015 ; margin: 0 auto ; } a { color: #333 ; display: block ; background: #f2f2f2 ; text-align: center ; padding: 8px ; font-weight: 700 ; } a:hover { cursor: pointer ; background: #e6e6e6 ; } .coordinate { margin: 4px 0 0 ; padding: 0 ; text-align: center ; }

// ズーム操作のインスタンスを作成 var zoom = d3.behavior.zoom() ; // ズーム操作に対応するイベントリスナーを指定する zoom.on( "zoom", function() { // イベントオブジェクト var event = d3.event ; // スケール (現在の倍率) var scale = event.scale ; // トランスレート (X方向、Y方向への移動距離) var tx = event.translate[0] ; var ty = event.translate[1] ; // 出力 d3.select( "#scale" ).text( scale ) ; d3.selectAll( ".translate" ).data( event.translate ).text( function( d, i ) { return d ; } ) ; } ) ; // img要素に対して、zoom()メソッドでズーム操作を適用 zoom( d3.select( "#target" ) ) ; // クリックイベント1 d3.select( "#method1" ).on( "click", function() { // scaleの値を変更 zoom.scale( 1 ) ; } ) ; // クリックイベント2 d3.select( "#method2" ).on( "click", function() { // scaleの値を取得 var scale = zoom.scale() ; // 小数点以下を破棄 scale = Math.floor( scale ) ; // 出力 d3.select( this ).text( "取得→" + scale.toString() ) ; } ) ;

構文

scale || instance = zoom.scale( [ scale ] )

引数

項目	説明
scale	省略可。省略した場合は値の変更ではなく、値の取得となる。引数に数値を指定すると、ズーム操作のscaleの値を変更する。この変更は、対象要素を変更するものではなく、ズーム操作のインスタンス内で管理する、scaleの値を変更するだけなのでご注意下さい。

戻り値

項目	説明
scale	引数を指定しなかった場合、scaleの値(数値)が戻り値となる。
instance	引数を指定して、scaleの値に変更を加えた場合、ズーム操作のインスタンスが戻り値となる。