Text.Ginger.Html

A HTML type, useful for implementing type-safe conversion between plain text and HTML. The HTML representation used here assumed Unicode throughout, and UTF-8 should be used as the encoding when sending Html objects as responses to a HTTP client.

Documentation

data Html

A chunk of HTML source.

Instances

Eq Html

Ord Html

Show Html

Monoid Html

ToHtml Html

Html itself is a trivial instance

ToGVal m Html

unsafeRawHtml :: Text -> Html

Convert a chunk of HTML source code into an Html value as-is. Note that this bypasses any and all HTML encoding; the caller is responsible for taking appropriate measures against XSS and other potential vulnerabilities. In other words, the input to this function is considered pre-sanitized.

html :: Text -> Html

Safely convert plain text to HTML.

htmlSource :: Html -> Text

Extract HTML source code from an Html value.

class ToHtml s where

Types that support conversion to HTML.

Methods

toHtml :: s -> Html

Instances

ToHtml Text

Text is automatically HTML-encoded

ToHtml Html

Html itself is a trivial instance

ToHtml [Char]

String is automatically HTML-encoded and converted to Text

ToHtml (GVal m)

Converting to HTML hooks into the ToHtml instance for Text for most tags. Tags that have no obvious textual representation render as empty HTML.