README.md

THIS REPOSITORY IS NO LONGER MAINTAINED

Looking for an alternative? Please have a look at react-tagcloud.

If you are interested in maintaining this repository (and taking ownership of it), please reach out to me here.

react-tag-cloud ☁️

Create beautiful tag/word clouds using React. Uses the wonderful d3-cloud under the hood.

View live demo here (edit code)

Installation

npm install react-tag-cloud
or
yarn add react-tag-cloud

Usage

import TagCloud from 'react-tag-cloud';
import randomColor from 'randomcolor';

class MyCloud extends Component {
  render() {
    return (
      <TagCloud 
        style={{
          fontFamily: 'sans-serif',
          fontSize: 30,
          fontWeight: 'bold',
          fontStyle: 'italic',
          color: () => randomColor(),
          padding: 5,
          width: '100%',
          height: '100%'
        }}>
        <div style={{fontSize: 50}}>react</div>
        <div style={{color: 'green'}}>tag</div>
        <div rotate={90}>cloud</div>
        ...
      </TagCloud>
    );
  }
}

Documentation

<TagCloud> props:

name	description	type	default
style.fontSize	Font size needed for calculating layout	Function/Number	20
style.fontFamily	Font family needed for calculating layout	Function/String	serif
style.fontWeight	Font weight needed for calculating layout	Function/Number	normal
style.fontStyle	Font style needed for calculating layout	Function/String	normal
style.padding	Padding between tags (px)	Function/Number	1
style.color	Color to be used by tags	Function/String	(none)
rotate	Rotation in degrees	Function/Number	0
spiral	Spiral	Function/String	archimedean
random	Randomizer function	Function	Math.random

Any component can be used as a child component. TagCloud scans the child components for the following props for its layout calculation:

name	description	type	default
style.fontSize	Font size needed for calculating layout	Function/Number	20
style.fontFamily	Font family needed for calculating layout	Function/String	serif
style.fontWeight	Font weight needed for calculating layout	Function/Number	normal
style.fontStyle	Font style needed for calculating layout	Function/String	normal
style.padding	Padding between tags (px)	Function/Number	1
style.color	Color to be used by tag	Function/String	(none)
rotate	Rotation in degrees	Function/Number	0

Examples

• (Playground on StackBlitz) (source)
• ijzerenhein.nl

Resources

• https://github.com/jasondavies/d3-cloud
• https://en.wikipedia.org/wiki/Tag_cloud

License

MIT

Cool?

Do you think this cool and useful? Consider buying me a coffee!