@hh.ru/react-d3-chart-graphs

A javascript library for building charts components made with React.js and D3.js

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@hh.ru/react-d3-chart-graphs
1536.1.27 months ago7 years agoMinified + gzip package size for @hh.ru/react-d3-chart-graphs in KB

Readme

React-d3-chart-graphs

A javascript library for building charts based on d3.js@4.10.0 Allows you to easily build the following graph:


Bar Chart

A bar chart or bar graph is a chart or graph that presents grouped data with rectangular bars with lengths proportional to the values that they represent. Only vertical bars are supported.
Consists of the following properties:
Fields:
 ```
{
    title: "title chart",
    value: 7
}
 ```
  • paddingMultiplier - type: Number (from 0 to 1). Default value = 0. Specifies an indent between bars.
  • margins - type: object. Set canvas margins.
Fields (default values):
 ```
    {
        top: 10,
        right: 10,
        bottom: 150,
        left: 80
    }
 ```
  • colorScale - type Object. Sets the color of the bar, depending on the value on the y-axis with the help of the function
d3-interpolate.
Fields (default values):
 ```
    {
        min: '#B2EBF2'
        max: '#00BCD4',
    }
 ```  
  • handleBarClick - The click event is raised when the user clicks on the canvas. If user clicked on bar
argument - item of data and metrics current bar.
Fields :
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: "title chart",
    value: 7
}
```
If user click on canvas without bar, argument is `null`
  • handleBarHover - The mouseenter and mouseleave events. If user moved mouse in bar, first argument - item of data and
metrics current bar, second - event data.
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: "title chart",
    value: 7
},
event: {
    clientX,
    clientY,
}
```
If user mouseleave bar or if user mouseenter on canvas without bar, arguments is `null`
  • toggleResize - type Boolean. Forced resizing by the parent, changing the current state to the opposite will resize.

Stacked Bar Chart

Bar graphs can also be used for more complex comparisons of data with grouped bar charts and stacked bar charts. In a grouped bar chart, for each categorical group there are two or more bars. Consists of the following properties: - axesProps.padding - data - type: array of object.
Fields:
 ```
{
   "titleBar": "first bar",
   "key": "uId", //default titleBar
    "values": [
        {
            "title": "BAR_1",
            "value": 5
        },
        {
            "title": "BAR_2",
            "value": 7
        },
        {
            "title": "BAR_3",
            "value": 5
        },
        {
            "title": "BAR_4",
            "value": 10
        },
        {
            "title": "BAR_5",
            "value": 20
        },
        {
            "title": "BAR_6",
            "value": 5
        },
        {
            "title": "BAR_7",
            "value": 9
        },
        {
            "title": "BAR_8",
            "value": 12
        },
        {
            "title": "BAR_9",
            "value": 4
        }
    ]
}
 ```
  • stackColors -type: object. It is map colors to title data.
Example:
```
stackColors = {
    BAR_1: {
        color: '#607D8B', //bar color
        legend: 'some bar 1', // legend text
    },
    BAR_2: {
        color: '#4CAF50',
        legend: 'some bar 2',
    },
}
```
  • paddingMultiplier - type: Number (from 0 to 1). Default value = 0. Specifies an indent between bars.
  • margins - type: object. Set canvas margins.
Fields (default values):
 ```
    {
        top: 10,
        right: 10,
        bottom: 150,
        left: 80
    }
 ```
  • handleBarClick - The click event is raised when the user clicks on the canvas. If user clicked on bar
argument - item of data and metrics current bar and titleBar is a title of stack bars.
Fields :
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: "title chart",
    value: 7,
    titleBar: "first bar"
}
```
If user click on canvas without bar, argument is `null`
  • handleBarHover - The mouseenter and mouseleave events. If user moved mouse in bar, first argument - item of data and
metrics current bar, second - event data.metrics current bar.
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: "title chart",
    value: 7,
    titleBar: "first bar"
},
event: {
    clientX,
    clientY,
}
```
If user mouseleave bar or if user mouseenter on canvas without bar, arguments is `null`
  • toggleResize - type Boolean. Forced resizing by the parent, changing the current state to the opposite will resize.

Gantt Chart

A Gantt chart is a type of bar chart that illustrates a project schedule. Consists of the following properties: - axesProps.padding - data - type: array of object.
Fields:
 ```
{
   titleBar: 'BAR_1 bar',
   key: 'uId', //default titleBar
   values: [
        {
            title: 'status-1',
            dateStart: 'Fri, 10 Apr 2017 18:16:05 GMT',
            dateEnd: 'Tue, 12 Apr 2017 19:10:06 GMT',
        },
        {
            title: 'status-2',
            dateStart: 'Tue, 12 Apr 2017 19:10:06 GMT',
            dateEnd: 'Tue, 14 Apr 2017 19:10:06 GMT',
        }
    ]
}
 ```
  • stackColors -type: object. It is map colors to title data.
Example:
```
stackColors = {
    status-1: {
        color: '#607D8B', //bar color
        legend: 'status first', // legend text
    },
    status-2: {
        color: '#4CAF50',
        legend: 'status second',
    },
}
```
  • paddingMultiplier - type: Number (from 0 to 1). Default value = 0. Specifies an indent between bars.
  • margins - type: object. Set canvas margins.
Fields (default values):
 ```
    {
        top: 10,
        right: 10,
        bottom: 150,
        left: 80
    }
 ```
  • handleBarClick - The click event is raised when the user clicks on the canvas. If user clicked on bar
argument - item of data and metrics current bar and titleBar is a title of stack bars.
Fields :
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: 'title chart',
    dateStart: 'Tue, 12 Apr 2017 19:10:06 GMT',
    dateEnd: 'Tue, 14 Apr 2017 19:10:06 GMT',
    titleBar: 'first bar'
}
```
If user click on canvas without bar, argument is `null`
  • handleBarHover - The mouseenter and mouseleave events. If user moved mouse in bar, argument - first argument - item of data and
metrics current bar, second - event data.
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: 'title chart',
    dateStart: 'Tue, 12 Apr 2017 19:10:06 GMT',
    dateEnd: 'Tue, 14 Apr 2017 19:10:06 GMT',
    titleBar: 'first bar'
},
event: {
    clientX,
    clientY,
}
```
If user mouseleave bar or if user mouseenter on canvas without bar, arguments is `null`
  • toggleResize - type Boolean. Forced resizing by the parent, changing the current state to the opposite will resize.

Box Plot

Bar graphs is a method for graphically depicting groups of numerical data through their quartiles. Consists of the following properties: - axesProps.padding - data - type: array of object.
Fields:
 ```
{
    title: 'First bar',
    numbers: {
        min: 15,
        max: 218,
        median: 30,
        quartiles: [20, 45],
    },
    outliers: [{
        key: 'First',
        value: 289,
        title: 'text',
    }],
}
 ```
  • colorScale - type Object. Sets the color of the bar, depending on the value on the y-axis with the help of the function
d3-interpolate.
Fields (default values):
 ```
    {
        min: '#B2EBF2'
        max: '#00BCD4',
    }
 ```  
  • paddingMultiplier - type: Number (from 0 to 1). Default value = 0. Specifies an indent between bars.
  • margins - type: object. Set canvas margins.
Fields (default values):
 ```
    {
        top: 10,
        right: 10,
        bottom: 150,
        left: 80
    }
 ```
  • handleBarClick - The click event is raised when the user clicks on the bar.
Argument - item of data and metrics current bar.
Fields :
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: "title chart",
    values: {
         min: 7,
         max: 118,
         median: 20,
         quartiles: {
             min: 15,
             max: 40,
         },
    },
    outliers: {
        min: 2,
        max: 220,
    },
    titleBar: "first bar"
}
```
  • handleOutlierClick - The click event is raised when the user clicks on the outlier.
Argument - item of data and metrics current Circle. ```
{
    metrics: {
        left: 548
        top: 129
        width: 5
    },
    title: 'First bar',
    values: {
        min: 7,
        max: 118,
        median: 20,
        quartiles: {
            min: 15,
            max: 40,
        },
    },
    outliers: {
        min: 2,
        max: 220,
    }
}
    ```
  • handleBarHover - The mouseenter and mouseleave events. If user moved mouse in bar, first argument - item of data and
metrics current bar, second - event data.
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: 'First bar',
    values: {
        min: 7,
        max: 118,
        median: 20,
        quartiles: {
            min: 15,
            max: 40,
        },
    },
    outliers: {
        min: 2,
        max: 220,
    }
}, 
event: {
    clientX,
    clientY,
}
```
If user mouseleave bar or if user mouseenter on canvas without bar, arguments is `null`
  • toggleResize - type Boolean. Forced resizing by the parent, changing the current state to the opposite will resize.

Axes props

  • axesProps.legend.xAxis || yAxis - Text on legend
  • axesProps.padding.xAxis || yAxis - If padding is specified, sets the padding to the specified value in pixels and
returns the axis. Default value = 5px. d3-axis tickPadding Default value = 4.
  • axesProps.tickFormat.xAxis || yAxis - If format is specified, sets the tick format function and returns the axis.
d3-axis axistickFormat.
Example params:

```
axesProps = {
    label: { //Label text on legend
        xAxis: 'Label bottom axis',
        yAxis: 'Label left axis'
    },
    padding: {
        xAxis: 20,
        yAxis: 20
    },
    ticksCount: 6,
    tickFormat: {
        xAxis: function(value) {
            return value + 'mm';
        }
    }
}
```

Axes

Component for creating chart's axes. Has the following props:

Responsive Wrapper

Wrapper component that expands to container's width. Forwards parentWidth prop to wrapped component.
Example:
import {Component} from 'react';
import {ResponsiveWrapper} from '@hh.ru/react-d3-chart-graphs';

class MyComponent extends Component {
    render() {
        const { parentWidth } = this.props;
        // ...
    }
}

export default ResponsiveWrapper(MyComponent);

Line Chart Time

Line charts are used to display trends over time. Use a "line chart time" if you have dates on the horizontal axis.
Consists of the following properties:
Fields:
 ```
{
    title: 'First',
    values: [
        {
            date: 'Fri, 30 Jun 2017 00:00:00 GMT',
            value: 0.04918032786885246,
        },
    ],
}
 ```
  • margins - type: object. Set canvas margins.
Fields (default values):
 ```
    {
        top: 10,
        right: 10,
        bottom: 150,
        left: 80
    }
 ```
  • stackColors -type: object. It is map colors to title data.
Example:
```
stackColors = {
    First: {
        color: '#607D8B', //bar color
        legend: 'some bar 1', // legend text
    },
}
```
  • hideCircles -type: Boolean. Hide "circles" data point.
  • handleCircleHover - The mouseenter and mouseleave events. If user moved mouse in Circle, first argument - item of data
and metrics current Circle, second - event data.
```
{
    metrics: {
        left: 548
        top: 129
        width: 52
    },
    title: 'First',
    item: {
        date: 'Fri, 30 Jun 2017 00:00:00 GMT',
        value: 0.04918032786885246,
    }
}
event: {
    clientX,
    clientY,
}
```
If user mouseleave bar or if user mouseenter on canvas without Circle, arguments is `null`
  • toggleResize - type Boolean. Forced resizing by the parent, changing the current state to the opposite will resize.

Examples and development

NODE_ENV=development yarn wepack && cd examples && yarn start 

0.1.0

  • First release
  • Add bar chart and stacked bar chart

1.0.0

  • Changed data props field in Stacked bar chart

2.0.0

  • Changed data props stackColors in Stacked bar chart (added legend text)

2.0.1

  • Changed development build, fix uglify.

2.1.0

  • Add box plot.

2.1.1

  • Corrected the positioning of the bar in BoxPlot

3.0.0

  • Export Axes and ResponsiveWrapper, change axesProps.ticksCount format.

3.1.1

  • Add handleEjectionClickMinClick, handleEjectionMaxClick in BoxPlot

3.1.1

Fix boxPlot mousemove

4.0.0

Rename click handlers BoxPlot

4.1.0

Export Legends

4.2.0

Add Gantt Chart

4.2.1

Add tickCount props to Axes GanttChart

5.0.0

Rename ejections to outliers, add outliers' hover handlers

5.1.0

Introduce handleOutlierClick and handleOutlierHover, update box plot chart's appearance

5.1.1

Add second argument event to hover

5.1.3

Update react and react-dom to 16.0 version and fix box plot

5.1.4

Bug fixes

5.2.0

Add chart LineChartTime

5.2.1

Make Gantt chart height adaptive

5.3.0

Add render prop to Gantt chart.

6.0.0

Updated dependencies

6.0.3

Up webpack version

6.0.4

Up react-scripts version in examples

6.1.0

Add graph component