Overview

Miso.Html.Render provides the ToHtml typeclass for serialising a View tree to a lazy ByteString of UTF-8 HTML. This is the foundation of miso's server-side rendering (SSR) support.

Instances are provided for both View m a (a single node) and [View m a] (a sequence of nodes).

Quick start

import           Miso.Html.Render (ToHtml, toHtml)
import qualified Data.ByteString.Lazy as L

renderPage :: Model -> L.ByteString
renderPage m = toHtml (view m)

With servant, use toHtml inside a ByteString or OctetStream response, or wire it into a ToHtml servant MIME type.

Rendering rules

• VNode — rendered as <tag attrs>children</tag>. Self-closing elements (<br/>, <img/>, <input/>, …) are rendered without a closing tag.
• VText — rendered as a raw text string (no escaping beyond what is already in the MisoString).
• VComp — recursively renders the sub-component's view using its initial (or hydrated) model.
• VFrag — renders all children inline, no wrapper tag.
• Event handlers (On) — silently dropped; they have no meaning in a static HTML string.
• Boolean properties (disabled, checked, required, …) — rendered as bare attribute names when True, omitted entirely when False.
• Adjacent text nodes — collapsed into a single text node to match browser parsing behaviour during hydration.

SSR flag

When compiled with -fssr the renderer calls the component's optional hydrateModel action to derive the initial model (e.g. by fetching from a database), falling back to the static model if the action throws.

See also

• Miso.Hydrate — client-side hydration from server-rendered HTML
• Miso.Html.Element — element smart constructors
• Miso.Html — top-level HTML DSL re-export hub