react-travel

v1.3.6
Simple, unopinionated, React portal that renders it's subtree into a desired container.
react react-component component react-portal portal transportation

React Travel

npm version Dependency Status

Your subtree should be able to travel into another top-level tree.

Example

<Travel
  onMount={node => {
    return(
      $(node).dialog({
        autoOpen: false,
        close: () => {
          this.setState({dialogOpen: false})
        }
      }).data('ui-dialog')
    )
  }}
  onUpdate={dialog => {
    if(dialogOpen) {
      dialog.open()
    } else {
      dialog.close()
    }
  }}
>
  <div>
    Even works with third party dialogs!
  </div>
</Travel>

Props

to: PropTypes.any

What node the portal is rendered to, defaults to document.body.

tag: PropTypes.string

What tag to use for the portal, defaults to div.

id: PropTypes.string

React id prop.

className: PropTypes.any

React className prop.

style: PropTypes.object

React style prop. Accepts an object of styles that are applied to the portal. Note that values require their respective unit applied i.e style={{padding: '12px'}}.

children: PropTypes.element

Accepts a single React element or component.

onMount: PropTypes.func

onUpdate: PropTypes.func

onUnmount: PropTypes.func

All tie into React's life cycle methods. Returns portal node with any work done to it.

npm i react-travel

Metadata

  • MIT
  • Whatever
  • Travis Arnold
  • released 5/22/2018

Downloads

Maintainers