hcl.darker - HCL値を暗くする

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

d3.jsのhcl.darker()は、HCL値を暗くするためのメソッドです。引数をkとした場合に-18 * kの計算が適用されます。

サンプルコード

// HCL値のインスタンスを作成
var hcl = d3.hcl( 54, 72, 54 ) ;

// HCL値を暗くして取得
var darkColor = hcl.darker() ;

// HCL値を暗くして取得 (効果はいつもの半分だけでいい)
var darkColor = hcl.darker( 0.5 ) ;

// HCLの各値を取得
var H = darkColor.h ;
var C = darkColor.c ;
var L = darkColor.l ;

// 直接スタイルに指定しても可
d3.select( "#target" ).style( "background", darkColor ) ;

デモ

hcl( 54, 72, 54 )を指定したインスタンスを作成してあります。ボタンを押すとdarker()を実行します。もう1つのボタンは引数に0.2(初期値は1)を指定して、弱めに暗くします。なお、出力されるHCL値は、小数点第3位以下を切り捨てています。

RUN
HTML
CSS
JavaScript

<div id="target">hcl( 54, 72, 54 )</div> <p><a id="method1">暗くする</a></p> <p><a id="method2">弱めに暗くする</a></p> <p><a id="method3">リセット</a></p>

#target { height: 100px ; line-height: 100px ; background: rgb( 211, 96, 21 ) ; margin: 0 auto ; color: #fff ; text-align: center ; } a { color: #333 ; display: block ; background: #f2f2f2 ; text-align: center ; padding: 8px ; font-weight: 700 ; } a:hover { cursor: pointer ; background: #e6e6e6 ; }

// HCL値のインスタンスを作成 (3つの引数を使ってHCL値を指定) var hcl = d3.hcl( 54, 72, 54 ) ; // クリックイベント1 d3.select( "#method1" ).on( "click", function() { // 色を暗くして取得 var darkColor = hcl.darker() ; // div要素の背景色とテキストを更新 d3.select( "#target" ).transition().style( "background", darkColor ).text( "hcl( " + darkColor.h + ", " + darkColor.c + ", " + Math.floor( darkColor.l * 100 ) / 100 + " )" ).style( "color", textColor( darkColor ) ) ; // インスタンスを更新 hcl = d3.hcl( darkColor ) ; } ) ; // クリックイベント2 d3.select( "#method2" ).on( "click", function() { // 色を暗くして取得 var darkColor = hcl.darker( 0.2 ) ; // div要素の背景色とテキストを更新 d3.select( "#target" ).transition().style( "background", darkColor ).text( "hcl( " + darkColor.h + ", " + darkColor.c + ", " + Math.floor( darkColor.l * 100 ) / 100 + " )" ).style( "color", textColor( darkColor ) ) ; // インスタンスを更新 hcl = d3.hcl( darkColor ) ; } ) ; // クリックイベント3 d3.select( "#method3" ).on( "click", function() { // div要素の背景色とテキストを更新 d3.select( "#target" ).transition().style( "background", "#d36015" ).text( "hcl( 54, 72, 54 )" ).style( "color", textColor( "#fff" ) ) ; // インスタンスを更新 hcl = d3.hcl( 54, 72, 54 ) ; } ) ; // 背景色に応じて文字色を白にするか黒にするか判断 function textColor( darkColor ) { darkColor = d3.rgb( darkColor.toString() ) ; return ( darkColor.r * 0.299 + darkColor.g * 0.587 + darkColor.b * 0.114 ) > 186 ? "#000" : "#fff" ; }

構文

darkColor = hsl.darker( k )

引数

項目	説明
k	引数をkとした場合に`-18 * k`の計算が、L値にかけられる。引数を指定しない場合の初期値は`1`。

戻り値

項目	説明
darkColor	HCL値を含んだオブジェクトリテラル(`{ h:n, c:n, l:n }`)が戻り値となる。