d3plus-viz

d3plus-viz

Abstract ES6 class that drives d3plus visualizations.

Installing

If you use NPM, npm install d3plus-viz. Otherwise, download the latest release. The released bundle supports AMD, CommonJS, and vanilla environments. Create a custom bundle using Rollup or your preferred bundler. You can also load directly from d3plus.org:

<script src="https://d3plus.org/js/d3plus-viz.v0.2.full.min.js"></script>

API Reference

Viz

Kind: global class

• Viz
  • new Viz()
  • .data([data])
  • .depth([value])
  • .duration([ms])
  • .filter([value])
  • .groupBy([value])
  • .height([value])
  • .highlight([data])
  • .label([value])
  • .legend([value])
  • .on([typenames], [listener])
  • .select([selector])
  • .shape([value])
  • .shapeConfig([value])
  • .time([value])
  • .timeFilter([value])
  • .timeline([value])
  • .tooltip([value])
  • .width([value])

new Viz()

Creates an x/y plot based on an array of data. If data is specified, immediately draws the tree map based on the specified array and returns the current class instance. If data is not specified on instantiation, it can be passed/updated after instantiation using the data method. See this example for help getting started using the treemap generator.

Viz.data([data])

If data is specified, sets the data array to the specified array and returns the current class instance. If data is not specified, returns the current data array.

Kind: static method of Viz

Param	Type	Default
[data]	Array	[]

Viz.depth([value])

If value is specified, sets the depth to the specified number and returns the current class instance. The value should correspond with an index in the groupBy array. If value is not specified, returns the current depth.

Kind: static method of Viz

Param	Type
[value]	Number

Viz.duration([ms])

If ms is specified, sets the animation duration to the specified number and returns the current class instance. If ms is not specified, returns the current animation duration.

Kind: static method of Viz

Param	Type	Default
[ms]	Number	600

Viz.filter([value])

If value is specified, sets the filter to the specified function and returns the current class instance. If value is not specified, returns the current filter.

Kind: static method of Viz

Param	Type
[value]	function

Viz.groupBy([value])

If value is specified, sets the group accessor(s) to the specified string, function, or array of values and returns the current class instance. If value is not specified, returns the current group accessor.

Kind: static method of Viz

Param	Type
[value]	String | function | Array

Example

function value(d) {
  return d.id;
}

Viz.height([value])

If value is specified, sets the overallheight to the specified number and returns the current class instance. If value is not specified, returns the current overall height.

Kind: static method of Viz

Param	Type	Default
[value]	Number	window.innerHeight

Viz.highlight([data])

Highlights elements elements based on supplied data.

Kind: static method of Viz

Param	Type
[data]	Array | Object

Viz.label([value])

If value is specified, sets the label accessor to the specified function or string and returns the current class instance. If value is not specified, returns the current text accessor, which is undefined by default.

Kind: static method of Viz

Param	Type
[value]	function | String

Viz.legend([value])

If value is specified, toggles the legend based on the specified boolean and returns the current class instance. If value is an object, then it is passed to the legend's config method. If value is not specified, returns the current value.

Kind: static method of Viz

Param	Type	Default
[value]	Boolean | Object	true

Viz.on([typenames], [listener])

Adds or removes a listener to each shape for the specified event typenames. If a listener is not specified, returns the currently-assigned listener for the specified event typename. Mirrors the core d3-selection behavior.

Kind: static method of Viz

Param	Type
[typenames]	String
[listener]	function

Example (By default, listeners apply to both the shapes and the legend. Passing a namespace with the typename gives control over specific elements:)

new Plot
  .on("click.shape", function(d) {
    console.log("data for shape clicked:", d);
  })
  .on("click.legend", function(d) {
    console.log("data for legend clicked:", d);
  })

Viz.select([selector])

If selector is specified, sets the SVG container element to the specified d3 selector or DOM element and returns the current class instance. If selector is not specified, returns the current SVG container element, which is undefined by default.

Kind: static method of Viz

Param	Type
[selector]	String | HTMLElement

Viz.shape([value])

If value is specified, sets the shape accessor to the specified function or number and returns the current class instance. If value is not specified, returns the current shape accessor.

Kind: static method of Viz

Param	Type
[value]	function | String

Viz.shapeConfig([value])

If value is specified, sets the config method for each shape and returns the current class instance. If value is not specified, returns the current shape configuration.

Kind: static method of Viz

Param	Type
[value]	Object

Viz.time([value])

If value is specified, sets the time accessor to the specified function or string and returns the current class instance. If value is not specified, returns the current time accessor. The time values that are returned should be valid Date objects, 4-digit year values, or strings that can be parsed into javascript Date objects (click here for valid string formats).

Kind: static method of Viz

Param	Type
[value]	function | String

Viz.timeFilter([value])

If value is specified, sets the time filter to the specified function and returns the current class instance. If value is not specified, returns the current time filter.

Kind: static method of Viz

Param	Type
[value]	function

Viz.timeline([value])

If value is specified, toggles the timeline based on the specified boolean and returns the current class instance. If value is an object, then it is passed to the timeline's config method. If value is not specified, returns the current value.

Kind: static method of Viz

Param	Type	Default
[value]	Boolean | Object	true

Viz.tooltip([value])

If value is specified, toggles the tooltip based on the specified boolean and returns the current class instance. If value is an object, then it is passed to the tooltip's config method. If value is not specified, returns the current tooltip visibility.

Kind: static method of Viz

Param	Type	Default
[value]	Boolean | Object	true

Viz.width([value])

If value is specified, sets the overallwidth to the specified number and returns the current class instance. If value is not specified, returns the current overall width.

Kind: static method of Viz

Param	Type	Default
[value]	Number	window.innerWidth

_{Documentation generated on Fri, 09 Sep 2016 23:02:33 GMT}