Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ruanyf/react-demos

a collection of simple demos of React.js
https://github.com/ruanyf/react-demos

Last synced: 4 days ago
JSON representation

a collection of simple demos of React.js

Awesome Lists containing this project

README 

        
This is a collection of simple demos of React.js.



These demos are purposely written in a simple and clear style. You will find no difficulty in following them to learn the powerful library.



## Related Projects



- [Flux Demo](https://github.com/ruanyf/extremely-simple-flux-demo)

- [Webpack Demos](https://github.com/ruanyf/webpack-demos)

- [React Router Tutorial](https://github.com/reactjs/react-router-tutorial)

- [CSS Modules Demos](https://github.com/ruanyf/css-modules-demos)

- [React Testing Demo](https://github.com/ruanyf/react-testing-demo)

- [A boilerplate for React-Babel-Webpack project](https://github.com/ruanyf/react-babel-webpack-boilerplate)



## How to use



First, copy the repo into your disk.



```bash

$ git clone [email protected]:ruanyf/react-demos.git

```



Then play with the source files under the repo's demo* directories.



## HTML Template



```html



  

    

    

    

    

  

  

    


    



      // ** Our code goes here! **



    

  



```



## Index



1. [Render JSX](#demo01-render-jsx)

1. [Use JavaScript in JSX](#demo02-use-javascript-in-jsx)

1. [Use array in JSX](#demo03-use-array-in-jsx)

1. [Define a component](#demo04-define-a-component)

1. [this.props.children](#demo05-thispropschildren)

1. [PropTypes](#demo06-proptypes)

1. [Finding a DOM node](#demo07-finding-a-dom-node)

1. [this.state](#demo08-thisstate)

1. [Form](#demo09-form)

1. [Component Lifecycle](#demo10-component-lifecycle)

1. [Ajax](#demo11-ajax)

1. [Display value from a Promise](#demo12-display-value-from-a-promise)

1. [Server-side rendering](#demo13-server-side-rendering)



---



## Demo01: Render JSX



[demo](http://ruanyf.github.io/react-demos/demo01/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo01/index.html)



The template syntax in React is called [JSX](http://facebook.github.io/react/docs/displaying-data.html#jsx-syntax). JSX allows you to use HTML tags in JavaScript code. `ReactDOM.render()` is the method which translates JSX into HTML and renders it into the specified DOM node.



```js

ReactDOM.render(

  
Hello, world!
,

  document.getElementById('example')

);

```



To actually perform the transformation in the browser, you must use `` to indicate JSX code, and include `babel.min.js`, which is a [browser version](https://babeljs.io/docs/usage/browser/) of Babel and can be found in the [babel-core@6](https://www.npmjs.com/package/babel-core) npm release.



Before v0.14, React used `JSTransform.js` to translate `<script type="text/jsx">`, but this is now deprecated ([more info](https://facebook.github.io/react/blog/2015/06/12/deprecating-jstransform-and-react-tools.html)).



## Demo02: Use JavaScript in JSX



[demo](http://ruanyf.github.io/react-demos/demo02/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo02/index.html)



You can also use JavaScript within JSX. Angle brackets (&lt;) symbolize the beginning of HTML syntax, while curly brackets (`{`) represent the beginning of JavaScript syntax.



```js

var names = ['Alice', 'Emily', 'Kate'];



ReactDOM.render(

  <div>

  {

    names.map(function (name) {

      return <div>Hello, {name}!</div>

    })

  }

  </div>,

  document.getElementById('example')

);

```



## Demo03: Use array in JSX



[demo](http://ruanyf.github.io/react-demos/demo03/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo03/index.html)



If a JavaScript variable is an array, JSX will implicitly concat all members of the array.



```js

var arr = [

  <h1>Hello world!</h1>,

  <h2>React is awesome</h2>,

];

ReactDOM.render(

  <div>{arr}</div>,

  document.getElementById('example')

);

```



## Demo04: Define a component



[demo](http://ruanyf.github.io/react-demos/demo04/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo04/index.html)



`class ComponentName extends React.Component` creates a component class, which implements a render method to return a component instance of the class.



Before v16.0, React used `React.createClass()` to create a component class, but this is now deprecated ([more info](https://github.com/facebook/react/blob/master/CHANGELOG.md#removed-deprecations)).



```javascript

class HelloMessage extends React.Component {

  render() {

    return <h1>Hello {this.props.name}</h1>;

  }

}



ReactDOM.render(

  <HelloMessage name="John" />,

  document.getElementById('example')

);

```



You can use `this.props.[attribute]` to access the attributes of a component. Example: `this.props.name` of `<HelloMessage name="John" />` is John.



Please remember the first letter of the component's name must be capitalized, otherwise, React will throw an error. For instance, `HelloMessage` as a component's name is OK, but `helloMessage` is not allowed. And a React component should only have one top child node.



```javascript

// wrong

class HelloMessage extends React.Component {

  render() {

    return <h1>

      Hello {this.props.name}

    </h1><p>

      some text

    </p>;

  }

}



// correct

class HelloMessage extends React.Component {

  render() {

    return <div>

      <h1>Hello {this.props.name}</h1>

      <p>some text</p>

    </div>;

  }

}

```



## Demo05: this.props.children



[demo](http://ruanyf.github.io/react-demos/demo05/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo05/index.html)



React uses `this.props.children` to access a component's children nodes.



```javascript

class NotesList extends React.Component {

  render() {

    return (

      <ol>

      {

        React.Children.map(this.props.children, function (child) {

          return <li>{child}</li>;

        })

      }

      </ol>

    );

  }

}



ReactDOM.render(

  <NotesList>

    <span>hello</span>

    <span>world</span>

  </NotesList>,

  document.getElementById('example')

);

```



Please be mindful that the value of `this.props.children` has three possibilities. If the component has no child node, the value is `undefined`; If it has a single child node, the value will be an object; If it has multiple children nodes, the result is an array. Keep this in mind as you code.



React gave us a utility [`React.Children`](https://facebook.github.io/react/docs/top-level-api.html#react.children) for dealing with the opaque data structure of `this.props.children`. You can use `React.Children.map` to iterate `this.props.children` without worrying if its data type is `undefined` or `object`. Check [official document](https://facebook.github.io/react/docs/top-level-api.html#react.children) for more methods `React.Children` offers.



## Demo06: PropTypes



[demo](http://ruanyf.github.io/react-demos/demo06/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo06/index.html)



Components in React have many specific attributes which are called `props` and can be of any type.



Sometimes you need a way to validate these props. You don't want users have the freedom to input anything into your components.



React has a solution for this and it's called PropTypes.



```javascript

class MyTitle extends React.Component {

  static propTypes = {

    title: PropTypes.string.isRequired,

  }

  render() {

    return <h1> {this.props.title} </h1>;

  }

}

```



The above component `MyTitle` has a prop of `title`. PropTypes tells React that the title is required and its value should be a string.



Now we give `Title` a number value.



```javascript

var data = 123;



ReactDOM.render(

  <MyTitle title={data} />,

  document.getElementById('example')

);

```



Here, the prop doesn't pass the validation, and the console will show you an error message:



```bash

Warning: Failed propType: Invalid prop `title` of type `number` supplied to `MyTitle`, expected `string`.

```



Visit [official doc](https://reactjs.org/docs/typechecking-with-proptypes.html) for more PropTypes options.



P.S. If you want to give the props a default value, use `defaultProps`.



```javascript

class MyTitle extends React.Component {

  constructor(props) {

    super(props)

  }

  static defaultProps = {

    title: 'Hello World',

  }

  render() {

    return <h1> {this.props.title} </h1>;

  }

}



ReactDOM.render(

  <MyTitle />,

  document.getElementById('example')

);

```



React.PropTypes has moved into a different package since React v15.5. ([more info](https://reactjs.org/docs/typechecking-with-proptypes.html)).



## Demo07: Finding a DOM node



[demo](http://ruanyf.github.io/react-demos/demo07/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo07/index.html)



Sometimes you need to reference a DOM node in a component. React gives you the `ref` attribute to attach a DOM node to instance created by `React.createRef()`.



```js

class MyComponent extends React.Component {

  constructor(props) {

    super(props);

    this.myTextInput = React.createRef();

    this.handleClick = this.handleClick.bind(this)

  }

  handleClick() {

    this.myTextInput.current.focus();

  }

  render() {

    return (

      <div>

        <input type="text" ref={this.myTextInput} />

        <input type="button" value="Focus the text input" onClick={this.handleClick} />

      </div>

    );

  }

}



ReactDOM.render(

  <MyComponent />,

  document.getElementById('example')

);

```



Please be mindful that you could do that only after this component has been mounted into the DOM, otherwise you get `null`.



## Demo08: this.state



[demo](http://ruanyf.github.io/react-demos/demo08/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo08/index.html)



React thinks of component as state machines, and uses `this.state` to hold component's state, `this.setState()` to update `this.state` and re-render the component.



```js

class LikeButton extends React.Component {

  constructor(props) {

    super(props)

    this.state = {

    	liked: false

    }

    this.handleClick = this.handleClick.bind(this)

  }

  handleClick(event) {

    this.setState({ liked: !this.state.liked });

  }

  render() {

    var text = this.state.liked ? 'like' : 'haven\'t liked';

    return (

      <p onClick={this.handleClick}>

        You {text} this. Click to toggle.

      </p>

    );

  }

}



ReactDOM.render(

  <LikeButton />,

  document.getElementById('example')

);

```



You could use component attributes to register event handlers, just like `onClick`, `onKeyDown`, `onCopy`, etc. Official Document has all [supported events](http://facebook.github.io/react/docs/events.html#supported-events).



## Demo09: Form



[demo](http://ruanyf.github.io/react-demos/demo09/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo09/index.html)



According to React's design philosophy, `this.state` describes the state of component and is mutated via user interactions, and `this.props` describes the properties of component and is stable and immutable.



Since that, the `value` attribute of Form components, such as &lt;input&gt;, &lt;textarea&gt;, and &lt;option&gt;, is unaffected by any user input. If you wanted to access or update the value in response to user input, you could use the onChange event.



```js

class Input extends React.Component {

constructor(props) {

  super(props)

  this.state = {value: 'Hello!'}

  this.handleChange = this.handleChange.bind(this)

}

handleChange(event) {

  this.setState({value: event.target.value});

}

render() {

  var value = this.state.value;

  return (

    <div>

      <input type="text" value={value} onChange={this.handleChange} />

      <p>{value}</p>

    </div>

  );

}

}



ReactDOM.render(<Input/>, document.getElementById('example'));

```



More information on [official document](http://facebook.github.io/react/docs/forms.html).



## Demo10: Component Lifecycle



[demo](http://ruanyf.github.io/react-demos/demo10/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo10/index.html)



Components have three main parts of [their lifecycle](https://facebook.github.io/react/docs/working-with-the-browser.html#component-lifecycle): Mounting(being inserted into the DOM), Updating(being re-rendered) and Unmounting(being removed from the DOM). React provides hooks into these lifecycle part. `will` methods are called right before something happens, and `did` methods which are called right after something happens.



```js

class Hello extends React.Component {

  constructor(props) {

    super(props)

    this.state = {opacity: 1.0};

  }



  componentDidMount() {

    this.timer = setInterval(function () {

      var opacity = this.state.opacity;

      opacity -= .05;

      if (opacity < 0.1) {

        opacity = 1.0;

      }

      this.setState({

        opacity: opacity

      });

    }.bind(this), 100);

  }



  render() {

    return (

      <div style={{opacity: this.state.opacity}}>

        Hello {this.props.name}

      </div>

    );

  }

}



ReactDOM.render(

  <Hello name="world"/>,

  document.getElementById('example')

);

```



The following is [a whole list of lifecycle methods](http://facebook.github.io/react/docs/component-specs.html#lifecycle-methods).



- **componentWillMount()**: Fired once, before initial rendering occurs. Good place to wire-up message listeners. `this.setState` doesn't work here.

- **componentDidMount()**: Fired once, after initial rendering occurs. Can use `this.getDOMNode()`.

- **componentWillUpdate(object nextProps, object nextState)**: Fired after the component's updates are made to the DOM. Can use `this.getDOMNode()` for updates.

- **componentDidUpdate(object prevProps, object prevState)**: Invoked immediately after the component's updates are flushed to the DOM. This method is not called for the initial render. Use this as an opportunity to operate on the DOM when the component has been updated.

- **componentWillUnmount()**: Fired immediately before a component is unmounted from the DOM. Good place to remove message listeners or general clean up.

- **componentWillReceiveProps(object nextProps)**: Fired when a component is receiving new props. You might want to `this.setState` depending on the props.

- **shouldComponentUpdate(object nextProps, object nextState)**: Fired before rendering when new props or state are received. `return false` if you know an update isn't needed.



## Demo11: Ajax



[demo](http://ruanyf.github.io/react-demos/demo11/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo11/index.html)



How to get the data of a component from a server or an API provider? The answer is using Ajax to fetch data in the event handler of `componentDidMount`. When the server response arrives, store the data with `this.setState()` to trigger a re-render of your UI.



```js

class UserGist extends React.Component {

  constructor(props) {

    super(props)

    this.state = {

      username: '',

      lastGistUrl: ''

    };

  }



  componentDidMount() {

    $.get(this.props.source, function(result) {

      var lastGist = result[0];

      this.setState({

        username: lastGist.owner.login,

        lastGistUrl: lastGist.html_url

      });

    }.bind(this));

  }



  render() {

    return (

      <div>

        {this.state.username}'s last gist is

        <a href={this.state.lastGistUrl}>here</a>.

      </div>

    );

  }

}



ReactDOM.render(

  <UserGist source="https://api.github.com/users/octocat/gists" />,

  document.getElementById('example')

);

```



## Demo12: Display value from a Promise



[demo](http://ruanyf.github.io/react-demos/demo12/) / [source](https://github.com/ruanyf/react-demos/blob/master/demo12/index.html)



This demo is inspired by Nat Pryce's article ["Higher Order React Components"](http://natpryce.com/articles/000814.html).



If a React component's data is received asynchronously, we can also use a Promise object as the component's property, as follows.



```javascript

ReactDOM.render(

  <RepoList promise={$.getJSON('https://api.github.com/search/repositories?q=javascript&sort=stars')} />,

  document.getElementById('example')

);

```



The above code takes data from Github's API, and the `RepoList` component gets a Promise object as its property.



Now, while the promise is pending, the component displays a loading indicator. When the promise is resolved successfully, the component displays a list of repository information. If the promise is rejected, the component displays an error message.



```javascript

class RepoList extends React.Component {

  constructor(props) {

    super(props)

    this.state = {

      loading: true,

      error: null,

      data: null

    };

  }



  componentDidMount() {

    this.props.promise.then(

      value => this.setState({loading: false, data: value}),

      error => this.setState({loading: false, error: error}));

  }



  render() {

    if (this.state.loading) {

      return <span>Loading...</span>;

    }

    else if (this.state.error !== null) {

      return <span>Error: {this.state.error.message}</span>;

    }

    else {

      var repos = this.state.data.items;

      var repoList = repos.map(function (repo, index) {

        return (

          <li key={index}><a href={repo.html_url}>{repo.name}</a> ({repo.stargazers_count} stars) <br/> {repo.description}</li>

        );

      });

      return (

        <main>

          <h1>Most Popular JavaScript Projects in Github</h1>

          <ol>{repoList}</ol>

        </main>

      );

    }

  }

}

```



## Demo13: Server-side rendering



[source](https://github.com/ruanyf/react-demos/tree/master/demo13/src)



This demo is copied from [github.com/mhart/react-server-example](https://github.com/mhart/react-server-example), but I rewrote it with JSX syntax.



```bash

# install the dependencies in demo13 directory

$ npm install



# translate all jsx file in src subdirectory to js file

$ npm run build



# launch http server

$ node server.js

```



## Extras



### Precompiling JSX



All above demos don't use JSX compilation for clarity. In production environment, ensure to precompile JSX files before putting them online.



First, install the command-line tools [Babel](https://babeljs.io/docs/usage/cli/).



```bash

$ npm install -g babel

```



Then precompile your JSX files(.jsx) into JavaScript(.js). Compiling the entire src directory and output it to the build directory, you may use the option `--out-dir` or `-d`.



```bash

$ babel src --out-dir build

```



Put the compiled JS files into HTML.



```html

<!DOCTYPE html>

<html>

  <head>

    <title>Hello React!</title>

    <script src="build/react.js">