Options

Options

new Options()

Source:
See:
  • bb.generate to use these options on generating the chart

Class to set options on generating chart.

  • It's instantiated internally, not exposed for public.

Members

(static) area :Object

Source:
See:
Properties:
Name Type Attributes Default Description
area.zerobased Boolean <optional>
true

Set if min or max value will be 0 on area chart.

area.above Boolean <optional>
false

Set background area above the data chart line.

area.linearGradient Boolean | Object <optional>
false

Set the linear gradient on area.

Or customize by giving below object value:

  • x {Array}: x1, x2 value
  • y {Array}: y1, y2 value
  • stops {Array}: Each item should be having [offset, stop-color, stop-opacity] values.

Set area options

Type:
  • Object
Example
area: {
     zerobased: false,
     above: true,

     // will generate follwing linearGradient:
     // <linearGradient x1="0" x2="0" y1="0" y2="1">
     //    <stop offset="0" stop-color="$DATA_COLOR" stop-opacity="1"></stop>
     //    <stop offset="1" stop-color="$DATA_COLOR" stop-opacity="0"></stop>
     // </linearGradient>
     linearGradient: true,

     // Or customized gradient
     linearGradient: {
     	x: [0, 0],  // x1, x2 attributes
     	y: [0, 0],  // y1, y2 attributes
     	stops: [
     		// offset, stop-color, stop-opacity
     		[0, "#7cb5ec", 1],

     		// setting 'null' for stop-color, will set its original data color
     		[0.5, null, 0],

     		// setting 'function' for stop-color, will pass data id as argument.
     		// It should return color string or null value
     		[1, function(id) { return id === "data1" ? "red" : "blue"; }, 0],
     	]
     }
 }

(static) axis․rotated :Boolean

Source:
Default Value:
  • false

Switch x and y axis position.

Type:
  • Boolean
Example
axis: {
  rotated: true
}

(static) axis․x․axes :Array

Source:
See:

Set additional axes for x Axis.

  • NOTE: Axis' scale is based on x Axis value

Each axis object should consist with following options:

Name Type Default Description
tick.outer Boolean true Show outer tick
tick.format Function - Set formatter for tick text
tick.count Number - Set the number of y axis ticks
tick.values Array - Set tick values manually
Type:
  • Array
Example
x: {
   axes: [
     {
       tick: {
         outer: false,
         format: function(x) {
            return x + "%";
         },
         count: 2,
         values: [10, 20, 30]
       }
     },
     ...
   ]
}

(static) axis․x․categories :Array

Source:
Default Value:
  • []

Set category names on category axis. This must be an array that includes category names in string. If category names are included in the date by data.x option, this is not required.

Type:
  • Array
Example
axis: {
  x: {
    categories: ["Category 1", "Category 2", ...]
  }
}

(static) axis․x․clipPath :Boolean

Source:
Default Value:
  • true
See:

Set clip-path attribute for x axis element

Type:
  • Boolean
Example
// don't set 'clip-path' attribute
clipPath: false

(static) axis․x․extent :Array|function

Source:
Default Value:
  • undefined

Set default extent for subchart and zoom. This can be an array or function that returns an array.

Type:
  • Array | function
Example
axis: {
  x: {
    // extent range as a pixel value
    extent: [0, 200],

    // when axis is 'timeseries', parsable datetime string
    extent: ["2019-03-01", "2019-03-05"],

    // return extent value
    extent: function(domain, scale) {
   	 var extent = domain.map(function(v) {
    	    return scale(v);
    	 });

  	 // it should return a format of array
  	 // ex) [0, 584]
    	 return extent;
    }
  }
}

(static) axis․x․height :Number

Source:
Default Value:
  • undefined

Set height of x axis.

The height of x axis can be set manually by this option. If you need more space for x axis, please use this option for that. The unit is pixel.

Type:
  • Number
Example
axis: {
  x: {
    height: 20
  }
}

(static) axis․x․label :String|Object

Source:
Default Value:
  • undefined

Set label on x axis.

You can set x axis label and change its position by this option. string and object can be passed and we can change the poisiton by passing object that has position key.
Available position differs according to the axis direction (vertical or horizontal). If string set, the position will be the default.

  • If it's horizontal axis:
    • inner-right [default]
    • inner-center
    • inner-left
    • outer-right
    • outer-center
    • outer-left
  • If it's vertical axis:
    • inner-top [default]
    • inner-middle
    • inner-bottom
    • outer-top
    • outer-middle
    • outer-bottom
Type:
  • String | Object
Example
axis: {
  x: {
    label: "Your X Axis"
  }
}

axis: {
  x: {
    label: {
       text: "Your X Axis",
       position: "outer-center"
    }
  }
}

(static) axis․x․localtime :Boolean

Source:
Default Value:
  • true

Set how to treat the timezone of x values.
If true, treat x value as localtime. If false, convert to UTC internally.

Type:
  • Boolean
Example
axis: {
  x: {
    localtime: false
  }
}

(static) axis․x․max :Number

Source:
Default Value:
  • undefined

Set max value of x axis range.

Type:
  • Number
Example
axis: {
  x: {
    max: 100
  }
}

(static) axis․x․min :Number

Source:
Default Value:
  • undefined

Set min value of x axis range.

Type:
  • Number
Example
axis: {
  x: {
    min: -100
  }
}

(static) axis․x․padding :Object

Source:
Default Value:
  • {}

Set padding for x axis.

If this option is set, the range of x axis will increase/decrease according to the values. If no padding is needed in the rage of x axis, 0 should be set.

  • NOTE: The padding values aren't based on pixels. It differs according axis types
    • category: The unit of tick value ex. the given value 1, is same as the width of 1 tick width
    • timeseries: Numeric time value ex. the given value 1000*60*60*24, which is numeric time equivalent of a day, is same as the width of 1 tick width
Type:
  • Object
Example
axis: {
  x: {
    padding: {
      // when axis type is 'category'
      left: 1,  // set left padding width of equivalent value of a tick's width
      right: 0.5  // set right padding width as half of equivalent value of tick's width

      // when axis type is 'timeseries'
      left: 1000*60*60*24,  // set left padding width of equivalent value of a day tick's width
      right: 1000*60*60*12   // set right padding width as half of equivalent value of a day tick's width
    }
  }
}

(static) axis․x․show :Boolean

Source:
Default Value:
  • true

Show or hide x axis.

Type:
  • Boolean
Example
axis: {
  x: {
    show: false
  }
}

(static) axis․x․tick․centered :Boolean

Source:
Default Value:
  • false

centerize ticks on category axis.

Type:
  • Boolean
Example
axis: {
  x: {
    tick: {
      centered: true
    }
  }
}

(static) axis․x․tick․count :Number

Source:
Default Value:
  • undefined

The number of x axis ticks to show.

This option hides tick lines together with tick text. If this option is used on timeseries axis, the ticks position will be determined precisely and not nicely positioned (e.g. it will have rough second value).

Type:
  • Number
Example
axis: {
  x: {
    tick: {
      count: 5
    }
  }
}

(static) axis․x․tick․culling :Boolean

Source:
Default Value:
  • - true for indexed axis and timeseries axis - false for category axis

Setting for culling ticks.

If true is set, the ticks will be culled, then only limitted tick text will be shown. This option does not hide the tick lines. If false is set, all of ticks will be shown.

We can change the number of ticks to be shown by axis.x.tick.culling.max.

Type:
  • Boolean
Example
axis: {
  x: {
    tick: {
      culling: false
    }
  }
}

(static) axis․x․tick․culling․max :Number

Source:
Default Value:
  • 10

The number of tick texts will be adjusted to less than this value.

Type:
  • Number
Example
axis: {
  x: {
    tick: {
      culling: {
          max: 5
      }
    }
  }
}

(static) axis․x․tick․fit :Boolean

Source:
Default Value:
  • true
See:

Fit x axis ticks.

  • true: ticks will be positioned nicely to have same intervals.
  • false: ticks will be positioned according to x value of the data points.
Type:
  • Boolean
Example
axis: {
  x: {
    tick: {
      fit: false
    }
  }
}

(static) axis․x․tick․format :function|String

Source:
Default Value:
  • undefined
See:

A function to format tick value. Format string is also available for timeseries data.

Type:
  • function | String
Example
axis: {
  x: {
    tick: {
       // for timeseries, a 'datetime' object is given as parameter
      format: function(x) {
          return x.getFullYear();
      }

      // for category, index(Number) and categoryName(String) are given as parameter
      format: function(index, categoryName) {
          return categoryName.substr(0, 10);
      },

       // for timeseries format specifier
       format: "%Y-%m-%d %H:%M:%S"
    }
  }
}

(static) axis․x․tick․multiline :Boolean

Source:
Default Value:
  • true
See:

Set tick text to be multiline

  • NOTE:

When x tick text contains \n, it's used as line break and 'axis.x.tick.width' option is ignored.

Type:
  • Boolean
Examples
axis: {
  x: {
    tick: {
      multiline: false
    }
  }
}
// example of line break with '\n'
// In this case, 'axis.x.tick.width' is ignored
data: {
   x: "x",
   columns: [
       ["x", "long\ntext", "Another\nLong\nText"],
       ...
   ],
}

(static) axis․x․tick․outer :Boolean

Source:
Default Value:
  • true

Show x axis outer tick.

Type:
  • Boolean
Example
axis: {
  x: {
    tick: {
      outer: false
    }
  }
}

(static) axis․x․tick․rotate :Number

Source:
Default Value:
  • 0
See:

Rotate x axis tick text.
If you set negative value, it will rotate to opposite direction.

Type:
  • Number
Example
axis: {
  x: {
    tick: {
      rotate: 60
    }
  }
}

(static) axis․x․tick․show :Boolean

Source:
Default Value:
  • true
See:

Show or hide x axis tick line.

Type:
  • Boolean
Example
axis: {
  x: {
    tick: {
      show: false
    }
  }
}

(static) axis․x․tick․text․position :Object

Source:
Default Value:
  • {x: 0, y:0}

Set the x Axis tick text's position relatively its original position

Type:
  • Object
Example
axis: {
  x: {
    tick: {
      text: {
        position: {
          x: 10,
          y: 10
        }
      }
    }
  }
}

(static) axis․x․tick․text․show :Boolean

Source:
Default Value:
  • true
See:

Show or hide x axis tick text.

Type:
  • Boolean
Example
axis: {
  x: {
    tick: {
      text: {
          show: false
      }
    }
  }
}

(static) axis․x․tick․tooltip :Boolean

Source:
Default Value:
  • false

Set to display system tooltip(via 'title' attribute) for tick text

  • NOTE: Only available for category axis type (axis.x.type='category')
Type:
  • Boolean
Example
axis: {
  x: {
    tick: {
      tooltip: true
    }
  }
}

(static) axis․x․tick․values :Array

Source:
Default Value:
  • null

Set the x values of ticks manually.

If this option is provided, the position of the ticks will be determined based on those values. This option works with timeseries data and the x values will be parsed accoding to the type of the value and data.xFormat option.

Type:
  • Array
Example
axis: {
  x: {
    tick: {
      values: [1, 2, 4, 8, 16, 32, ...]
    }
  }
}

(static) axis․x․tick․width :Number

Source:
Default Value:
  • null

Set tick width

  • NOTE:

When x tick text contains \n, this option is ignored.

Type:
  • Number
Example
axis: {
  x: {
    tick: {
      width: 50
    }
  }
}

(static) axis․x․type :String

Source:
Default Value:
  • indexed
See:

Set type of x axis.

Available Values:

  • timeseries
  • category
  • indexed
Type:
  • String
Example
axis: {
  x: {
    type: "timeseries"
  }
}

(static) axis․y2․axes :Array

Source:
See:

Set additional axes for y2 Axis.

  • NOTE: Axis' scale is based on y2 Axis value

Each axis object should consist with following options:

Name Type Default Description
tick.outer Boolean true Show outer tick
tick.format Function - Set formatter for tick text
tick.count Number - Set the number of y axis ticks
tick.values Array - Set tick values manually
Type:
  • Array
Example
y2: {
   axes: [
     {
       tick: {
         outer: false,
         format: function(x) {
            return x + "%";
         },
         count: 2,
         values: [10, 20, 30]
       }
     },
     ...
   ]
}

(static) axis․y2․center :Number

Source:
Default Value:
  • undefined

Set center value of y2 axis.

Type:
  • Number
Example
axis: {
  y2: {
    center: 0
  }
}

(static) axis․y2․default :Array

Source:
Default Value:
  • undefined

Set default range of y2 axis.

This option set the default value for y2 axis when there is no data on init.

Type:
  • Array
Example
axis: {
  y2: {
    default: [0, 1000]
  }
}

(static) axis․y2․inner :Boolean

Source:
Default Value:
  • false

Show y2 axis inside of the chart.

Type:
  • Boolean
Example
axis: {
  y2: {
    inner: true
  }
}

(static) axis․y2․inverted :Boolean

Source:
Default Value:
  • false

Change the direction of y2 axis.

If true set, the direction will be from the top to the bottom.

Type:
  • Boolean
Example
axis: {
  y2: {
    inverted: true
  }
}

(static) axis․y2․label :String|Object

Source:
Default Value:
  • {}
See:

Set label on y2 axis.

You can set y2 axis label and change its position by this option. This option works in the same way as axis.x.label.

Type:
  • String | Object
Example
axis: {
  y2: {
    label: "Your Y2 Axis"
  }
}

axis: {
  y2: {
    label: {
       text: "Your Y2 Axis",
       position: "outer-middle"
    }
  }
}

(static) axis․y2․max :Number

Source:
Default Value:
  • undefined

Set max value of y2 axis.

Type:
  • Number
Example
axis: {
  y2: {
    max: 1000
  }
}

(static) axis․y2․min :Number

Source:
Default Value:
  • undefined

Set min value of y2 axis.

Type:
  • Number
Example
axis: {
  y2: {
    min: -1000
  }
}

(static) axis․y2․padding :Object

Source:
Default Value:
  • {}

Set the number of y2 axis ticks.

  • NOTE: This works in the same way as axis.y.tick.count.
Type:
  • Object
Example
axis: {
  y2: {
    padding: {
      top: 100,
      bottom: 100
    }
  }
}

(static) axis․y2․show :Boolean

Source:
Default Value:
  • false

Show or hide y2 axis.

  • NOTE:
    • When set to false will not generate y2 axis node. In this case, all 'y2' axis related functionality won't work properly.
    • If need to use 'y2' related options while y2 isn't visible, set the value true and control visibility by css display property.
Type:
  • Boolean
Example
axis: {
  y2: {
    show: true
  }
}

(static) axis․y2․tick․count :Number

Source:
Default Value:
  • undefined

Set the number of y2 axis ticks.

  • NOTE: This works in the same way as axis.y.tick.count.
Type:
  • Number
Example
axis: {
  y2: {
    tick: {
      count: 5
    }
  }
}

(static) axis․y2․tick․culling :Boolean

Source:
Default Value:
  • false

Setting for culling ticks.

If true is set, the ticks will be culled, then only limitted tick text will be shown. This option does not hide the tick lines. If false is set, all of ticks will be shown.

We can change the number of ticks to be shown by axis.y.tick.culling.max.

Type:
  • Boolean
Example
axis: {
  y2: {
    tick: {
      culling: false
    }
  }
}

(static) axis․y2․tick․culling․max :Number

Source:
Default Value:
  • 5

The number of tick texts will be adjusted to less than this value.

Type:
  • Number
Example
axis: {
  y2: {
    tick: {
      culling: {
          max: 5
      }
    }
  }
}

(static) axis․y2․tick․format :function

Source:
Default Value:
  • undefined

Set formatter for y2 axis tick text.

This option works in the same way as axis.y.format.

Type:
  • function
Example
axis: {
  y2: {
    tick: {
      format: d3.format("$,")
      //or format: function(d) { return "$" + d; }
    }
  }
}

(static) axis․y2․tick․outer :Boolean

Source:
Default Value:
  • true

Show or hide y2 axis outer tick.

Type:
  • Boolean
Example
axis: {
  y2: {
    tick: {
      outer: false
    }
  }
}

(static) axis․y2․tick․show :Boolean

Source:
Default Value:
  • true
See:

Show or hide y2 axis tick line.

Type:
  • Boolean
Example
axis: {
  y2: {
    tick: {
      show: false
    }
  }
}

(static) axis․y2․tick․text․position :Object

Source:
Default Value:
  • {x: 0, y:0}

Set the y2 Axis tick text's position relatively its original position

Type:
  • Object
Example
axis: {
  y2: {
    tick: {
      text: {
        position: {
          x: 10,
          y: 10
        }
      }
    }
  }
}

(static) axis․y2․tick․text․show :Boolean

Source:
Default Value:
  • true
See:

Show or hide y2 axis tick text.

Type:
  • Boolean
Example
axis: {
  y2: {
    tick: {
      text: {
          show: false
      }
    }
  }
}

(static) axis․y2․tick․values :Array

Source:
Default Value:
  • null

Set y2 axis tick values manually.

Type:
  • Array
Example
axis: {
  y2: {
    tick: {
      values: [100, 1000, 10000]
    }
  }
}

(static) axis․y․axes :Array

Source:
See:

Set additional axes for y Axis.

  • NOTE: Axis' scale is based on y Axis value

Each axis object should consist with following options:

Name Type Default Description
tick.outer Boolean true Show outer tick
tick.format Function - Set formatter for tick text
tick.count Number - Set the number of y axis ticks
tick.values Array - Set tick values manually
Type:
  • Array
Example
y: {
   axes: [
     {
       tick: {
         outer: false,
         format: function(x) {
            return x + "%";
         },
         count: 2,
         values: [10, 20, 30]
       }
     },
     ...
   ]
}

(static) axis․y․center :Number

Source:
Default Value:
  • undefined

Set center value of y axis.

Type:
  • Number
Example
axis: {
  y: {
    center: 0
  }
}

(static) axis․y․clipPath :Boolean

Source:
Default Value:
  • true

Set clip-path attribute for y axis element

Type:
  • Boolean
Example
// don't set 'clip-path' attribute
clipPath: false

(static) axis․y․default :Array

Source:
Default Value:
  • undefined

Set default range of y axis.

This option set the default value for y axis when there is no data on init.

Type:
  • Array
Example
axis: {
  y: {
    default: [0, 1000]
  }
}

(static) axis․y․inner :Boolean

Source:
Default Value:
  • false

Show y axis inside of the chart.

Type:
  • Boolean
Example
axis: {
  y: {
    inner: true
  }
}

(static) axis․y․inverted :Boolean

Source:
Default Value:
  • false

Change the direction of y axis.

If true set, the direction will be from the top to the bottom.

Type:
  • Boolean
Example
axis: {
  y: {
    inverted: true
  }
}

(static) axis․y․label :String|Object

Source:
Default Value:
  • {}
See:

Set label on y axis.

You can set y axis label and change its position by this option. This option works in the same way as axis.x.label.

Type:
  • String | Object
Example
axis: {
  y: {
    label: "Your Y Axis"
  }
}

axis: {
  y: {
    label: {
       text: "Your Y Axis",
       position: "outer-middle"
    }
  }
}

(static) axis․y․max :Number

Source:
Default Value:
  • undefined

Set max value of y axis.

  • NOTE: Padding will be added based on this value, so if you don't need the padding, please set axis.y.padding to disable it (e.g. axis.y.padding = 0).
Type:
  • Number
Example
axis: {
  y: {
    max: 1000
  }
}

(static) axis․y․min :Number

Source:
Default Value:
  • undefined

Set min value of y axis.

  • NOTE: Padding will be added based on this value, so if you don't need the padding, please set axis.y.padding to disable it (e.g. axis.y.padding = 0).
Type:
  • Number
Example
axis: {
  y: {
    min: 1000
  }
}

(static) axis․y․padding :Object

Source:
Default Value:
  • {}

Set padding for y axis.

You can set padding for y axis to create more space on the edge of the axis. This option accepts object and it can include top and bottom. top, bottom will be treated as pixels.

Type:
  • Object
Example
axis: {
  y: {
    padding: {
      top: 0,
      bottom: 0
    }
  }
}

(static) axis․y․show :Boolean

Source:
Default Value:
  • true

Show or hide y axis.

Type:
  • Boolean
Example
axis: {
  y: {
    show: false
  }
}

(static) axis․y․tick․count :Number

Source:
Default Value:
  • undefined

Set the number of y axis ticks.

  • NOTE: The position of the ticks will be calculated precisely, so the values on the ticks will not be rounded nicely. In the case, axis.y.tick.format or axis.y.tick.values will be helpful.
Type:
  • Number
Example
axis: {
  y: {
    tick: {
      count: 5
    }
  }
}

(static) axis․y․tick․culling :Boolean

Source:
Default Value:
  • false

Setting for culling ticks.

If true is set, the ticks will be culled, then only limitted tick text will be shown. This option does not hide the tick lines. If false is set, all of ticks will be shown.

We can change the number of ticks to be shown by axis.y.tick.culling.max.

Type:
  • Boolean
Example
axis: {
  y: {
    tick: {
      culling: false
    }
  }
}

(static) axis․y․tick․culling․max :Number

Source:
Default Value:
  • 5

The number of tick texts will be adjusted to less than this value.

Type:
  • Number
Example
axis: {
  y: {
    tick: {
      culling: {
          max: 5
      }
    }
  }
}

(static) axis․y․tick․format :function

Source:
Default Value:
  • undefined

Set formatter for y axis tick text.

This option accepts d3.format object as well as a function you define.

Type:
  • function
Example
axis: {
  y: {
    tick: {
      format: function(x) {
          return x.getFullYear();
      }
    }
  }
}

(static) axis․y․tick․outer :Boolean

Source:
Default Value:
  • true

Show y axis outer tick.

Type:
  • Boolean
Example
axis: {
  y: {
    tick: {
      outer: false
    }
  }
}

(static) axis․y․tick․show :Boolean

Source:
Default Value:
  • true
See:

Show or hide y axis tick line.

Type:
  • Boolean
Example
axis: {
  y: {
    tick: {
      show: false
    }
  }
}

(static) axis․y․tick․text․position :Object

Source:
Default Value:
  • {x: 0, y:0}

Set the y Axis tick text's position relatively its original position

Type:
  • Object
Example
axis: {
  y: {
    tick: {
      text: {
        position: {
          x: 10,
          y: 10
        }
      }
    }
  }
}

(static) axis․y․tick․text․show :Boolean

Source:
Default Value:
  • true
See:

Show or hide y axis tick text.

Type:
  • Boolean
Example
axis: {
  y: {
    tick: {
      text: {
          show: false
      }
    }
  }
}

(static) axis․y․tick․values :Array

Source:
Default Value:
  • null

Set y axis tick values manually.

Type:
  • Array
Example
axis: {
  y: {
    tick: {
      values: [100, 1000, 10000]
    }
  }
}

(static) axis․y․type :String

Source:
Default Value:
  • undefined

Set type of y axis.

Available Values:

  • timeseries
  • category
  • indexed
Type:
  • String
Example
axis: {
  y: {
    type: "timeseries"
  }
}

(static) bar :Object

Source:
See:
Properties:
Name Type Attributes Default Description
bar.padding Number <optional>
0

The padding pixel value between each bar.

bar.radius Number <optional>

Set the radius of bar edge in pixel.

  • NOTE: Works only for non-stacked bar
Properties
Name Type Attributes Description
ratio Number <optional>

Set the radius ratio of bar edge in relative the bar's width.

bar.sensitivity Number <optional>
2

The senstivity offset value for interaction boundary.

bar.width Number <optional>

Change the width of bar chart.

Properties
Name Type Attributes Default Description
ratio Number <optional>
0.6

Change the width of bar chart by ratio.

max Number <optional>

The maximum width value for ratio.

dataname Number <optional>

Change the width of bar for indicated dataset only.

  • NOTE:
    • Works only for non-stacked bar
    • Bars are centered accoding its total width value
Properties
Name Type Attributes Default Description
ratio Number <optional>
0.6

Change the width of bar chart by ratio.

max Number <optional>

The maximum width value for ratio.

bar.zerobased Boolean <optional>
true

Set if min or max value will be 0 on bar chart.

Set bar options

Type:
  • Object
Example
bar: {
     padding: 1,

     // the 'radius' option can be used only for non-stacking bars
     radius: 10,
     // or
     radius: {
         ratio: 0.5
     }

     // will not have offset between each bar elements for interaction
     sensitivity: 0,

     width: 10,

     // or
     width: {
         ratio: 0.2,
         max: 20
     },

     // or specify width per dataset
     width: {
         data1: 20,
         data2: {
             ratio: 0.2,
             max: 20
         }
     },

     zerobased: false
 }

(static) bindto

Source:
Default Value:
  • #chart
Properties:
Name Type Default Description
bindto String | HTMLElement | d3.selection #chart

Specify the element where chart will be drawn.

Properties
Name Type Attributes Default Description
element String | HTMLElement | d3.selection #chart

Specify the element where chart will be drawn.

classname String <optional>
bb

Specify the class name of bind element.
NOTE: When class name isn't bb, then you also need to update the default CSS to be rendered correctly.

Specify the CSS selector or the element which the chart will be set to. D3 selection object can be specified also.
If other chart is set already, it will be replaced with the new one (only one chart can be set in one element).

  • NOTE: In case of element doesn't exist or not specified, will add a <div> element to the body.
Example
bindto: "#myContainer"

// or HTMLElement
bindto: document.getElementById("myContainer")

// or D3 selection object
bindto: d3.select("#myContainer")

// or to change default classname
bindto: {
   element: "#chart",
   classname: "bill-board"  // ex) <div id='chart' class='bill-board'>
}

(static) bubble :Object

Source:
Properties:
Name Type Attributes Default Description
bubble.maxR Number | function <optional>
35

Set the max bubble radius value

Set bubble options

Type:
  • Object
Example
bubble: {
     // ex) If 100 is the highest value among data bound, the representation bubble of 100 will have radius of 50.
     // And the lesser will have radius relatively from tha max value.
     maxR: 50,

     // or set radius callback
     maxR: function(d) {
         // ex. of d param - {x: Fri Oct 06 2017 00:00:00 GMT+0900, value: 80, id: "data2", index: 5}
         ...
         return Math.sqrt(d.value * 2);
     }
 }

(static) clipPath :Boolean

Source:
Default Value:
  • true
See:

Set 'clip-path' attribute for chart element

  • NOTE:

When is false, chart node element is positioned after the axis node in DOM tree hierarchy. Is to make chart element positioned over axis element.

Type:
  • Boolean
Example
// don't set 'clip-path' attribute
clipPath: false

(static) color :Object

Source:
Properties:
Name Type Attributes Description
color.onover String | Object | function <optional>

Set the color value for each data point when mouse/touch onover event occurs.

color.pattern Array <optional>

custom color pattern

color.tiles function <optional>

if defined, allows use svg's patterns to fill data area. It should return an array of SVGPatternElement.

  • NOTE: The pattern element's id will be defined as bb-colorize-pattern-$COLOR-VALUE.
    ex. When color pattern value is ['red', '#fff'] and defined 2 patterns,then ids for pattern elements are:
    • bb-colorize-pattern-red
    • bb-colorize-pattern-fff
color.threshold Object <optional>

color threshold for gauge and tooltip color

Properties
Name Type Attributes Default Description
unit String <optional>

If set to value, the threshold will be based on the data value. Otherwise it'll be based on equation of the threshold.max option value.

values Array <optional>

Threshold values for each steps

max Number <optional>
100

The base value to determine threshold step value condition. When the given value is 15 and max 10, then the value for threshold is 15*100/10.

Set color of the data values

Type:
  • Object
Example
color: {
     pattern: ["#1f77b4", "#aec7e8", ...],

     // Set colors' patterns
     // it should return an array of SVGPatternElement
     tiles: function() {
        var pattern = document.createElementNS("http://www.w3.org/2000/svg", "pattern");
        var g = document.createElementNS("http://www.w3.org/2000/svg", "g");
        var circle1 = document.createElementNS("http://www.w3.org/2000/svg", "circle");

        pattern.setAttribute("patternUnits", "userSpaceOnUse");
        pattern.setAttribute("width", "32");
        pattern.setAttribute("height", "32");

        g.style.fill = "#000";
        g.style.opacity = "0.2";

        circle1.setAttribute("cx", "3");
        circle1.setAttribute("cy", "3");
        circle1.setAttribute("r", "3");

        g.appendChild(circle1);
        pattern.appendChild(g);

        return [pattern];
     },

     // for threshold usage, pattern values should be set for each steps
     pattern: ["grey", "green", "yellow", "orange", "red"],
     threshold: {
         unit: "value",

         // when value is 20 => 'green', value is 40 => 'orange' will be set.
         values: [10, 20, 30, 40, 50],

         // the equation for max:
         // - unit == 'value': max => 30
         // - unit != 'value': max => value*100/30
         max: 30
     },

     // set all data to 'red'
     onover: "red",

     // set different color for data
     onover: {
         data1: "red",
         data2: "yellow"
     },

     // will pass data object to the callback
     onover: function(d) {
         return d.id === "data1" ? "red" : "green";
     }
 }

(static) data․axes :Object

Source:
Default Value:
  • {}

Set y axis the data related to. y and y2 can be used.

Type:
  • Object
Example
data: {
  axes: {
    data1: "y",
    data2: "y2"
  }
}

(static) data․classes :Object

Source:
Default Value:
  • {}

Set custom data class.

If this option is specified, the element g for the data has an additional class that has the prefix 'bb-target-' (eg. bb-target-additional-data1-class).

Type:
  • Object
Example
data: {
  classes: {
    data1: "additional-data1-class",
    data2: "additional-data2-class"
  }
}

(static) data․color :function

Source:
Default Value:
  • undefined
See:

Set color converter function.

This option should a function and the specified function receives color (e.g. '#ff0000') and d that has data parameters like id, value, index, etc. And it must return a string that represents color (e.g. '#00ff00').

Type:
  • function
Example
data: {
  color: function(color, d) { ... }
}

(static) data․colors :Object

Source:
Default Value:
  • {}

Set color for each data.

Type:
  • Object
Example
data: {
  colors: {
    data1: "#ff0000",
    data2: function(d) {
       return "#000";
    }
    ...
  }
}

(static) data․columns :Array

Source:
Default Value:
  • undefined
See:

Load data from a multidimensional array, with each element containing an array consisting of a datum name and associated data values.

Type:
  • Array
Example
data: {
  columns: [
     ["data1", 30, 20, 50, 40, 60, 50],
     ["data2", 200, 130, 90, 240, 130, 220],
     ["data3", 300, 200, 160, 400, 250, 250]
  ]
}

// for 'range' types('area-line-range' or 'area-spline-range'), data should contain:
// - an array of [high, mid, low] data following the order
// - or an object with 'high', 'mid' and 'low' key value
data: {
  columns: [
     ["data1",
         [150, 140, 110],  // or {high:150, mid: 140, low: 110}
         [150, 140, 110],
         [150, 140, 110]
     ]
  ],
  type: "area-line-range"
}

// for 'bubble' type, data can contain dimension value:
// - an array of [y, z] data following the order
// - or an object with 'y' and 'z' key value
// 'y' is for y axis coordination and 'z' is the bubble radius value
data: {
  columns: [
     ["data1",
         [10, 140],  // or {y:10, z: 140}
         [100, 30],
         [50, 100]
     ]
  ],
  type: "bubble"
}

(static) data․empty․label․text :String

Source:
Default Value:
  • ""

Set text label to be displayed when there's no data to show.

  • ex. Toggling all visible data to not be shown, unloading all current data, etc.
Type:
  • String
Example
data: {
  empty: {
    label: {
      text: "No Data"
    }
  }
}

(static) data․filter :function

Source:
Default Value:
  • undefined
See:

Filter values to be shown The data value is the same as the returned by .data().

Type:
  • function
Example
data: {
  // filter for id value
  filter: function(v) {
     // v: [{id: "data1", id_org: "data1", values: [
     //      {x: 0, value: 130, id: "data2", index: 0}, ...]
     //    }, ...]
     return v.id !== "data1";
  }

(static) data․groups :Array

Source:
Default Value:
  • []

Set groups for the data for stacking.

Type:
  • Array
Example
data: {
  groups: [
    ["data1", "data2"],
    ["data3"]
  ]
}

(static) data․headers :String

Source:
Default Value:
  • undefined
See:

XHR header value

  • NOTE: Should be used with data.url option
Type:
  • String
Example
data: {
    url: "/data/test.csv",
    headers: {
       "Content-Type": "text/xml",
       ...
    }
}

(static) data․hide :Boolean|Array

Source:
Default Value:
  • false

Hide each data when the chart appears.

If true specified, all of data will be hidden. If multiple ids specified as an array, those will be hidden.

Type:
  • Boolean | Array
Example
data: {
  // all of data will be hidden
  hide: true

  // specified data will be hidden
  hide: ["data1", ...]
}

(static) data․idConverter :function

Source:
Default Value:
  • function(id) { return id; }

Converts data id value

Type:
  • function
Example
data: {
   idConverter: function(id) {
      // when id is 'data1', converts to be 'data2'
      // 'data2' should be given as the initial data value
      if (id === "data1") {
         return "data2";
      } else {
         return id;
      }
   }
}

(static) data․json :Object

Source:
Default Value:
  • undefined
See:

Parse a JSON object for data. See also data.keys.

Type:
  • Object
Example
data: {
    json: [
      {name: "www.site1.com", upload: 200, download: 200, total: 400},
      {name: "www.site2.com", upload: 100, download: 300, total: 400},
      {name: "www.site3.com", upload: 300, download: 200, total: 500},
      {name: "www.site4.com", upload: 400, download: 100, total: 500}
    ],
    keys: {
      // x: "name", // it's possible to specify 'x' when category axis
      value: ["upload", "download"]
    }
}

(static) data․keys :String

Source:
Default Value:
  • undefined

Choose which JSON object keys correspond to desired data.

  • NOTE: Only for JSON object given as array.
Type:
  • String
Example
data: {
    json: [
      {name: "www.site1.com", upload: 200, download: 200, total: 400},
      {name: "www.site2.com", upload: 100, download: 300, total: 400},
      {name: "www.site3.com", upload: 300, download: 200, total: 500},
      {name: "www.site4.com", upload: 400, download: 100, total: 500}
    ],
    keys: {
      // x: "name", // it's possible to specify 'x' when category axis
      value: ["upload", "download"]
    }
}

(static) data․labels :Object

Source:
Default Value:
  • {}
See:
Properties:
Name Type Attributes Default Description
data.labels Boolean <optional>
false

Show or hide labels on each data points

Properties
Name Type Attributes Default Description
centered Boolean <optional>
false

Centerize labels on bar shape. (NOTE: works only for 'bar' type)

format function <optional>

Set formatter function for data labels.
The formatter function receives 4 arguments such as v, id, i, j and it must return a string that will be shown as the label. The arguments are:

  • v is the value of the data point where the label is shown.
  • id is the id of the data where the label is shown.
  • i is the index of the data point where the label is shown.
  • j is the sub index of the data point where the label is shown.

    Formatter function can be defined for each data by specifying as an object and D3 formatter function can be set (ex. d3.format('$'))
colors String | Object <optional>

Set label text colors.

position.x Number <optional>
0

x coordinate position, relative the original.

position.y NUmber <optional>
0

y coordinate position, relative the original.

Set labels options

Type:
  • Object
Example
data: {
  labels: true,

  // or set specific options
  labels: {
    format: function(v, id, i, j) { ... },

    // it's possible to set for each data
    format: {
        data1: function(v, id, i, j) { ... },
        ...
    },

    // align text to center of the 'bar' shape (works only for 'bar' type)
    centered: true,

    // apply for all label texts
    colors: "red",

    // or set different colors per dataset
    // for not specified dataset, will have the default color value
    colors: {
       data1: "yellow",
       data3: "green"
    },

    // set x, y coordinate position
    position: {
       x: -10,
       y: 10
    }
  }
}

(static) data․mimeType :String

Source:
Default Value:
  • undefined

Used if loading JSON via data.url.

Type:
  • String
Example
data: {
    mimeType: "json"
}

(static) data․names :Object

Source:
Default Value:
  • {}
See:

Set custom data name.

Type:
  • Object
Example
data: {
  names: {
    data1: "Data Name 1",
    data2: "Data Name 2"
  }
}

(static) data․onclick :function

Source:
Default Value:
  • function() {}

Set a callback for click event on each data point.

This callback will be called when each data point clicked and will receive d and element as the arguments. d is the data clicked and element is the element clicked. In this callback, this will be the Chart object.

Type:
  • function
Example
data: {
    onclick: function(d, element) { ... }
}

(static) data․onmax :function

Source:
Default Value:
  • undefined
See:

Set a callback for maximum data

  • NOTE: For 'area-line-range' and 'area-spline-range', mid data will be taken for the comparison
Type:
  • function
Example
onmax: function(data) {
   // data - ex) [{x: 3, value: 400, id: "data1", index: 3}, ... ]
   ...
 }

(static) data․onmin :function

Source:
Default Value:
  • undefined
See:

Set a callback for minimum data

  • NOTE: For 'area-line-range' and 'area-spline-range', mid data will be taken for the comparison
Type:
  • function
Example
onmin: function(data) {
   // data - ex) [{x: 3, value: 400, id: "data1", index: 3}, ... ]
   ...
 }

(static) data․onout :function

Source:
Default Value:
  • function() {}

Set a callback for mouse/touch out event on each data point.

This callback will be called when mouse cursor or via touch moves out each data point and will receive d as the argument. d is the data where mouse cursor moves out. In this callback, this will be the Chart object.

Type:
  • function
Example
data: {
    onout: function(d) { ... }
}

(static) data․onover :function

Source:
Default Value:
  • function() {}

Set a callback for mouse/touch over event on each data point.

This callback will be called when mouse cursor or via touch moves onto each data point and will receive d as the argument. d is the data where mouse cursor moves onto. In this callback, this will be the Chart object.

Type:
  • function
Example
data: {
    onover: function(d) { ... }
}

(static) data․onselected :function

Source:
Default Value:
  • function() {}

Set a callback for on data selection.

Type:
  • function
Example
data: {
    onselected: function(d, element) {
       // d - ex) {x: 4, value: 150, id: "data1", index: 4, name: "data1"}
       // element - <circle>
       ...
   }
}

(static) data․onunselected :function

Source:
Default Value:
  • function() {}

Set a callback for on data un-selection.

Type:
  • function
Example
data: {
    onunselected: function(d, element) {
       // d - ex) {x: 4, value: 150, id: "data1", index: 4, name: "data1"}
       // element - <circle>
       ...
   }
}

(static) data․order :String|function|null

Source:
Default Value:
  • desc
See:

This option changes the order of stacking data and pieces of pie/donut.

Available Values:

  • desc: In descending order
  • asc: In ascending order
  • null: It keeps the data load order
  • function(data1, data2) { ... }: Array.sort compareFunction
Type:
  • String | function | null
Example
data: {
  // in descending order (default)
  order: "desc"

  // in ascending order
  order: "asc"

  // keeps data input order
  order: null

  // specifying sort function
  order: function(a, b) {
      // param data passed format
      {
         id: "data1", id_org: "data1", values: [
             {x: 5, value: 250, id: "data1", index: 5, name: "data1"},
             ...
         ]
      }
  }
}

(static) data․regions :Object

Source:
Default Value:
  • {}

Define regions for each data.
The values must be an array for each data and it should include an object that has start, end and style.

  • The object type should be as:
    • start {Number}: Start data point number. If not set, the start will be the first data point.
    • [end] {Number}: End data point number. If not set, the end will be the last data point.
    • [style.dasharray="2 2"] {Object}: The first number specifies a distance for the filled area, and the second a distance for the unfilled area.
  • NOTE: Currently this option supports only line chart and dashed style. If this option specified, the line will be dashed only in the regions.
Type:
  • Object
Example
data: {
  regions: {
    data1: [{
        start: 1,
        end: 2,
        style: {
            dasharray: "5 2"
        }
    }, {
        start: 3
    }],
    ...
  }
}

(static) data․rows :Array

Source:
Default Value:
  • undefined
See:

Load data from a multidimensional array, with the first element containing the data names, the following containing related data in that order.

Type:
  • Array
Example
data: {
  rows: [
    ["A", "B", "C"],
    [90, 120, 300],
    [40, 160, 240],
    [50, 200, 290],
    [120, 160, 230],
    [80, 130, 300],
    [90, 220, 320]
  ]
}

// for 'range' types('area-line-range' or 'area-spline-range'), data should contain:
// - an array of [high, mid, low] data following the order
// - or an object with 'high', 'mid' and 'low' key value
data: {
  rows: [
     ["data1", "data2"],
     [
       // or {high:150, mid: 140, low: 110}, 120
       [150, 140, 110], 120
     ],
     [[155, 130, 115], 55],
     [[160, 135, 120], 60]
  ],
  types: {
      data1: "area-line-range",
      data2: "line"
  }
}

// for 'bubble' type, data can contain dimension value:
// - an array of [y, z] data following the order
// - or an object with 'y' and 'z' key value
// 'y' is for y axis coordination and 'z' is the bubble radius value
data: {
  rows: [
     ["data1", "data2"],
     [
       // or {y:10, z: 140}, 120
       [10, 140], 120
     ],
     [[100, 30], 55],
     [[50, 100], 60]
  ],
  types: {
      data1: "bubble",
      data2: "line"
  }
}

(static) data․selection․draggable :Boolean

Source:
Default Value:
  • false

Enable to select data points by dragging. If this option set true, data points can be selected by dragging.

  • NOTE: If this option set true, scrolling on the chart will be disabled because dragging event will handle the event.
Type:
  • Boolean
Example
data: {
   selection: {
      draggable: true
  }
}

(static) data․selection․enabled :Boolean

Source:
Default Value:
  • false
See:

Set data selection enabled

If this option is set true, we can select the data points and get/set its state of selection by API (e.g. select, unselect, selected).

Type:
  • Boolean
Example
data: {
   selection: {
      enabled: true
   }
}

(static) data․selection․grouped :Boolean

Source:
Default Value:
  • false

Set grouped selection enabled.

If this option set true, multiple data points that have same x value will be selected by one selection.

Type:
  • Boolean
Example
data: {
   selection: {
      grouped: true
   }
}

(static) data․selection․isselectable :function

Source:
Default Value:
  • function() { return true; }

Set a callback for each data point to determine if it's selectable or not.

The callback will receive d as an argument and it has some parameters like id, value, index. This callback should return boolean.

Type:
  • function
Example
data: {
   selection: {
      isselectable: function(d) { ... }
   }
}

(static) data․selection․multiple :Boolean

Source:
Default Value:
  • true

Set multiple data points selection enabled.

If this option set true, multile data points can have the selected state at the same time. If false set, only one data point can have the selected state and the others will be unselected when the new data point is selected.

Type:
  • Boolean
Example
data: {
   selection: {
      multiple: false
   }
}

(static) data․stack․normalize :Boolean

Source:
Default Value:
  • false
See:

Set the stacking to be normalized

  • NOTE:
    • For stacking, 'data.groups' option should be set
    • y Axis will be set in percentage value (0 ~ 100%)
    • Must have postive values
Type:
  • Boolean
Example
data: {
  stack: {
     normalize: true
  }
}

(static) data․type :String

Source:
Default Value:
  • line

Set chart type at once.

If this option is specified, the type will be applied to every data. This setting can be overwritten by data.types.

Available Values:

  • area
  • area-line-range
  • area-spline
  • area-spline-range
  • area-step
  • bar
  • bubble
  • donut
  • gauge
  • line
  • pie
  • radar
  • scatter
  • spline
  • step
Type:
  • String
Example
data: {
   type: "bar"
}

(static) data․types :Object

Source:
Default Value:
  • {}

Set chart type for each data.
This setting overwrites data.type setting.

  • NOTE: radar type can't be combined with other types.
Type:
  • Object
Example
data: {
  types: {
    data1: "bar",
    data2: "spline"
  }
}

(static) data․url :String

Source:
Default Value:
  • undefined
See:

Load a CSV or JSON file from a URL. NOTE that this will not work if loading via the "file://" protocol as the most browsers will block XMLHTTPRequests.

Type:
  • String
Example
data: {
    url: "/data/test.csv"
}

(static) data․x :String

Source:
Default Value:
  • undefined

Specify the key of x values in the data.

We can show the data with non-index x values by this option. This option is required when the type of x axis is timeseries. If this option is set on category axis, the values of the data on the key will be used for category names.

Type:
  • String
Example
data: {
  x: "date"
}

(static) data․xFormat :String

Source:
Default Value:
  • %Y-%m-%d
See:

Set a format specifier to parse string specifed as x.

Type:
  • String
Example
data: {
   x: "x",
   columns: [
       ["x", "01012019", "02012019", "03012019"],
       ["data1", 30, 200, 100]
   ],
   // Format specifier to parse as datetime for given 'x' string value
   xFormat: "%m%d%Y"
},
axis: {
   x: {
       type: "timeseries"
   }
}

(static) data․xLocaltime :Boolean

Source:
Default Value:
  • true

Set localtime format to parse x axis.

Type:
  • Boolean
Example
data: {
  xLocaltime: false
}

(static) data․xs :Object

Source:
Default Value:
  • {}

Specify the keys of the x values for each data.

This option can be used if we want to show the data that has different x values.

Type:
  • Object
Example
data: {
  xs: {
     data1: "x1",
     data2: "x2"
  }
}

(static) data․xSort :Boolean

Source:
Default Value:
  • true

Sort on x axis.

Type:
  • Boolean
Example
data: {
  xSort: false
}

(static) donut :Object

Source:
Properties:
Name Type Attributes Default Description
donut.label.show Boolean <optional>
true

Show or hide label on each donut piece.

donut.label.format function <optional>

Set formatter for the label on each donut piece.

donut.label.threshold Number <optional>
0.05

Set threshold to show/hide labels.

donut.label.ratio Number | function <optional>

Set ratio of labels position.

donut.expand Boolean <optional>
true

Enable or disable expanding donut pieces.

donut.width Number <optional>

Set width of donut chart.

donut.title String <optional>
""

Set title of donut chart. Use \n character to enter line break.

donut.padAngle Number <optional>
0

Set padding between data.

Set donut options

Type:
  • Object
Example
donut: {
     label: {
         show: false,
         format: function(value, ratio, id) {
             return d3.format("$")(value);

             // to multiline, return with '\n' character
             // return value +"%\nLine1\n2Line2";
         },
         threshold: 0.1,

         // set ratio callback. Should return ratio value
         ratio: function(d, radius, h) {
         	...
         	return ratio;
         },
         // or set ratio number
         ratio: 0.5
     },
     expand: false,
     width: 10,
     padAngle: 0.2,
     title: "Donut Title"

     // title with line break
     title: "Title1\nTitle2"
 }

(static) gauge :Object

Source:
Properties:
Name Type Attributes Default Description
gauge.fullCircle Boolean <optional>
false

Show full circle as donut. When set to 'true', the max label will not be showed due to start and end points are same location.

gauge.label.show Boolean <optional>
true

Show or hide label on gauge.

gauge.label.format function <optional>

Set formatter for the label on gauge. Label text can be multilined with \n character.

gauge.label.extents function <optional>

Set customized min/max label text.

gauge.expand Boolean <optional>
true

Enable or disable expanding gauge.

Properties
Name Type Attributes Default Description
duration Number <optional>
50

Set the expand transition time in milliseconds.

gauge.min Number <optional>
0

Set min value of the gauge.

gauge.max Number <optional>
100

Set max value of the gauge.

gauge.startingAngle Number <optional>
-1 * Math.PI / 2
gauge.title String <optional>
""

Set title of gauge chart. Use \n character to enter line break.

gauge.units String <optional>

Set units of the gauge.

gauge.width Number <optional>

Set width of gauge chart.

Set gauge options

Type:
  • Object
Example
gauge: {
     fullCircle: false,
     label: {
         show: false,
         format: function(value, ratio) {
             return value;

             // to multiline, return with '\n' character
             // return value +"%\nLine1\n2Line2";
         },
         extents: function(value, isMax) {
             return (isMax ? "Max:" : "Min:") + value;
         }
     },
     expand: false,

     // or set duration
     expand: {
         duration: 20
     },
     min: -100,
     max: 200,
     title: "Title Text",
     units: "%",
     width: 10
 }

(static) grid :Object

Source:
Default Value:
  • undefined
See:
Properties:
Name Type Attributes Default Description
front Boolean <optional>
false

Set 'grid & focus lines' to be positioned over grid lines and chart elements.

x.show Boolean <optional>
false

Show grids along x axis.

x.lines Array <optional>
[]

Show additional grid lines along x axis.
This option accepts array including object that has value, text, position and class. text, position and class are optional. For position, start, middle and end (default) are available. If x axis is category axis, value can be category name. If x axis is timeseries axis, value can be date string, Date object and unixtime integer.

y.show Boolean <optional>
false

Show grids along x axis.

y.lines Array <optional>
[]

Show additional grid lines along y axis.
This option accepts array including object that has value, text, position and class.

y.ticks Number <optional>
10

Number of y grids to be shown.

focus.show Boolean <optional>
true

Show grids when focus.

lines.front Boolean <optional>
true

Set grid lines to be positioned over chart elements.

Set related options

Type:
  • Object
Example
grid: {
  x: {
    show: true,
    lines: [
      {value: 2, text: "Label on 2"},
      {value: 5, text: "Label on 5", class: "label-5"},
      {value: 6, text: "Label on 6", position: "start"}
    ]
  },
  y: {
    show: true,
    lines: [
      {value: 100, text: "Label on 100"},
      {value: 200, text: "Label on 200", class: "label-200"},
      {value: 300, text: "Label on 300", position: 'middle'}
    ],
    ticks: 5
  },
  front: true,
  focus: {
     show: false
  },
  lines: {
     front: false
  }
}

(static) interaction :Object

Source:
See:
Properties:
Name Type Attributes Default Description
interaction.enabled Boolean <optional>
true

Indicate if the chart should have interactions.
If false is set, all of interactions (showing/hiding tooltip, selection, mouse events, etc) will be disabled.

interaction.brighten Boolean <optional>
true

Make brighter for the selected area (ex. 'pie' type data selected area)

interaction.inputType.mouse Boolean <optional>
true

enable or disable mouse interaction

interaction.inputType.touch Boolean <optional>
true

enable or disable touch interaction

Properties
Name Type Attributes Default Description
preventDefault Boolean | Number <optional>
false

enable or disable to call event.preventDefault on touchstart & touchmove event. It's usually used to prevent document scrolling.

Interaction options

Type:
  • Object
Example
interaction: {
   enabled: false,
   brighten: false,
   inputType: {
       mouse: true,
       touch: false

       // or declare preventDefault explicitly.
       // In this case touch inputType is enabled by default
       touch: {
           preventDefault: true

           // or threshold pixel value (pixel moved from touchstart to touchmove)
           preventDefault: 5
       }
   }
}

(static) legend :Object

Source:
See:
Properties:
Name Type Attributes Default Description
legend.show Boolean <optional>
true

Show or hide legend.

legend.hide Boolean <optional>
false

Hide legend If true given, all legend will be hidden. If string or array given, only the legend that has the id will be hidden.

legend.contents.bindto String | HTMLElement <optional>

Set CSS selector or element reference to bind legend items.

legend.contents.template String | function <optional>

Set item's template.

  • If set string value, within template the 'color' and 'title' can be replaced using template-like syntax string:
    • {=COLOR}: data color value
    • {=TITLE}: data title value
  • If set function value, will pass following arguments to the given function:
  • title {String}: data's id value
  • color {String}: color string
  • data {Array}: data array
legend.position String <optional>
bottom

Change the position of legend.
Available values are: bottom, right and inset are supported.

legend.inset Object <optional>
{anchor: 'top-left',x: 10,y: 0,step: undefined}

Change inset legend attributes.
This option accepts object that has the keys anchor, x, y and step.

  • anchor decides the position of the legend:
  • top-left
  • top-right
  • bottom-left
  • bottom-right
  • x and y:
  • set the position of the legend based on the anchor.
  • step:
  • defines the max step the legend has (e.g. If 2 set and legend has 3 legend item, the legend 2 columns).
legend.equally Boolean <optional>
false

Set to all items have same width size.

legend.padding Boolean <optional>
0

Set padding value

legend.item.onclick function <optional>

Set click event handler to the legend item.

legend.item.onover function <optional>

Set mouse/touch over event handler to the legend item.

legend.item.onout function <optional>

Set mouse/touch out event handler to the legend item.

legend.item.tile.width Number <optional>
10

Set width of item tile element

legend.item.tile.height Number <optional>
10

Set height of item tile element

legend.usePoint Boolean <optional>
false

Whether to use custom points in legend.

Legend options

Type:
  • Object
Example
legend: {
     show: true,
     hide: true,
     //or hide: "data1"
     //or hide: ["data1", "data2"]
     contents: {
         bindto: "#legend",   // <ul id='legend'></ul>

         // will be as: <li style='background-color:#1f77b4'>data1</li>
         template: "<li style='background-color:{=COLOR}'>{=TITLE}</li>"

         // or using function
         template: function(id, color, data) {
              // if you want omit some legend, return falsy value
              if (title !== "data1") {
                   return "<li style='background-color:"+ color +">"+ title +"</li>";
              }
         }
     },
     position: "bottom",  // bottom, right, inset
     inset: {
         anchor: "top-right"  // top-left, top-right, bottom-left, bottom-right
         x: 20,
         y: 10,
         step: 2
     },
     equally: false,
     padding: 10,
     item: {
         onclick: function(id) { ... },
         onover: function(id) { ... },
         onout: function(id) { ... },

         // set tile's size
         tile: {
             width: 20,
             height: 15
         }
     },
     usePoint: true
 }

(static) line :Object

Source:
Properties:
Name Type Attributes Default Description
line.connectNull Boolean <optional>
false

Set if null data point will be connected or not.
If true set, the region of null data will be connected without any data point. If false set, the region of null data will not be connected and get empty.

line.classes Array <optional>

If set, used to set a css class on each line.

line.step.type Boolean <optional>
step

Change step type for step chart.
Available values:

  • step
  • step-before
  • step-after
line.point Boolean | Array <optional>
true

Set to false to not draw points on linecharts. Or pass an array of line ids to draw points for.

Set line options

Type:
  • Object
Example
line: {
     connectNull: true,
     classes: [
         "line-class1",
         "line-class2"
     ],
     step: {
         type: "step-after"
     },

     // hide all data points ('point.show=false' also has similar effect)
     point: false,

     // show data points for only indicated datas
     point: [
         "data1", "data3"
     ]
 }

(static) onafterinit :function

Source:
Default Value:
  • undefined

Set a callback to execute after the chart is initialized

Type:
  • function
Example
// @param {Chart} ctx - Instance itself
onafterinit: function(ctx) {
  ...
}

(static) onbeforeinit :function

Source:
Default Value:
  • undefined

Set a callback to execute before the chart is initialized

Type:
  • function
Example
// @param {Chart} ctx - Instance itself
onbeforeinit: function(ctx) {
  ...
}

(static) oninit :function

Source:
Default Value:
  • undefined

Set a callback to execute when the chart is initialized.

Type:
  • function
Example
// @param {Chart} ctx - Instance itself
oninit: function(ctx) {
  ...
}

(static) onout :function

Source:
Default Value:
  • undefined

Set a callback to execute when mouse/touch leaves the chart.

Type:
  • function
Example
// @param {Chart} ctx - Instance itself
onout: function(ctx) {
  ...
}

(static) onover :function

Source:
Default Value:
  • undefined

Set a callback to execute when mouse/touch enters the chart.

Type:
  • function
Example
// @param {Chart} ctx - Instance itself
onover: function(ctx) {
  ...
}

(static) onrendered :function

Source:
Default Value:
  • undefined

Set a callback which is executed when the chart is rendered. Basically, this callback will be called in each time when the chart is redrawed.

Type:
  • function
Example
// @param {Chart} ctx - Instance itself
onrendered: function(ctx) {
  ...
}

(static) onresize :function

Source:
Default Value:
  • undefined

Set a callback to execute when user resizes the screen.

Type:
  • function
Example
// @param {Chart} ctx - Instance itself
onresize: function(ctx) {
  ...
}

(static) onresized :function

Source:
Default Value:
  • undefined

SSet a callback to execute when screen resize finished.

Type:
  • function
Example
// @param {Chart} ctx - Instance itself
onresized: function(ctx) {
  ...
}

(static) padding :Object

Source:
Properties:
Name Type Attributes Description
padding.top Number <optional>

padding on the top of chart

padding.right Number <optional>

padding on the right of chart

padding.bottom Number <optional>

padding on the bottom of chart

padding.left Number <optional>

padding on the left of chart

The padding of the chart element.

Type:
  • Object
Example
padding: {
  top: 20,
  right: 20,
  bottom: 20,
  left: 20
}

(static) pie :Object

Source:
Properties:
Name Type Attributes Default Description
pie.label.show Boolean <optional>
true

Show or hide label on each pie piece.

pie.label.format function <optional>

Set formatter for the label on each pie piece.

pie.label.threshold Number <optional>
0.05

Set threshold to show/hide labels.

pie.label.ratio Number | function <optional>

Set ratio of labels position.

pie.expand Boolean | Object <optional>
true

Enable or disable expanding pie pieces.

Properties
Name Type Attributes Default Description
duration Number <optional>
50

Set expand transition time in ms.

pie.innerRadius Number | Object <optional>
0

Sets the inner radius of pie arc.

pie.padAngle Number <optional>
0

Set padding between data.

pie.padding Number <optional>
0

Sets the gap between pie arcs.

Set pie options

Type:
  • Object
Example
pie: {
     label: {
         show: false,
         format: function(value, ratio, id) {
             return d3.format("$")(value);

             // to multiline, return with '\n' character
             // return value +"%\nLine1\n2Line2";
         },
         threshold: 0.1,

         // set ratio callback. Should return ratio value
         ratio: function(d, radius, h) {
             ...
             return ratio;
         },
         // or set ratio number
         ratio: 0.5
     },

     // disable expand transition for interaction
     expand: false,

     // set duration of expand transition to 500ms.
     expand: {
         duration: 500
     },

     innerRadius: 0,

     // set different innerRadius for each data
     innerRadius: {
     	data1: 10,
     	data2: 0
     }

     padAngle: 0.1,
     padding: 0
 }

(static) plugins :Array

Source:

Set plugins

Type:
  • Array
Example
plugins: [
   new bb.plugin.stanford({ ... }),
   new PluginA(),
   ...
]

(static) point :Object

Source:
See:
Properties:
Name Type Attributes Default Description
point.show Boolean <optional>
true

Whether to show each point in line.

point.r Number | function <optional>
2.5

The radius size of each point.

  • NOTE: Disabled for 'bubble' type
point.focus.expand.enabled Boolean <optional>
true

Whether to expand each point on focus.

point.focus.expand.r Number <optional>
point.r*1.75

The radius size of each point on focus.

  • NOTE: For 'bubble' type, the default is bubbleSize*1.15
point.sensitivity Number <optional>
10

The senstivity value for interaction boundary.

point.select.r Number <optional>
point.r*4

The radius size of each point on selected.

point.type String <optional>
"circle"

The type of point to be drawn

  • NOTE:
  • If chart has 'bubble' type, only circle can be used.
  • For IE, non circle point expansions are not supported due to lack of transform support.
  • Available Values:
  • circle
  • rectangle
point.pattern Array <optional>
[]

The type of point or svg shape as string, to be drawn for each line

  • NOTE:
  • This is an experimental feature and can have some unexpected behaviors.
  • If chart has 'bubble' type, only circle can be used.
  • For IE, non circle point expansions are not supported due to lack of transform support.
  • Available Values:
  • circle
  • rectangle
  • svg shape tag interpreted as string
    (ex. <polygon points='2.5 0 0 5 5 5'></polygon>)

Set point options

Type:
  • Object
Example
point: {
     show: false,
     r: 5,

     // or customize the radius
     r: function(d) {
         ...
         return r;
     },

     focus: {
         expand: {
             enabled: true,
             r: 1
         }
     },
     select: {
         r: 3
     },

     // having lower value, means how closer to be for interaction
     sensitivity: 3,

     // valid values are "circle" or "rectangle"
     type: "rectangle",

     // or indicate as pattern
     pattern: [
       "circle",
       "rectangle",
       "<polygon points='0 6 4 0 -4 0'></polygon>"
    ],
 }

(static) radar :Object

Source:
See:
Properties:
Name Type Attributes Default Description
radar.axis.max Number <optional>

The max value of axis. If not given, it'll take the max value from the given data.

radar.axis.line.show Boolean <optional>
true

Show or hide axis line.

radar.axis.text.position.x Number <optional>
0

x coordinate position, relative the original.

radar.axis.text.position.y NUmber <optional>
0

y coordinate position, relative the original.

radar.axis.text.show Boolean <optional>
true

Show or hide axis text.

radar.direction.clockwise Boolean <optional>
false

Set the direction to be drawn.

radar.level.depth Number <optional>
3

Set the level depth.

radar.level.show Boolean <optional>
true

Show or hide level.

radar.level.text.format function <optional>
(x) => (x % 1 === 0 ? x : x.toFixed(2))

Set format function for the level value.

radar.level.text.show Boolean <optional>
true

Show or hide level text.

radar.size.ratio Number <optional>
0.87

Set size ratio.

Set radar options

  • NOTE:

When x tick text contains \n, it's used as line break.

Type:
  • Object
Example
radar: {
     axis: {
         max: 50,
         line: {
             show: false
         },
         text: {
             position: {
             	x: 0,
             	y: 0
             },
             show: false
         }
     },
     direction: {
         clockwise: true
     },
     level: {
         show: false,
         text: {
             format: function(x) {
                 return x + "%";
             },
             show: true
         }
     },
     size: {
         ratio: 0.7
     }
 }

(static) regions :Array

Source:
Default Value:
  • []

Show rectangles inside the chart.

This option accepts array including object that has axis, start, end and class. The keys start, end and class are optional. axis must be x, y or y2. start and end should be the value where regions start and end. If not specified, the edge values will be used. If timeseries x axis, date string, Date object and unixtime integer can be used. If class is set, the region element will have it as class.

Type:
  • Array
Example
regions: [
   {
     axis: "x",
     start: 1,
     end: 4,
     class: "region-1-4"
   }
 ]

(static) resize :Object

Source:
Properties:
Name Type Attributes Default Description
resize.auto Boolean <optional>
true

Set chart resize automatically on viewport changes.

Set chart resize options

Type:
  • Object
Example
resize: {
     auto: false
 }

(static) size :Object

Source:
See:
Properties:
Name Type Attributes Description
size.width Number <optional>

width of the chart element

size.height Number <optional>

height of the chart element

The desired size of the chart element. If value is not specified, the width of the chart will be calculated by the size of the parent element it's appended to.

Type:
  • Object
Example
size: {
  width: 640,
  height: 480
}

(static) spline :Object

Source:
See:
Properties:
Name Type Attributes Default Description
spline.interpolation.type String <optional>
"cardinal"

Set spline options

  • Available interpolation type values:
  • basis (d3.curveBasis)
  • basis-closed (d3.curveBasisClosed)
  • basis-open (d3.curveBasisOpen)
  • bundle (d3.curveBundle)
  • cardinal (d3.curveCardinal)
  • cardinal-closed (d3.curveCardinalClosed)
  • cardinal-open (d3.curveCardinalOpen)
  • catmull-rom (d3.curveCatmullRom)
  • catmull-rom-closed (d3.curveCatmullRomClosed)
  • catmull-rom-open (d3.curveCatmullRomOpen)
  • monotone-x (d3.curveMonotoneX)
  • monotone-y (d3.curveMonotoneY)
  • natural (d3.curveNatural)
  • linear-closed (d3.curveLinearClosed)
  • linear (d3.curveLinear)
  • step (d3.curveStep)
  • step-after (d3.curveStepAfter)
  • step-before (d3.curveStepBefore)
Type:
  • Object
Example
spline: {
     interpolation: {
         type: "cardinal"
     }
 }

(static) subchart :Object

Source:
See:
Properties:
Name Type Attributes Default Description
subchart.show Boolean <optional>
false

Show sub chart on the bottom of the chart.

subchart.axis.x.show Boolean <optional>
true

Show or hide x axis.

subchart.axis.x.tick.show Boolean <optional>
true

Show or hide x axis tick line.

subchart.axis.x.tick.text.show Boolean <optional>
true

Show or hide x axis tick text.

subchart.size.height Number <optional>

Change the height of the subchart.

subchart.onbrush function <optional>

Set callback for brush event.
Specified function receives the current zoomed x domain.

Set subchart options

Type:
  • Object
Example
subchart: {
		axis: {
			x: {
				show: true,
				tick: {
					show: true,
					text: {
						show: false
					}
				}
			}
		},
     show: true,
     size: {
         height: 20
     },
     onbrush: function(domain) { ... }
 }

(static) svg :Object

Source:
Properties:
Name Type Attributes Description
svg.classname String <optional>

class name for svg element

Set svg element's class name

Type:
  • Object
Example
svg: {
  classname: "test_class"
}

(static) title :Object

Source:
See:
Properties:
Name Type Attributes Default Description
title.text String <optional>

Title text. If contains \n, it's used as line break allowing multiline title.

title.padding.top Number <optional>
0

Top padding value.

title.padding.right Number <optional>
0

Right padding value.

title.padding.bottom Number <optional>
0

Bottom padding value.

title.padding.left Number <optional>
0

Left padding value.

title.position String <optional>
center

Available values are: 'center', 'right' and 'left'.

Set title options

Type:
  • Object
Example
title: {
     text: "Title Text",

     // or Multiline title text
     text: "Main title text\nSub title text",

     padding: {
         top: 10,
         right: 10,
         bottom: 10,
         left: 10
     },
     position: "center"
 }

(static) tooltip :Object

Source:
See:
Properties:
Name Type Attributes Default Description
tooltip.show Boolean <optional>
true

Show or hide tooltip.

tooltip.doNotHide Boolean <optional>
false

Make tooltip keep showing not hiding on interaction.

tooltip.grouped Boolean <optional>
true

Set if tooltip is grouped or not for the data points.

  • NOTE: The overlapped data points will be displayed as grouped even if set false.
tooltip.linked Boolean <optional>
false

Set if tooltips on all visible charts with like x points are shown together when one is shown.

Properties
Name Type Attributes Default Description
name String <optional>
""

Groping name for linked tooltip.
If specified, linked tooltip will be groped interacting to be worked only with the same name.

tooltip.format.title function <optional>

Set format for the title of tooltip.
Specified function receives x of the data point to show.

tooltip.format.name function <optional>

Set format for the name of each data in tooltip.
Specified function receives name, ratio, id and index of the data point to show. ratio will be undefined if the chart is not donut/pie/gauge.

tooltip.format.value function <optional>

Set format for the value of each data in tooltip.
Specified function receives name, ratio, id and index of the data point to show. ratio will be undefined if the chart is not donut/pie/gauge. If undefined returned, the row of that value will be skipped.

tooltip.position function <optional>

Set custom position for the tooltip.
This option can be used to modify the tooltip position by returning object that has top and left.

tooltip.contents function | Object <optional>

Set custom HTML for the tooltip.
Specified function receives data, defaultTitleFormat, defaultValueFormat and color of the data point to show. If tooltip.grouped is true, data includes multiple data points.

Properties
Name Type Attributes Description
bindto String | HTMLElement <optional>

Set CSS selector or element reference to bind tooltip.

  • NOTE: When is specified, will not be updating tooltip's position.
template String <optional>

Set tooltip's template.

Within template, below syntax will be replaced using template-like syntax string:

  • {{ ... }}: the doubly curly brackets indicate loop block for data rows.
  • {=CLASS_TOOLTIP}: default tooltip class name bb-tooltip.
  • {=CLASS_TOOLTIP_NAME}: default tooltip data class name (ex. bb-tooltip-name-data1)
  • {=TITLE}: title value.
  • {=COLOR}: data color.
  • {=VALUE}: data value.
text Object <optional>

Set additional text content within data loop, using template syntax.

  • NOTE: It should contain { key: Array, ... } value
    • 'key' name is used as substitution within template as '{=KEY}'
    • The value array length should match with the data length
tooltip.init.show Boolean <optional>
false

Show tooltip at the initialization.

tooltip.init.x Number <optional>
0

Set x Axis index to be shown at the initialization.

tooltip.init.position Object <optional>
{top: "0px",left: "50px"}

Set the position of tooltip at the initialization.

tooltip.onshow function <optional>

Set a callback that will be invoked before the tooltip is shown.

tooltip.onhide function <optional>

Set a callback that will be invoked before the tooltip is hidden.

tooltip.onshown function <optional>

Set a callback that will be invoked after the tooltip is shown

tooltip.onhidden function <optional>

Set a callback that will be invoked after the tooltip is hidden.

tooltip.order String | function | null <optional>
null

Set tooltip data display order.

Available Values:

  • desc: In descending data value order
  • asc: In ascending data value order
  • null: It keeps the data display order
    NOTE: When data.groups is set, the order will follow as the stacked graph order.
    If want to order as data bound, set any value rather than asc, desc or null. (ex. empty string "")
  • function(data1, data2) { ... }: Array.sort compareFunction

Tooltip options

Type:
  • Object
Example
tooltip: {
     show: true,
     doNotHide: true,
     grouped: false,
     format: {
         title: function(x) { return "Data " + x; },
         name: function(name, ratio, id, index) { return name; },
         value: function(value, ratio, id, index) { return ratio; }
     },
     position: function(data, width, height, element) {
         return {top: 0, left: 0}
     },

     contents: function(d, defaultTitleFormat, defaultValueFormat, color) {
         return ... // formatted html as you want
     },

      // specify tooltip contents using template
      // - example of HTML returned:
      // <ul class="bb-tooltip">
      //   <li class="bb-tooltip-name-data1"><span>250</span><br><span style="color:#00c73c">data1</span></li>
      //   <li class="bb-tooltip-name-data2"><span>50</span><br><span style="color:#fa7171">data2</span></li>
      // </ul>
      contents: {
     	bindto: "#tooltip",
     	template: '<ul class={=CLASS_TOOLTIP}>{{' +
     			'<li class="{=CLASS_TOOLTIP_NAME}"><span>{=VALUE}</span><br>' +
     			'<span style=color:{=COLOR}>{=NAME}</span></li>' +
     		'}}</ul>'
     }

      // with additional text value
      // - example of HTML returned:
      // <ul class="bb-tooltip">
      //   <li class="bb-tooltip-name-data1"><span>250</span><br>comment1<span style="color:#00c73c">data1</span>text1</li>
      //   <li class="bb-tooltip-name-data2"><span>50</span><br>comment2<span style="color:#fa7171">data2</span>text2</li>
      // </ul>
      contents: {
     	bindto: "#tooltip",
     	text: {
     		// a) 'key' name is used as substitution within template as '{=KEY}'
     		// b) the length should match with the data length
     		VAR1: ["text1", "text2"],
     		VAR2: ["comment1", "comment2"],
     	},
     	template: '<ul class={=CLASS_TOOLTIP}>{{' +
     			'<li class="{=CLASS_TOOLTIP_NAME}"><span>{=VALUE}</span>{=VAR2}<br>' +
     			'<span style=color:{=COLOR}>{=NAME}</span>{=VAR1}</li>' +
     		'}}</ul>'
     }

     // sort tooltip data value display in ascending order
     order: "asc",

     // specifying sort function
     order: function(a, b) {
        // param data passed format
        {x: 5, value: 250, id: "data1", index: 5, name: "data1"}
          ...
     },

     // show at the initialization
     init: {
         show: true,
         x: 2,
         position: {
             top: "150px",
             left: "250px"
         }
     },

     // fires prior tooltip is shown
     onshow: function() { ...},
     // fires prior tooltip is hidden
     onhide: function() { ... },
     // fires after tooltip is shown
     onshown: function() { ... },
     // fires after tooltip is hidden
     onhidden: function() { ... },

     // Link any tooltips when multiple charts are on the screen where same x coordinates are available
     // Useful for timeseries correlation
     linked: true,

     // Specify name to interact those with the same name only.
     linked: {
         name: "some-group"
     }
 }

(static) transition :Object

Source:
Properties:
Name Type Attributes Default Description
transition.duration Number <optional>
350

duration in milliseconds

Set duration of transition (in milliseconds) for chart animation.

  • NOTE: If 0or null set, transition will be skipped. So, this makes initial rendering faster especially in case you have a lot of data.
Type:
  • Object
Example
transition: {
   duration: 500
}

(static) zoom :Object

Source:
See:
Properties:
Name Type Attributes Default Description
zoom.enabled Boolean <optional>
false

Enable zooming.

Properties
Name Type Attributes Default Description
type String <optional>
'wheel'

Set zoom interaction type.

  • Available types:
    • wheel
    • drag
zoom.rescale Boolean <optional>
false

Enable to rescale after zooming.
If true set, y domain will be updated according to the zoomed region.

zoom.extent Array <optional>
[1, 10]

Change zoom extent.

zoom.x.min Number | Date <optional>

Set x Axis minimum zoom range

zoom.x.max Number | Date <optional>

Set x Axis maximum zoom range

zoom.onzoomstart function <optional>

Set callback that is called when zooming starts.
Specified function receives the zoom event.

zoom.onzoom function <optional>

Set callback that is called when the chart is zooming.
Specified function receives the zoomed domain.

zoom.onzoomend function <optional>

Set callback that is called when zooming ends.
Specified function receives the zoomed domain.

zoom.resetButton Boolean | Object <optional>
true

Set to display zoom reset button for 'drag' type zoom

Properties
Name Type Attributes Default Description
text String <optional>
'Reset Zoom'

Text value for zoom reset button.

Set zoom options

Type:
  • Object
Example
zoom: {
     enabled: {
         type: "drag"
     },
     rescale: true,
     extent: [1, 100]  // enable more zooming
     x: {
         min: -1,  // set min range
         max: 10  // set max range
     },
     onzoomstart: function(event) { ... },
     onzoom: function(domain) { ... },
     onzoomend: function(domain) { ... },

     // show reset button when is zoomed-in
     resetButton: true,

     // customized text value for reset zoom button
     resetButton: {
         text: "Unzoom"
     }
 }