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

react-json-table

v0.1.1

Published

A simple but reactive table react component to display JSON data.

Downloads

258

Readme

react-json-table

A simple but flexible table react component to display JSON data.

As simple as feeding it with an array of objects.

var items = [
  { name: 'Louise', age: 27, color: 'red' },
  { name: 'Margaret', age: 15, color: 'blue'},
  { name: 'Lisa', age:34, color: 'yellow'}
];

React.render(<JsonTable rows={ items } />, document.body);

See the example working

Features:

  • No dependencies and in a UMD format.
  • Customizable cell contents to show your data the way you need.
  • Callbacks for clicks on headers, rows or cells.
  • Allows to add custom columns.
  • Enough className attributes to let you style it your own way.
  • Pure rendering, no internal state, everything comes from the props.

Motivation

Creating tables in react is a repetitive work:

  • Create the table wrapper
  • Create a wrapper also for every item
  • For every row print all the cells
  • Add some classes to let styling
  • I also want to listen to clicks in the header of every column in order to sorting.
  • Hey, I forgot to add <tbody> tags so it is not working! Add them!
  • ...

I don't want to do it ever again, JsonTable component will do that ugly stuff so on.

Installation

Using node package manager:

npm install react-json-table --save

You can also use the built UMD files react-json-table.js(6KB) and react-json-table.min.js(3KB) if you want JsonTable globally or as an AMD package.

Half of the built version size is the code to create the UMD module. NPM version is really lightweight.

Usage

You can see the simplest example of use at the top of this page, but probably you would like to customize a bit the behaviour of the table to adapt it to your needs. Have a look at the accepted component props.

props

Prop name | Values | Description ---|---|--- rows | Array[Object] | The data you want to display in the table. columns | Array[String|Object] | The columns and their order for the table. If it is a string the value attribute of the current row that matches it will be shown as cell content. But also it is possible to use an object to customize the column, see column definition. className | string | Class to use for the <table> element. settings | Object | Further customization of the table, see table settings. onClickCell | Function | Callback triggered when a cell is clicked: fn( event, columnName, rowData ). onClickRow | Function | Callback triggered when a row is clicked: fn( event, rowData ) onClickHeader | Function | Callback triggered when a column header is clicked: fn( event, columnName )

Column definition

Using column definitions you can change the behaviour of the column easily. To do so you need to pass an array of the column definitions as the columns prop to the JsonTable:

var items = [
  { name: 'Louise', age: 27, color: 'red' },
  { name: 'Margaret', age: 15, color: 'blue'},
  { name: 'Lisa', age:34, color: 'yellow'}
];

var columns = [
    'name',
    {key: 'age', label: 'Age'},
    {key: 'color', label: 'Colourful', cell: function( item, columnKey ){
        return <span style={{color: item.color}}>{ item.color }</span>;
    }}
];

React.render(<JsonTable rows={ items } columns={ columns } />, document.body);

http://codepen.io/arqex/pen/waJREq?editors=011

As you can see in the example, a column definition can be just a string with the name of the field to display or an object. But if an object is passed the customization can be much more. A column definition can be an object with the following properties:

  • key: It is the internal name use for the column by JsonTable. It is added to the className of the cells and headers to apply styles to the column. It is also passed as an argument for the click callbacks. If the column definition has no cell property, it also represent the property of the current row to be shown as cell content.
  • label: It is the content of the column header. You can use a string or a ReactComponent to show inside the header cell.
  • cell: What is going to be displayed inside the column cells. It can be a string or ReactComponent to show static contents, but tipically it is a function( rowData, columnKey ) that return the contents for the cell. This way different contents are shown in the column for different rows.

Table settings

Using the prop settings we can customize some details that are not related to columns. It is an object with the following properties:

Setting name | Values | Description ---|---|--- cellClass | function | It is possible to add custom classes to the cells if you pass a function fn( currentClass, columnKey, rowData ) in this setting. classPrefix | string | JsonTable uses class attributes for its markup like jsonRow or jsonCell. The default prefix is json but you can use this setting to change it in the case it is conflicting with other classes in your app. header | boolean | If false, no header will be shown for the table. Default true. headerClass | function | It is possible to add custom classes to the column headers if you pass a function fn( currentClass, columnKey ) in this setting. keyField | string | React components that have a list of children need to give to every children a different key prop in order to make the diff algorithm check if something has change. You can define here what field of your rows will be used as a row key. JsonTable uses the id or _id property of your rows automatically if you don't give this setting, but you must be sure that there is a keyField for your rows if you don't want strange behaviours on update. More info. noRowsMessage | string, ReactComponent | Message shown when the table has no rows. Default "No items". rowClass | function | It is possible to add custom classes to the rows if you pass a function fn( currentClass, rowData ) in this setting. cellRenderer | function(item,field) | If provided, this function will be used to render all the cells' content, so it is a way of programatically customize every cell. If no provided, the cell contents will just be item[field], the value of the item for that field.

You can play with the table settings here.

Reacting to clicks

It is always useful binding some callbacks when the user clicks on the table. Click callbacks can be added using the props onClickCell, onClickHeader and onClickRow. In the next example we create a component using JsonTable where rows and cells are selected on click, and columns are sorted when the column header is clicked:

var SelectTable = React.createClass({
  getInitialState: function(){
    // We will store the selected cell and row, also the sorted column
    return {row: false, cell: false, sort: false};
  },  

  render: function(){
    var me = this,
        // clone the rows
        items = this.props.rows.slice()
    ;
    // Sort the table
    if( this.state.sort ){
      items.sort( function( a, b ){
         return a[ me.state.sort ] > b[ me.state.sort ] ? 1 : -1;
      });
    }

    return <JsonTable
      rows={items}
      settings={ this.getSettings() }
      onClickCell={ this.onClickCell }
      onClickHeader={ this.onClickHeader }
      onClickRow={ this.onClickRow } />;
  },

  getSettings: function(){
      var me = this;
      // We will add some classes to the selected rows and cells
      return {
        keyField: 'name',
        cellClass: function( current, key, item){
          if( me.state.cell == key && me.state.row == item.name )
            return current + ' cellSelected';
          return current;
        },
        headerClass: function( current, key ){
            if( me.state.sort == key )
              return current + ' headerSelected';
            return current;
        },
        rowClass: function( current, item ){
          if( me.state.row == item.name )
            return current + ' rowSelected';
          return current;
        }
      };
  },

  onClickCell: function( e, column, item ){
    this.setState( {cell: column} );
  },

  onClickHeader: function( e, column ){
    this.setState( {sort: column} );
  },

  onClickRow: function( e, item ){
    this.setState( {row: item.name} );
  }  
});

http://codepen.io/arqex/pen/pJPzox?editors=011

What's next?

Tests, tests, tests... I need to add tests for the different settings in order to continue the developing of new features.

Of course, issues reports, feature and pull requests are welcome. If JsonTable can make you not to code a react table again I will be happy to help.

MIT Licensed