Skip to content

Latest commit

 

History

History
75 lines (63 loc) · 2.48 KB

server.md

File metadata and controls

75 lines (63 loc) · 2.48 KB
Raw

server side rendering

renderStatic(fn:html) renderStaticOptimized(fn:html) rehydrate(ids)

this api is mostly copied from aphrodite; render your component inside of a callback, and glamor will gather all the calls you used and return an object with html, css, and an array of ids to rehydrate the library for fast startup

// on the server
import { renderStatic } from 'glamor/server'
let { html, css, ids } = renderStatic(() =>
  ReactDOMServer.renderToString(<App/>)) // or `renderToStaticMarkup`
<!-- when rendering your html -->
<html>
  <head>
    <!-- to avoid certain characters getting encoded
      as html entities (like quotes in css 'content' property),
      we use dangerouslySetInnerHTML to inject our css
    -->
    <style dangerouslySetInnerHTML={{ __html: css }} />
    <!-- alternatively, you'd save the css to a file
      and include it here with
    <link rel='stylesheet' href='path/to/css'/>
     -->
  </head>
  <body>
    <div id='root'>${html}</div>
    <script>
      // optional!
      window._glam = ${JSON.stringify(ids)}
    </script>
    <script src="bundle.js"></script>
  </body>
</html>
// optional!
// when starting up your app
import { rehydrate } from 'glamor'
rehydrate(window._glam)
ReactDOM.render(<App/>, document.getElementById('root'))

caveat: the above will include all the css that's been generated in the app's lifetime. This should be fine in most cases. If you seem to be including too many unused styles, use renderStaticOptimized instead of renderStatic. This will parse the generated html and include only the relevant used css / ids.

WARNING: if you're bundling your server side code with webpack/browserify/etc (as opposed to just browser code), be warned of a subtle issue with excluding node_modules from the module. More details in this twitter thread, and this issue. tldr - be certain to exclude all glamor modules, not just the root.

inline (experimental)

you can just inline critical css into your html

// on the server
import inline from 'glamor/inline'
let html = inline(
  ReactDOMServer.renderToString(<App/>)
)

there is no step 2!