npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@keyvaluesystems/react-waterfall-chart

v0.1.5

Published

A customizable and responsive svg waterfall chart component

Downloads

56

Readme

React Waterfall Chart

A customizable & responsive Waterfall chart for React project

Try tweaking a waterfall chart using this codesandbox link here

Installation

The easiest way to use react-waterfall-chart is to install it from npm and build it into your app with Webpack.


npm install  @keyvaluesystems/react-waterfall-chart

You’ll need to install React separately since it isn't included in the package.

Usage

React Waterfall chart can run in a very basic mode by just providing the transactions like given below:


import  WaterfallChart  from  '@keyvaluesystems/react-waterfall-chart';

<WaterfallChart
  transactions={transactionList}
/>

The transactions prop is an array of transactions with the following keys:

  • label - a string to represent each transaction

  • value - a number that specifies the transaction quantity

An example for transactions array is shown below:

const  transactionsList = [{
    label:  'Quarter 1, 2020',
    value:  1000
  },{
    label:  'Quarter 2, 2020',
    value:  -500
  }];

You can use barWidth prop to specify the width of each bar present in the chart. The given value will be converted to pixels (px) and applied to the chart. With the help of showBridgeLines prop, the line connecting the adjacent bars can be shown/hidden. showFinalSummary can be used to display the summary as the last transaction.

<WaterfallChart
  transactions={transactionsList}
  barWidth={100}
  showBridgeLines={true}
  showFinalSummary={false}
/>

You can specify whether to show or hide the scale lines in the Y axis with the help of showYAxisScaleLines prop.

<WaterfallChart
  transactions={transactionsList}
  showYAxisScaleLines={true}
/>

Props

Props that can be passed to the component are listed below:

Style Customizations

All the default styles provided by this package are overridable using the style prop. the below code shows all the overridable styles:

<WaterfallChart
 transactions={transactionsList}
 showYAxisScaleLines={true}
 styles={{
  summaryBar: CSSProperties,
  positiveBar: CSSProperties,
  negativeBar: CSSProperties
 }}
/>
  • summaryBar - overrides the summary bar styles
  • positiveBar - overrides the positive value bar styles
  • negativeBar - overrides the negative value bar styles