@impetusuxp/vizualy-vertical-stacked-bar-chart

Verical Stacked Bar Chart

Installation

Use the package manager NPM to install Verical Stacked Bar Chart.

npm install @impetusuxp/vizualy-vertical-stacked-bar-chart

Sample Data (Chart's required data format)

const data = [
    {
        "company": "Company A",
        "product": "Product A",
        "sell": 34
    },
    {
        "company": "Company A",
        "product": "Product B",
        "sell": 3
    },
    {
        "company": "Company A",
        "product": "Product C",
        "sell": 50,
    },
    {
        "company": "Company A",
        "product": "Product D",
        "sell": 12
    },
    {
        "company": "Company B",
        "product": "Product E",
        "sell": 10
    },
    {
        "company": "Company B",
        "product": "Product A",
        "sell": 4
    }
];

Usage

import VerticalStackedBarChart from '@impetusuxp/vizualy-vertical-stacked-bar-chart';

const verticalStackedBarChart = new VerticalStackedBarChart();

// Draw chart
verticalStackedBarChart
      .container('containerID')
      .x('x axis key in data') // Referred as "company" in sample data
      .y('y axis key in data') // Referred as "sell" in sample data
      .stack('stack key in data') // Referred as "product" in sample data
      .data(data object) // Referred to sample data
      .settings(chart configuration object)
      .draw();

// Update chart
verticalStackedBarChart.data(updated data object).update();

<script type="text/javascript" src="./libs/d3.v6.min.js"></script>
<script type="text/javascript" src="./vizualy-assistant/src/js/utility.js"></script>
<script type="text/javascript" src="./vizualy-assistant/src/js/assistant.js"></script>
<script type="text/javascript" src="./vizualy-assistant/src/js/observer.js"></script>
<script type="text/javascript" src="./vizualy-vertical-stacked-bar-chart/vizualy-vertical-stacked-bar-chart.js"></script>
<script>
const verticalStackedBarChart = new vizualy.VerticalStackedBarChart();

// Draw chart
verticalStackedBarChart
      .container('containerID')
      .x('x axis key in data') // Referred as "company" in sample data
      .y('y axis key in data') // Referred as "sell" in sample data
      .stack('stack key in data') // Referred as "product" in sample data
      .data(data object) // Referred to sample data
      .settings(chart configuration object)
      .draw();

// Update chart
verticalStackedBarChart.data(updated data object).update();
</script>

Make sure to use/import vizualy-assistant/src/css/common.css in your code-base as per recommended by frontend framework being used

Configurations/Settings

dimension: {
    width: 500,
    height: 500,
    margin: { top: 20, right: 20, bottom: 40, left: 40 }
}

Key	Type	Default	Description
width	Number in px	Default width of container	To provide custom width to chart.
height	Number in px	Default height of container	To provide custom height to chart.
margin	Object	{ top: 20, right: 20, bottom: 40, left: 40 }	To provide margin to chart.

xAxis: {
    isVisible: true,
    isGridsVisible: true,
    tickFormat: (d) => d
}

Key	Type	Default	Description
isVisible	Boolean	True	To show/hide X axis
isGridsVisible	Boolean	True	To show/hide X axis grids
tickFormat	Function	Default ticks	To customize ticks labels available via argument(d).

yAxis: {
    isVisible: true,
    isGridsVisible: true,
    tickFormat: (d) => d
}

Key	Type	Default	Description
isVisible	Boolean	True	To show/hide Y axis.
isGridsVisible	Boolean	True	To show/hide Y axis grids.
tickFormat	Function	Default ticks	To customize ticks labels available via argument(d).

xAxisLabel: {
    value: '',
    margin: 40,
    isVisible: true
}

Key	Type	Default	Description
isVisible	Boolean	True	To show/hide X axis label.
margin	Number	40	To provide top margin from X axis line.
value	String(any)	'X-axis'	To provide custom X axis label.

yAxisLabel: {
    value: '',
    margin: 50,
    isVisible: true
}

Key	Type	Default	Description
isVisible	Boolean	True	To show/hide Y axis label.
margin	Number	50	To provide right margin from Y axis line.
value	String(any)	'Y-axis'	To provide custom Y axis label.

stackedBarLabel: {
    isVisible: true,
    labelFormat: (d) => d
}

Key	Type	Default	Description
isVisible	Boolean	True	To show/hide bar label.
labelFormat	Function	Default label	To customize labels inside bar.

tooltip: {
    isVisible: true,
    content: (d, chartObject) => "Some html",
    placement: "top-right"
}

Key	Type	Default	Description
isVisible	Boolean	True	To keep the tooltip in active/hidden state
content	Function	Vertical Stacked Bar chart specific HTML	To provide custom tooltip content
placement	String(top-right, top-left, bottom-right, bottom-left, auto)	'top-right'	To provide static direction to tooltip wrapper.

animation: {
    isApplied: true,
    duration: 750,
    type: 'cubic'
}

Key	Type	Default	Description
isApplied	Boolean	True	To activate/deactivate animations
duration	Number(in ms)	750	duration of animation
type	String("elastic", "bounce", "linear", "sin", "quad", "cubic", "poly", "circle", "exp", "back")	'cubic'	type of animation.

isResponsive: true

Key	Type	Default	Description
isResponsive	Boolean	True	To activate/deactivate responsive behavior of chart.

emptyDataMessage: 'No Data Available'

Key	Type	Default	Description
emptyDataMessage	String	'No Data Available'	To customize message to be displayed on screen when data is empty.

exceptionMessage: 'Something went wrong!! Please see logs.'

Key	Type	Default	Description
exceptionMessage	String	'Something went wrong!! Please see logs.'	To customize message to be displayed on screen when any error occurs.

legend: {
    isVisible: true,
    placement: 'right',
    margin: { top: 10, right: 10, bottom: 10, left: 10 },
    rectWidth: 10,
    rectHeight: 10,
    textKey: null,
    textFormat: (d) => d,
}

Key	Type	Default	Description
isVisible	Boolean	True	To keep the legend in active/hidden state.
placement	String("right", "center", "left")	'right'	Placement(direction) at the top of charts.
margin	Object	{ top: 10, right: 10, bottom: 10, left: 10 }	To provide margin to legends.
rectWidth	number	10	Width of legend rectangle.
rectHeight	number	10	Height of legend rectangle.
textKey	String	null	Property key in data as legend text.
textFormat	Function	Default text	To customize legend text available via argument(d).

barSpace : {
    type: 'perc',
    value: 0.1 
},

Key	Type	Default	Description
type	String	'perc'	Set bar space type to keep the bar separated at certain space
value	Number	0	Set bar space value.

brush: {
        isVisible: false,
        limit: 30,
        offset: 0,
        height: 80,
        margin: 60
}

Key	Type	Default	Description
isVisible	Boolean	false	To keep the legend in active/hidden state.
limit	Number	30	To set limit to the brush.
offset	Number	0	Add offset to brush.
height	Number	80	To provide height of brush.
margin	Number	60	To provide margin around brush.

xWordWrap: {
        isVisible: false,
        linesToAddEllipses: 1
}

Key	Type	Default	Description
isVisible	Boolean	false	To show/hide line label.
linesToAddEllipses	Number	1	To apply ellipses (...) and wrap the text.

xScaleType: {
        type: "time"
    }

Key	Type	Default	Description
type	Boolean	True	Set the X scale type such as band, linear etc.

yScaleType: {
        type: "linear"
    }

Key	Type	Default	Description
type	Boolean	True	Set the Y scale type such as linear etc.

yAxisTicksCount: {
    value: 3, 
    isApplied: false
},

Key	Type	Default	Description
value	Number	True	Set Y-Axis tick count and axis will be restricted to plot only given ticks count.
isApplied	Boolean	false	To show/hide line label.

rotateXAxisTick: {
    value: [-10, 10, 10],
    isVisible: false
}

Key	Type	Default	Description
value	Array	[-10, 10, 10]	[relative X position of ticks label, relative y position, rotation-angle]
isVisible	Boolean	False	To show/hide rotateXAxisTick.

Chart's life cycle hooks:-

chartObject.on('beforeDraw', () => { // do something })
chartObject.on('completeDraw', () => { // do something })
chartObject.on('beforeUpdate', () => { // do something })
chartObject.on('completeUpdate, () => { // do something })
chartObject.on('beforeResize', () => { // do something })
chartObject.on('completeResize', () => { // do something })

Key	Type	Default	Description
on	Function('eventId', handler)	No action	To perform custom actions on mentioned events.

Event subscription

verticalStackedBarChart.getElement("bar").on('mouseMove', [(d, element, event) => { }], removePreviousHandlers: boolean);

We can attaché multiple handlers(Array of functions) on events(mouseMove) to exposed element(bar). We have below events to subscribe -> mouseMove, mouseEnter, mouseOut, mouseOver, click

Contriubutor

Impetus Technologies

License

MIT