Skip to content

A simple tool for fetching and handling data from an API with React.

License

Notifications You must be signed in to change notification settings

nickzuber/react-api

Repository files navigation

Build Status npm version

A simple tool for fetching and handling data from an API with React

Installation

Installing react-api in your Node project is simple:

$ npm install react-api --save

Usage

At its core, react-api is really just a simple React component. You would treat it as you would any other React component, with a few specific settings to keep in mind while configuring:

  • ref - string - Used to reference the component getting the API response.
  • url - string - The address of where you're getting your API response.
  • callback - function - A function for handling the actual response.

Examples

Here is a basic example of using react-api to get some data of a GitHub user's repositories:

const ReactAPI = require('react-api');

// The address of where to retrieve data
var URL = 'https://api.github.com/users/nickzuber/repos';

const MyAwesomeComponent = React.createClass({

  handleResponse: function(){
    // API response as a JavaScript object:
    console.log(this.refs.github.state.data);
  },

  render: function(){
    return(
      <div>
        <ReactAPI ref='github' url={URL} callback={this.handleResponse} />
      </div>
    );
  }

});

License

MIT

Copyright (c) 2015 Nick Zuber

About

A simple tool for fetching and handling data from an API with React.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published