mount-react-components

This library was born from the need to be able to mount react components inside server-side rendered HTML views using Ruby on Rails (although it should be able to be used in any other web-framework), providing a simple way to render a react component on the view passing different parameters and receiving them on the component through props.

Usage

Define an element to mount the component into in your server-side rendered html, specifying the component name on data-component. You can use the data-props attribute to send props coming out directly of your server-side rendered html in JSON format.

<div
  data-component="MyReactComponent"
  data-props="<%= {employees: Employee.all}.to_json %>"
>
</div>

Then, in your application.js (in case you're using Rails), import the mountComponents function and call it sending the list of components as defined on this example.

import { mountComponents } from 'mount-react-components'
import MyReactComponent from './components/MyReactComponent'

// this will map a data-component name (in this case MyReactComponent) and a component class (in this case also MyReactComponent)
// but could be anything
const components = {
  MyReactComponent
}

mountComponents(components)

In case you don't need to send any props to your component you can omit the data-props attribute, which is not required:

<div data-component="MyReactComponent"></div>

Tip: For components that need Suspense you should wrap your main component and then add the wrapper on the components list.