Skip to content
This repository has been archived by the owner on Apr 3, 2019. It is now read-only.

vega/react-vega-lite

Repository files navigation

This repository is deprecated. The code for react-vega-lite version 6.0.0 and above is in react-vega repository. Please go there for most recent code.

react-vega-lite NPM version Dependency Status

Convert Vega Lite spec into React class conveniently, inspired by this tutorial by @pbeshai

If you are looking for a way to use react with vega-lite@3.x.x, please use react-vega-lite@6.0.1. It has the same API with react-vega-lite@2.x.x.

There is no version 3-5 for react-vega-lite. (Version 3 is published but broken, so does not really count.)

react-vega-lite@2.x.x is updated to bump react-vega version.

react-vega-lite@1.x.x was update with breaking changes to support Vega-Lite 2.0, which is still in beta. If you are looking to use React with Vega Lite 1.x, please use react-vega-lite@0.0.1.

Examples

Install

npm install vega-lib vega-lite react-vega react-vega-lite --save

Example code

There are two approaches to use this libary.

Approach#1 Create class from spec, then get a React class to use

BarChart.js

import React, { PropTypes } from 'react';
import {createClassFromLiteSpec} from 'react-vega-lite';

export default createClassFromLiteSpec('BarChart', {
  "description": "A simple bar chart with embedded data.",
  "mark": "bar",
  "encoding": {
    "x": {"field": "a", "type": "ordinal"},
    "y": {"field": "b", "type": "quantitative"}
  }
});

main.js

import React from 'react';
import ReactDOM from 'react-dom';
import BarChart from './BarChart.js';

const barData = {
  "values": [
    {"a": "A","b": 20}, {"a": "B","b": 34}, {"a": "C","b": 55},
    {"a": "D","b": 19}, {"a": "E","b": 40}, {"a": "F","b": 34},
    {"a": "G","b": 91}, {"a": "H","b": 78}, {"a": "I","b": 25}
  ]
};

ReactDOM.render(
  <BarChart data={barData} />,
  document.getElementById('bar-container')
);

Approach#2 Use <VegaLite> generic class and pass in spec for dynamic component.

Provides a bit more flexibility, but at the cost of extra checks for spec changes.

main.js

import React from 'react';
import ReactDOM from 'react-dom';
import VegaLite from 'react-vega-lite';

const spec = {
  "description": "A simple bar chart with embedded data.",
  "mark": "bar",
  "encoding": {
    "x": {"field": "a", "type": "ordinal"},
    "y": {"field": "b", "type": "quantitative"}
  }
};

const barData = {
  "values": [
    {"a": "A","b": 20}, {"a": "B","b": 34}, {"a": "C","b": 55},
    {"a": "D","b": 19}, {"a": "E","b": 40}, {"a": "F","b": 34},
    {"a": "G","b": 91}, {"a": "H","b": 78}, {"a": "I","b": 25}
  ]
};

ReactDOM.render(
  <VegaLite spec={spec} data={barData} />,
  document.getElementById('bar-container')
);

Props

React class VegaLite and any output class from createClassFromLiteSpec have these properties:

  • className:String

  • style:Object

  • width:Number

  • height:Number

  • padding:Object

  • renderer:String

  • logLevel:Number

  • background:String

  • enableHover:Boolean

  • data:Object

  • onSignalXXX

  • onNewView

  • onParseError

which are the same with react-vega. Please refer to react-vega documentation.

Static function

Any class created from createClassFromLiteSpec will have this function.

  • Chart.getSpec() - return spec

Frequently Asked Questions

How to use Vega Tooltip?

You can pass the vega-tooltip handler instance to the tooltip property.

import { Handler } from 'vega-tooltip';

 <VegaLite spec={spec} data={barData} tooltip={new Handler().call} />