Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/gaearon/react-document-title

Declarative, nested, stateful, isomorphic document.title for React
https://github.com/gaearon/react-document-title

Last synced: about 15 hours ago
JSON representation

Declarative, nested, stateful, isomorphic document.title for React

Awesome Lists containing this project

README 

        
React Document Title

====================



Provides a declarative way to specify `document.title` in a single-page app.  

This component can be used on server side as well.



Built with [React Side Effect](https://github.com/gaearon/react-side-effect).



## Installation



```

npm install --save react-document-title

```



Dependencies: React >= 0.13.0



## Features



* Does not emit DOM, not even a ``;

* Like a normal React compoment, can use its parent's `props` and `state`;

* Can be defined in many places throughout the application;

* Supports arbitrary levels of nesting, so you can define app-wide and page-specific titles;

* Works just as well with isomorphic apps.



## Example



Assuming you use something like [react-router](https://github.com/rackt/react-router):



```javascript

function App() {

  // Use "My Web App" if no child overrides this

  return (

    

      

    

  );

}



function HomePage() {

  // Use "Home" while this component is mounted

  return (

    

      
Home, sweet home.


    

  );

}



class NewArticlePage extends React.Component {

  constructor(props) {

    super(props);

    this.state = { title: 'Untitled' };

  }



  render() {

    // Update using value from state while this component is mounted

    return (

      

        


          
New Article


           this.setState({ title: e.target.value })}

          />

        


      

    );

  }

}

```



## Server Usage



If you use it on server, call `DocumentTitle.rewind()` **after rendering components to string** to retrieve the title given to the innermost `DocumentTitle`. You can then embed this title into HTML page template.



Because this component keeps track of mounted instances, **you have to make sure to call `rewind` on server**, or you'll get a memory leak.



## But What About Meta Tags?



Looking for something more powerful? Check out [React Helmet](https://github.com/nfl/react-helmet)!