<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>Text/Blaze/Internal.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>{-# LANGUAGE OverloadedStrings, GeneralizedNewtypeDeriving, Rank2Types, <a name="line-2"></a> FlexibleInstances, ExistentialQuantification, DeriveDataTypeable #-}</span> <a name="line-3"></a><span class='hs-comment'>-- | The BlazeHtml core, consisting of functions that offer the power to</span> <a name="line-4"></a><span class='hs-comment'>-- generate custom HTML elements. It also offers user-centric functions, which</span> <a name="line-5"></a><span class='hs-comment'>-- are exposed through 'Text.Blaze'.</span> <a name="line-6"></a><span class='hs-comment'>--</span> <a name="line-7"></a><span class='hs-comment'>-- While this module is exported, usage of it is not recommended, unless you</span> <a name="line-8"></a><span class='hs-comment'>-- know what you are doing. This module might undergo changes at any time.</span> <a name="line-9"></a><span class='hs-comment'>--</span> <a name="line-10"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Blaze</span><span class='hs-varop'>.</span><span class='hs-conid'>Internal</span> <a name="line-11"></a> <span class='hs-layout'>(</span> <a name="line-12"></a> <span class='hs-comment'>-- * Important types.</span> <a name="line-13"></a> <span class='hs-conid'>ChoiceString</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <a name="line-14"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>StaticString</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <a name="line-15"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>HtmlM</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <a name="line-16"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Html</span> <a name="line-17"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Tag</span> <a name="line-18"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Attribute</span> <a name="line-19"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>AttributeValue</span> <a name="line-20"></a> <a name="line-21"></a> <span class='hs-comment'>-- * Creating custom tags and attributes.</span> <a name="line-22"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>attribute</span> <a name="line-23"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>dataAttribute</span> <a name="line-24"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>customAttribute</span> <a name="line-25"></a> <a name="line-26"></a> <span class='hs-comment'>-- * Converting values to HTML.</span> <a name="line-27"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>text</span> <a name="line-28"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>preEscapedText</span> <a name="line-29"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>lazyText</span> <a name="line-30"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>preEscapedLazyText</span> <a name="line-31"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>string</span> <a name="line-32"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>preEscapedString</span> <a name="line-33"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unsafeByteString</span> <a name="line-34"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unsafeLazyByteString</span> <a name="line-35"></a> <a name="line-36"></a> <span class='hs-comment'>-- * Converting values to tags.</span> <a name="line-37"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>textTag</span> <a name="line-38"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stringTag</span> <a name="line-39"></a> <a name="line-40"></a> <span class='hs-comment'>-- * Converting values to attribute values.</span> <a name="line-41"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>textValue</span> <a name="line-42"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>preEscapedTextValue</span> <a name="line-43"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>lazyTextValue</span> <a name="line-44"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>preEscapedLazyTextValue</span> <a name="line-45"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stringValue</span> <a name="line-46"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>preEscapedStringValue</span> <a name="line-47"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unsafeByteStringValue</span> <a name="line-48"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unsafeLazyByteStringValue</span> <a name="line-49"></a> <a name="line-50"></a> <span class='hs-comment'>-- * Setting attributes</span> <a name="line-51"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>!</span><span class='hs-layout'>)</span> <a name="line-52"></a> <a name="line-53"></a> <span class='hs-comment'>-- * Modifying HTML elements</span> <a name="line-54"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>external</span> <a name="line-55"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-56"></a> <a name="line-57"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Monoid</span> <span class='hs-layout'>(</span><span class='hs-conid'>Monoid</span><span class='hs-layout'>,</span> <span class='hs-varid'>mappend</span><span class='hs-layout'>,</span> <span class='hs-varid'>mempty</span><span class='hs-layout'>,</span> <span class='hs-varid'>mconcat</span><span class='hs-layout'>)</span> <a name="line-58"></a> <a name="line-59"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-varop'>.</span><span class='hs-conid'>Char8</span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-60"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-61"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Typeable</span> <span class='hs-layout'>(</span><span class='hs-conid'>Typeable</span><span class='hs-layout'>)</span> <a name="line-62"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>Exts</span> <span class='hs-layout'>(</span><span class='hs-conid'>IsString</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-63"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>B</span> <a name="line-64"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-varop'>.</span><span class='hs-conid'>Lazy</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>BL</span> <a name="line-65"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>T</span> <a name="line-66"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Encoding</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>T</span> <a name="line-67"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Lazy</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>LT</span> <a name="line-68"></a> <a name="line-69"></a><a name="StaticString"></a><span class='hs-comment'>-- | A static string that supports efficient output to all possible backends.</span> <a name="line-70"></a><a name="StaticString"></a><span class='hs-comment'>--</span> <a name="line-71"></a><a name="StaticString"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>StaticString</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>StaticString</span> <a name="line-72"></a> <span class='hs-layout'>{</span> <span class='hs-varid'>getString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span> <span class='hs-comment'>-- ^ Appending haskell string</span> <a name="line-73"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>getUtf8ByteString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ UTF-8 encoded bytestring</span> <a name="line-74"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>getText</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Text value</span> <a name="line-75"></a> <span class='hs-layout'>}</span> <a name="line-76"></a> <a name="line-77"></a><span class='hs-comment'>-- 'StaticString's should only be converted from string literals, as far as I</span> <a name="line-78"></a><span class='hs-comment'>-- can see.</span> <a name="line-79"></a><span class='hs-comment'>--</span> <a name="line-80"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>IsString</span> <span class='hs-conid'>StaticString</span> <span class='hs-keyword'>where</span> <a name="line-81"></a> <span class='hs-varid'>fromString</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>T</span><span class='hs-varop'>.</span><span class='hs-varid'>pack</span> <span class='hs-varid'>s</span> <a name="line-82"></a> <span class='hs-keyword'>in</span> <span class='hs-conid'>StaticString</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span> <span class='hs-varop'>++</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>T</span><span class='hs-varop'>.</span><span class='hs-varid'>encodeUtf8</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-varid'>t</span> <a name="line-83"></a> <a name="line-84"></a><a name="ChoiceString"></a><span class='hs-comment'>-- | A string denoting input from different string representations.</span> <a name="line-85"></a><a name="ChoiceString"></a><span class='hs-comment'>--</span> <a name="line-86"></a><a name="ChoiceString"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>ChoiceString</span> <a name="line-87"></a> <span class='hs-comment'>-- | Static data</span> <a name="line-88"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Static</span> <span class='hs-comment'>{-# UNPACK #-}</span> <span class='hs-varop'>!</span><span class='hs-conid'>StaticString</span> <a name="line-89"></a> <span class='hs-comment'>-- | A Haskell String</span> <a name="line-90"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>String</span> <span class='hs-conid'>String</span> <a name="line-91"></a> <span class='hs-comment'>-- | A Text value</span> <a name="line-92"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Text</span> <span class='hs-conid'>Text</span> <a name="line-93"></a> <span class='hs-comment'>-- | An encoded bytestring</span> <a name="line-94"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>ByteString</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <a name="line-95"></a> <span class='hs-comment'>-- | A pre-escaped string</span> <a name="line-96"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>PreEscaped</span> <span class='hs-conid'>ChoiceString</span> <a name="line-97"></a> <span class='hs-comment'>-- | External data in style/script tags, should be checked for validity</span> <a name="line-98"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>External</span> <span class='hs-conid'>ChoiceString</span> <a name="line-99"></a> <span class='hs-comment'>-- | Concatenation</span> <a name="line-100"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>AppendChoiceString</span> <span class='hs-conid'>ChoiceString</span> <span class='hs-conid'>ChoiceString</span> <a name="line-101"></a> <span class='hs-comment'>-- | Empty string</span> <a name="line-102"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>EmptyChoiceString</span> <a name="line-103"></a> <a name="line-104"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monoid</span> <span class='hs-conid'>ChoiceString</span> <span class='hs-keyword'>where</span> <a name="line-105"></a> <span class='hs-varid'>mempty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EmptyChoiceString</span> <a name="line-106"></a> <span class='hs-comment'>{-# INLINE mempty #-}</span> <a name="line-107"></a> <span class='hs-varid'>mappend</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AppendChoiceString</span> <a name="line-108"></a> <span class='hs-comment'>{-# INLINE mappend #-}</span> <a name="line-109"></a> <a name="line-110"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>IsString</span> <span class='hs-conid'>ChoiceString</span> <span class='hs-keyword'>where</span> <a name="line-111"></a> <span class='hs-varid'>fromString</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>String</span> <a name="line-112"></a> <span class='hs-comment'>{-# INLINE fromString #-}</span> <a name="line-113"></a> <a name="line-114"></a><a name="HtmlM"></a><span class='hs-comment'>-- | The core HTML datatype.</span> <a name="line-115"></a><a name="HtmlM"></a><span class='hs-comment'>--</span> <a name="line-116"></a><a name="HtmlM"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span> <a name="line-117"></a> <span class='hs-comment'>-- | Tag, open tag, end tag, content</span> <a name="line-118"></a> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>forall</span> <span class='hs-varid'>b</span><span class='hs-varop'>.</span> <span class='hs-conid'>Parent</span> <span class='hs-conid'>StaticString</span> <span class='hs-conid'>StaticString</span> <span class='hs-conid'>StaticString</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <a name="line-119"></a> <span class='hs-comment'>-- | Tag, open tag, end tag</span> <a name="line-120"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Leaf</span> <span class='hs-conid'>StaticString</span> <span class='hs-conid'>StaticString</span> <span class='hs-conid'>StaticString</span> <a name="line-121"></a> <span class='hs-comment'>-- | HTML content</span> <a name="line-122"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Content</span> <span class='hs-conid'>ChoiceString</span> <a name="line-123"></a> <span class='hs-comment'>-- | Concatenation of two HTML pieces</span> <a name="line-124"></a> <span class='hs-keyglyph'>|</span> <span class='hs-keyword'>forall</span> <span class='hs-varid'>b</span> <span class='hs-varid'>c</span><span class='hs-varop'>.</span> <span class='hs-conid'>Append</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-125"></a> <span class='hs-comment'>-- | Add an attribute to the inner HTML. Raw key, key, value, HTML to</span> <a name="line-126"></a> <span class='hs-comment'>-- receive the attribute.</span> <a name="line-127"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>AddAttribute</span> <span class='hs-conid'>StaticString</span> <span class='hs-conid'>StaticString</span> <span class='hs-conid'>ChoiceString</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-128"></a> <span class='hs-comment'>-- | Add a custom attribute to the inner HTML.</span> <a name="line-129"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>AddCustomAttribute</span> <span class='hs-conid'>ChoiceString</span> <span class='hs-conid'>ChoiceString</span> <span class='hs-conid'>ChoiceString</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-130"></a> <span class='hs-comment'>-- | Empty HTML.</span> <a name="line-131"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Empty</span> <a name="line-132"></a> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>Typeable</span><span class='hs-layout'>)</span> <a name="line-133"></a> <a name="line-134"></a><a name="Html"></a><span class='hs-comment'>-- | Simplification of the 'HtmlM' datatype.</span> <a name="line-135"></a><a name="Html"></a><span class='hs-comment'>--</span> <a name="line-136"></a><a name="Html"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>Html</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>HtmlM</span> <span class='hs-conid'>()</span> <a name="line-137"></a> <a name="line-138"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monoid</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Monoid</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-139"></a> <span class='hs-varid'>mempty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-140"></a> <span class='hs-comment'>{-# INLINE mempty #-}</span> <a name="line-141"></a> <span class='hs-varid'>mappend</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Append</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <a name="line-142"></a> <span class='hs-comment'>{-# INLINE mappend #-}</span> <a name="line-143"></a> <span class='hs-varid'>mconcat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldr</span> <span class='hs-conid'>Append</span> <span class='hs-conid'>Empty</span> <a name="line-144"></a> <span class='hs-comment'>{-# INLINE mconcat #-}</span> <a name="line-145"></a> <a name="line-146"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monad</span> <span class='hs-conid'>HtmlM</span> <span class='hs-keyword'>where</span> <a name="line-147"></a> <span class='hs-varid'>return</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-148"></a> <span class='hs-comment'>{-# INLINE return #-}</span> <a name="line-149"></a> <span class='hs-layout'>(</span><span class='hs-varop'>>></span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Append</span> <a name="line-150"></a> <span class='hs-comment'>{-# INLINE (>>) #-}</span> <a name="line-151"></a> <span class='hs-varid'>h1</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>h1</span> <span class='hs-varop'>>></span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>error</span> <span class='hs-str'>"_|_"</span><span class='hs-layout'>)</span> <a name="line-152"></a> <span class='hs-comment'>{-# INLINE (>>=) #-}</span> <a name="line-153"></a> <a name="line-154"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>IsString</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-155"></a> <span class='hs-varid'>fromString</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Content</span> <span class='hs-varop'>.</span> <span class='hs-varid'>fromString</span> <a name="line-156"></a> <span class='hs-comment'>{-# INLINE fromString #-}</span> <a name="line-157"></a> <a name="line-158"></a><a name="Tag"></a><span class='hs-comment'>-- | Type for an HTML tag. This can be seen as an internal string type used by</span> <a name="line-159"></a><a name="Tag"></a><span class='hs-comment'>-- BlazeHtml.</span> <a name="line-160"></a><a name="Tag"></a><span class='hs-comment'>--</span> <a name="line-161"></a><a name="Tag"></a><span class='hs-keyword'>newtype</span> <span class='hs-conid'>Tag</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Tag</span> <span class='hs-layout'>{</span> <span class='hs-varid'>unTag</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>StaticString</span> <span class='hs-layout'>}</span> <a name="line-162"></a> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>IsString</span><span class='hs-layout'>)</span> <a name="line-163"></a> <a name="line-164"></a><a name="Attribute"></a><span class='hs-comment'>-- | Type for an attribute.</span> <a name="line-165"></a><a name="Attribute"></a><span class='hs-comment'>--</span> <a name="line-166"></a><a name="Attribute"></a><span class='hs-keyword'>newtype</span> <span class='hs-conid'>Attribute</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Attribute</span> <span class='hs-layout'>(</span><span class='hs-keyword'>forall</span> <span class='hs-varid'>a</span><span class='hs-varop'>.</span> <span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-167"></a> <a name="line-168"></a><a name="AttributeValue"></a><span class='hs-comment'>-- | The type for the value part of an attribute.</span> <a name="line-169"></a><a name="AttributeValue"></a><span class='hs-comment'>--</span> <a name="line-170"></a><a name="AttributeValue"></a><span class='hs-keyword'>newtype</span> <span class='hs-conid'>AttributeValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AttributeValue</span> <span class='hs-layout'>{</span> <span class='hs-varid'>unAttributeValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ChoiceString</span> <span class='hs-layout'>}</span> <a name="line-171"></a> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>IsString</span><span class='hs-layout'>,</span> <span class='hs-conid'>Monoid</span><span class='hs-layout'>)</span> <a name="line-172"></a> <a name="line-173"></a><a name="attribute"></a><span class='hs-comment'>-- | Create an HTML attribute that can be applied to an HTML element later using</span> <a name="line-174"></a><span class='hs-comment'>-- the '!' operator.</span> <a name="line-175"></a><span class='hs-comment'>--</span> <a name="line-176"></a><span class='hs-definition'>attribute</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Tag</span> <span class='hs-comment'>-- ^ Raw key</span> <a name="line-177"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Tag</span> <span class='hs-comment'>-- ^ Shared key string for the HTML attribute.</span> <a name="line-178"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Value for the HTML attribute.</span> <a name="line-179"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Attribute</span> <span class='hs-comment'>-- ^ Resulting HTML attribute.</span> <a name="line-180"></a><span class='hs-definition'>attribute</span> <span class='hs-varid'>rawKey</span> <span class='hs-varid'>key</span> <span class='hs-varid'>value</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Attribute</span> <span class='hs-varop'>$</span> <a name="line-181"></a> <span class='hs-conid'>AddAttribute</span> <span class='hs-layout'>(</span><span class='hs-varid'>unTag</span> <span class='hs-varid'>rawKey</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>unTag</span> <span class='hs-varid'>key</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>unAttributeValue</span> <span class='hs-varid'>value</span><span class='hs-layout'>)</span> <a name="line-182"></a><span class='hs-comment'>{-# INLINE attribute #-}</span> <a name="line-183"></a> <a name="line-184"></a><a name="dataAttribute"></a><span class='hs-comment'>-- | From HTML 5 onwards, the user is able to specify custom data attributes.</span> <a name="line-185"></a><span class='hs-comment'>--</span> <a name="line-186"></a><span class='hs-comment'>-- An example:</span> <a name="line-187"></a><span class='hs-comment'>--</span> <a name="line-188"></a><span class='hs-comment'>-- > <p data-foo="bar">Hello.</p></span> <a name="line-189"></a><span class='hs-comment'>--</span> <a name="line-190"></a><span class='hs-comment'>-- We support this in BlazeHtml using this funcion. The above fragment could</span> <a name="line-191"></a><span class='hs-comment'>-- be described using BlazeHtml with:</span> <a name="line-192"></a><span class='hs-comment'>--</span> <a name="line-193"></a><span class='hs-comment'>-- > p ! dataAttribute "foo" "bar" $ "Hello."</span> <a name="line-194"></a><span class='hs-comment'>--</span> <a name="line-195"></a><span class='hs-definition'>dataAttribute</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Tag</span> <span class='hs-comment'>-- ^ Name of the attribute.</span> <a name="line-196"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Value for the attribute.</span> <a name="line-197"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Attribute</span> <span class='hs-comment'>-- ^ Resulting HTML attribute.</span> <a name="line-198"></a><span class='hs-definition'>dataAttribute</span> <span class='hs-varid'>tag</span> <span class='hs-varid'>value</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Attribute</span> <span class='hs-varop'>$</span> <span class='hs-conid'>AddCustomAttribute</span> <a name="line-199"></a> <span class='hs-layout'>(</span><span class='hs-conid'>Static</span> <span class='hs-str'>"data-"</span> <span class='hs-varop'>`mappend`</span> <span class='hs-conid'>Static</span> <span class='hs-layout'>(</span><span class='hs-varid'>unTag</span> <span class='hs-varid'>tag</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-200"></a> <span class='hs-layout'>(</span><span class='hs-conid'>Static</span> <span class='hs-str'>" data-"</span> <span class='hs-varop'>`mappend`</span> <span class='hs-conid'>Static</span> <span class='hs-layout'>(</span><span class='hs-varid'>unTag</span> <span class='hs-varid'>tag</span><span class='hs-layout'>)</span> <span class='hs-varop'>`mappend`</span> <span class='hs-conid'>Static</span> <span class='hs-str'>"=\""</span><span class='hs-layout'>)</span> <a name="line-201"></a> <span class='hs-layout'>(</span><span class='hs-varid'>unAttributeValue</span> <span class='hs-varid'>value</span><span class='hs-layout'>)</span> <a name="line-202"></a><span class='hs-comment'>{-# INLINE dataAttribute #-}</span> <a name="line-203"></a> <a name="line-204"></a><a name="customAttribute"></a><span class='hs-comment'>-- | Create a custom attribute. This is not specified in the HTML spec, but some</span> <a name="line-205"></a><span class='hs-comment'>-- JavaScript libraries rely on it.</span> <a name="line-206"></a><span class='hs-comment'>--</span> <a name="line-207"></a><span class='hs-comment'>-- An example:</span> <a name="line-208"></a><span class='hs-comment'>--</span> <a name="line-209"></a><span class='hs-comment'>-- > <select dojoType="select">foo</select></span> <a name="line-210"></a><span class='hs-comment'>--</span> <a name="line-211"></a><span class='hs-comment'>-- Can be produced using:</span> <a name="line-212"></a><span class='hs-comment'>--</span> <a name="line-213"></a><span class='hs-comment'>-- > select ! customAttribute "dojoType" "select" $ "foo"</span> <a name="line-214"></a><span class='hs-comment'>--</span> <a name="line-215"></a><span class='hs-definition'>customAttribute</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Tag</span> <span class='hs-comment'>-- ^ Name of the attribute</span> <a name="line-216"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Value for the attribute</span> <a name="line-217"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Attribute</span> <span class='hs-comment'>-- ^ Resulting HTML attribtue</span> <a name="line-218"></a><span class='hs-definition'>customAttribute</span> <span class='hs-varid'>tag</span> <span class='hs-varid'>value</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Attribute</span> <span class='hs-varop'>$</span> <span class='hs-conid'>AddCustomAttribute</span> <a name="line-219"></a> <span class='hs-layout'>(</span><span class='hs-conid'>Static</span> <span class='hs-varop'>$</span> <span class='hs-varid'>unTag</span> <span class='hs-varid'>tag</span><span class='hs-layout'>)</span> <a name="line-220"></a> <span class='hs-layout'>(</span><span class='hs-conid'>Static</span> <span class='hs-str'>" "</span> <span class='hs-varop'>`mappend`</span> <span class='hs-conid'>Static</span> <span class='hs-layout'>(</span><span class='hs-varid'>unTag</span> <span class='hs-varid'>tag</span><span class='hs-layout'>)</span> <span class='hs-varop'>`mappend`</span> <span class='hs-conid'>Static</span> <span class='hs-str'>"=\""</span><span class='hs-layout'>)</span> <a name="line-221"></a> <span class='hs-layout'>(</span><span class='hs-varid'>unAttributeValue</span> <span class='hs-varid'>value</span><span class='hs-layout'>)</span> <a name="line-222"></a><span class='hs-comment'>{-# INLINE customAttribute #-}</span> <a name="line-223"></a> <a name="line-224"></a><a name="text"></a><span class='hs-comment'>-- | Render text. Functions like these can be used to supply content in HTML.</span> <a name="line-225"></a><span class='hs-comment'>--</span> <a name="line-226"></a><span class='hs-definition'>text</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Text to render.</span> <a name="line-227"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Html</span> <span class='hs-comment'>-- ^ Resulting HTML fragment.</span> <a name="line-228"></a><span class='hs-definition'>text</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Content</span> <span class='hs-varop'>.</span> <span class='hs-conid'>Text</span> <a name="line-229"></a><span class='hs-comment'>{-# DEPRECATED text "Use Blaze.Html.toHtml" #-}</span> <a name="line-230"></a><span class='hs-comment'>{-# INLINE text #-}</span> <a name="line-231"></a> <a name="line-232"></a><a name="preEscapedText"></a><span class='hs-comment'>-- | Render text without escaping.</span> <a name="line-233"></a><span class='hs-comment'>--</span> <a name="line-234"></a><span class='hs-definition'>preEscapedText</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Text to insert</span> <a name="line-235"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Html</span> <span class='hs-comment'>-- ^ Resulting HTML fragment</span> <a name="line-236"></a><span class='hs-definition'>preEscapedText</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Content</span> <span class='hs-varop'>.</span> <span class='hs-conid'>PreEscaped</span> <span class='hs-varop'>.</span> <span class='hs-conid'>Text</span> <a name="line-237"></a><span class='hs-comment'>{-# INLINE preEscapedText #-}</span> <a name="line-238"></a> <a name="line-239"></a><a name="lazyText"></a><span class='hs-comment'>-- | A variant of 'text' for lazy 'LT.Text'.</span> <a name="line-240"></a><span class='hs-comment'>--</span> <a name="line-241"></a><span class='hs-definition'>lazyText</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>LT</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Text to insert</span> <a name="line-242"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Html</span> <span class='hs-comment'>-- ^ Resulting HTML fragment</span> <a name="line-243"></a><span class='hs-definition'>lazyText</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mconcat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>map</span> <span class='hs-varid'>text</span> <span class='hs-varop'>.</span> <span class='hs-conid'>LT</span><span class='hs-varop'>.</span><span class='hs-varid'>toChunks</span> <a name="line-244"></a><span class='hs-comment'>{-# DEPRECATED lazyText "Use Blaze.Html.toHtml" #-}</span> <a name="line-245"></a><span class='hs-comment'>{-# INLINE lazyText #-}</span> <a name="line-246"></a> <a name="line-247"></a><a name="preEscapedLazyText"></a><span class='hs-comment'>-- | A variant of 'preEscapedText' for lazy 'LT.Text'</span> <a name="line-248"></a><span class='hs-comment'>--</span> <a name="line-249"></a><span class='hs-definition'>preEscapedLazyText</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>LT</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Text to insert</span> <a name="line-250"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Html</span> <span class='hs-comment'>-- ^ Resulting HTML fragment</span> <a name="line-251"></a><span class='hs-definition'>preEscapedLazyText</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mconcat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>map</span> <span class='hs-varid'>preEscapedText</span> <span class='hs-varop'>.</span> <span class='hs-conid'>LT</span><span class='hs-varop'>.</span><span class='hs-varid'>toChunks</span> <a name="line-252"></a> <a name="line-253"></a><a name="string"></a><span class='hs-comment'>-- | Create an HTML snippet from a 'String'.</span> <a name="line-254"></a><span class='hs-comment'>--</span> <a name="line-255"></a><span class='hs-definition'>string</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-comment'>-- ^ String to insert.</span> <a name="line-256"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Html</span> <span class='hs-comment'>-- ^ Resulting HTML fragment.</span> <a name="line-257"></a><span class='hs-definition'>string</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Content</span> <span class='hs-varop'>.</span> <span class='hs-conid'>String</span> <a name="line-258"></a><span class='hs-comment'>{-# DEPRECATED string "Use Blaze.Html.toHtml" #-}</span> <a name="line-259"></a><span class='hs-comment'>{-# INLINE string #-}</span> <a name="line-260"></a> <a name="line-261"></a><a name="preEscapedString"></a><span class='hs-comment'>-- | Create an HTML snippet from a 'String' without escaping</span> <a name="line-262"></a><span class='hs-comment'>--</span> <a name="line-263"></a><span class='hs-definition'>preEscapedString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-comment'>-- ^ String to insert.</span> <a name="line-264"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Html</span> <span class='hs-comment'>-- ^ Resulting HTML fragment.</span> <a name="line-265"></a><span class='hs-definition'>preEscapedString</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Content</span> <span class='hs-varop'>.</span> <span class='hs-conid'>PreEscaped</span> <span class='hs-varop'>.</span> <span class='hs-conid'>String</span> <a name="line-266"></a><span class='hs-comment'>{-# INLINE preEscapedString #-}</span> <a name="line-267"></a> <a name="line-268"></a><a name="unsafeByteString"></a><span class='hs-comment'>-- | Insert a 'ByteString'. This is an unsafe operation:</span> <a name="line-269"></a><span class='hs-comment'>--</span> <a name="line-270"></a><span class='hs-comment'>-- * The 'ByteString' could have the wrong encoding.</span> <a name="line-271"></a><span class='hs-comment'>--</span> <a name="line-272"></a><span class='hs-comment'>-- * The 'ByteString' might contain illegal HTML characters (no escaping is</span> <a name="line-273"></a><span class='hs-comment'>-- done).</span> <a name="line-274"></a><span class='hs-comment'>--</span> <a name="line-275"></a><span class='hs-definition'>unsafeByteString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ Value to insert.</span> <a name="line-276"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Html</span> <span class='hs-comment'>-- ^ Resulting HTML fragment.</span> <a name="line-277"></a><span class='hs-definition'>unsafeByteString</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Content</span> <span class='hs-varop'>.</span> <span class='hs-conid'>ByteString</span> <a name="line-278"></a><span class='hs-comment'>{-# INLINE unsafeByteString #-}</span> <a name="line-279"></a> <a name="line-280"></a><a name="unsafeLazyByteString"></a><span class='hs-comment'>-- | Insert a lazy 'BL.ByteString'. See 'unsafeByteString' for reasons why this</span> <a name="line-281"></a><span class='hs-comment'>-- is an unsafe operation.</span> <a name="line-282"></a><span class='hs-comment'>--</span> <a name="line-283"></a><span class='hs-definition'>unsafeLazyByteString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>BL</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ Value to insert</span> <a name="line-284"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Html</span> <span class='hs-comment'>-- ^ Resulting HTML fragment</span> <a name="line-285"></a><span class='hs-definition'>unsafeLazyByteString</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mconcat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>map</span> <span class='hs-varid'>unsafeByteString</span> <span class='hs-varop'>.</span> <span class='hs-conid'>BL</span><span class='hs-varop'>.</span><span class='hs-varid'>toChunks</span> <a name="line-286"></a><span class='hs-comment'>{-# INLINE unsafeLazyByteString #-}</span> <a name="line-287"></a> <a name="line-288"></a><a name="textTag"></a><span class='hs-comment'>-- | Create a 'Tag' from some 'Text'.</span> <a name="line-289"></a><span class='hs-comment'>--</span> <a name="line-290"></a><span class='hs-definition'>textTag</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Text to create a tag from</span> <a name="line-291"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Tag</span> <span class='hs-comment'>-- ^ Resulting tag</span> <a name="line-292"></a><span class='hs-definition'>textTag</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Tag</span> <span class='hs-varop'>$</span> <span class='hs-conid'>StaticString</span> <span class='hs-layout'>(</span><span class='hs-conid'>T</span><span class='hs-varop'>.</span><span class='hs-varid'>unpack</span> <span class='hs-varid'>t</span> <span class='hs-varop'>++</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>T</span><span class='hs-varop'>.</span><span class='hs-varid'>encodeUtf8</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-varid'>t</span> <a name="line-293"></a> <a name="line-294"></a><a name="stringTag"></a><span class='hs-comment'>-- | Create a 'Tag' from a 'String'.</span> <a name="line-295"></a><span class='hs-comment'>--</span> <a name="line-296"></a><span class='hs-definition'>stringTag</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-comment'>-- ^ String to create a tag from</span> <a name="line-297"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Tag</span> <span class='hs-comment'>-- ^ Resulting tag</span> <a name="line-298"></a><span class='hs-definition'>stringTag</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Tag</span> <span class='hs-varop'>.</span> <span class='hs-varid'>fromString</span> <a name="line-299"></a> <a name="line-300"></a><a name="textValue"></a><span class='hs-comment'>-- | Render an attribute value from 'Text'.</span> <a name="line-301"></a><span class='hs-comment'>--</span> <a name="line-302"></a><span class='hs-definition'>textValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ The actual value.</span> <a name="line-303"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Resulting attribute value.</span> <a name="line-304"></a><span class='hs-definition'>textValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AttributeValue</span> <span class='hs-varop'>.</span> <span class='hs-conid'>Text</span> <a name="line-305"></a><span class='hs-comment'>{-# DEPRECATED textValue "Use Blaze.Html.toValue" #-}</span> <a name="line-306"></a><span class='hs-comment'>{-# INLINE textValue #-}</span> <a name="line-307"></a> <a name="line-308"></a><a name="preEscapedTextValue"></a><span class='hs-comment'>-- | Render an attribute value from 'Text' without escaping.</span> <a name="line-309"></a><span class='hs-comment'>--</span> <a name="line-310"></a><span class='hs-definition'>preEscapedTextValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ The actual value</span> <a name="line-311"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Resulting attribute value</span> <a name="line-312"></a><span class='hs-definition'>preEscapedTextValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AttributeValue</span> <span class='hs-varop'>.</span> <span class='hs-conid'>PreEscaped</span> <span class='hs-varop'>.</span> <span class='hs-conid'>Text</span> <a name="line-313"></a><span class='hs-comment'>{-# INLINE preEscapedTextValue #-}</span> <a name="line-314"></a> <a name="line-315"></a><a name="lazyTextValue"></a><span class='hs-comment'>-- | A variant of 'textValue' for lazy 'LT.Text'</span> <a name="line-316"></a><span class='hs-comment'>--</span> <a name="line-317"></a><span class='hs-definition'>lazyTextValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>LT</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ The actual value</span> <a name="line-318"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Resulting attribute value</span> <a name="line-319"></a><span class='hs-definition'>lazyTextValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mconcat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>map</span> <span class='hs-varid'>textValue</span> <span class='hs-varop'>.</span> <span class='hs-conid'>LT</span><span class='hs-varop'>.</span><span class='hs-varid'>toChunks</span> <a name="line-320"></a><span class='hs-comment'>{-# DEPRECATED lazyTextValue "Use Blaze.Html.toValue" #-}</span> <a name="line-321"></a><span class='hs-comment'>{-# INLINE lazyTextValue #-}</span> <a name="line-322"></a> <a name="line-323"></a><a name="preEscapedLazyTextValue"></a><span class='hs-comment'>-- | A variant of 'preEscapedTextValue' for lazy 'LT.Text'</span> <a name="line-324"></a><span class='hs-comment'>--</span> <a name="line-325"></a><span class='hs-definition'>preEscapedLazyTextValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>LT</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ The actual value</span> <a name="line-326"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Resulting attribute value</span> <a name="line-327"></a><span class='hs-definition'>preEscapedLazyTextValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mconcat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>map</span> <span class='hs-varid'>preEscapedTextValue</span> <span class='hs-varop'>.</span> <span class='hs-conid'>LT</span><span class='hs-varop'>.</span><span class='hs-varid'>toChunks</span> <a name="line-328"></a><span class='hs-comment'>{-# INLINE preEscapedLazyTextValue #-}</span> <a name="line-329"></a> <a name="line-330"></a><a name="stringValue"></a><span class='hs-comment'>-- | Create an attribute value from a 'String'.</span> <a name="line-331"></a><span class='hs-comment'>--</span> <a name="line-332"></a><span class='hs-definition'>stringValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <a name="line-333"></a><span class='hs-definition'>stringValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AttributeValue</span> <span class='hs-varop'>.</span> <span class='hs-conid'>String</span> <a name="line-334"></a><span class='hs-comment'>{-# DEPRECATED stringValue "Use Blaze.Html.toValue" #-}</span> <a name="line-335"></a><span class='hs-comment'>{-# INLINE stringValue #-}</span> <a name="line-336"></a> <a name="line-337"></a><a name="preEscapedStringValue"></a><span class='hs-comment'>-- | Create an attribute value from a 'String' without escaping.</span> <a name="line-338"></a><span class='hs-comment'>--</span> <a name="line-339"></a><span class='hs-definition'>preEscapedStringValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <a name="line-340"></a><span class='hs-definition'>preEscapedStringValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AttributeValue</span> <span class='hs-varop'>.</span> <span class='hs-conid'>PreEscaped</span> <span class='hs-varop'>.</span> <span class='hs-conid'>String</span> <a name="line-341"></a><span class='hs-comment'>{-# INLINE preEscapedStringValue #-}</span> <a name="line-342"></a> <a name="line-343"></a><a name="unsafeByteStringValue"></a><span class='hs-comment'>-- | Create an attribute value from a 'ByteString'. See 'unsafeByteString'</span> <a name="line-344"></a><span class='hs-comment'>-- for reasons why this might not be a good idea.</span> <a name="line-345"></a><span class='hs-comment'>--</span> <a name="line-346"></a><span class='hs-definition'>unsafeByteStringValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ ByteString value</span> <a name="line-347"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Resulting attribute value</span> <a name="line-348"></a><span class='hs-definition'>unsafeByteStringValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AttributeValue</span> <span class='hs-varop'>.</span> <span class='hs-conid'>ByteString</span> <a name="line-349"></a><span class='hs-comment'>{-# INLINE unsafeByteStringValue #-}</span> <a name="line-350"></a> <a name="line-351"></a><a name="unsafeLazyByteStringValue"></a><span class='hs-comment'>-- | Create an attribute value from a lazy 'BL.ByteString'. See</span> <a name="line-352"></a><span class='hs-comment'>-- 'unsafeByteString' for reasons why this might not be a good idea.</span> <a name="line-353"></a><span class='hs-comment'>--</span> <a name="line-354"></a><span class='hs-definition'>unsafeLazyByteStringValue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>BL</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ ByteString value</span> <a name="line-355"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>AttributeValue</span> <span class='hs-comment'>-- ^ Resulting attribute value</span> <a name="line-356"></a><span class='hs-definition'>unsafeLazyByteStringValue</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mconcat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>map</span> <span class='hs-varid'>unsafeByteStringValue</span> <span class='hs-varop'>.</span> <span class='hs-conid'>BL</span><span class='hs-varop'>.</span><span class='hs-varid'>toChunks</span> <a name="line-357"></a><span class='hs-comment'>{-# INLINE unsafeLazyByteStringValue #-}</span> <a name="line-358"></a> <a name="line-359"></a><a name="Attributable"></a><span class='hs-keyword'>class</span> <span class='hs-conid'>Attributable</span> <span class='hs-varid'>h</span> <span class='hs-keyword'>where</span> <a name="line-360"></a> <span class='hs-comment'>-- | Apply an attribute to an element.</span> <a name="line-361"></a> <span class='hs-comment'>--</span> <a name="line-362"></a> <span class='hs-comment'>-- Example:</span> <a name="line-363"></a> <span class='hs-comment'>--</span> <a name="line-364"></a> <span class='hs-comment'>-- > img ! src "foo.png"</span> <a name="line-365"></a> <span class='hs-comment'>--</span> <a name="line-366"></a> <span class='hs-comment'>-- Result:</span> <a name="line-367"></a> <span class='hs-comment'>--</span> <a name="line-368"></a> <span class='hs-comment'>-- > <img src="foo.png" /></span> <a name="line-369"></a> <span class='hs-comment'>--</span> <a name="line-370"></a> <span class='hs-comment'>-- This can be used on nested elements as well.</span> <a name="line-371"></a> <span class='hs-comment'>--</span> <a name="line-372"></a> <span class='hs-comment'>-- Example:</span> <a name="line-373"></a> <span class='hs-comment'>--</span> <a name="line-374"></a> <span class='hs-comment'>-- > p ! style "float: right" $ "Hello!"</span> <a name="line-375"></a> <span class='hs-comment'>--</span> <a name="line-376"></a> <span class='hs-comment'>-- Result:</span> <a name="line-377"></a> <span class='hs-comment'>--</span> <a name="line-378"></a> <span class='hs-comment'>-- > <p style="float: right">Hello!</p></span> <a name="line-379"></a> <span class='hs-comment'>--</span> <a name="line-380"></a> <span class='hs-layout'>(</span><span class='hs-varop'>!</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>h</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Attribute</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>h</span> <a name="line-381"></a> <a name="line-382"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Attributable</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-383"></a> <span class='hs-varid'>h</span> <span class='hs-varop'>!</span> <span class='hs-layout'>(</span><span class='hs-conid'>Attribute</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-varid'>h</span> <a name="line-384"></a> <span class='hs-comment'>{-# INLINE (!) #-}</span> <a name="line-385"></a> <a name="line-386"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Attributable</span> <span class='hs-layout'>(</span><span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>HtmlM</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-387"></a> <span class='hs-varid'>h</span> <span class='hs-varop'>!</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varop'>!</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>h</span> <a name="line-388"></a> <span class='hs-comment'>{-# INLINE (!) #-}</span> <a name="line-389"></a> <a name="line-390"></a><a name="external"></a><span class='hs-comment'>-- | Mark HTML as external data. External data can be:</span> <a name="line-391"></a><span class='hs-comment'>--</span> <a name="line-392"></a><span class='hs-comment'>-- * CSS data in a @<style>@ tag;</span> <a name="line-393"></a><span class='hs-comment'>--</span> <a name="line-394"></a><span class='hs-comment'>-- * Script data in a @<script>@ tag.</span> <a name="line-395"></a><span class='hs-comment'>--</span> <a name="line-396"></a><span class='hs-comment'>-- This function is applied automatically when using the @style@ or @script@</span> <a name="line-397"></a><span class='hs-comment'>-- combinators.</span> <a name="line-398"></a><span class='hs-comment'>--</span> <a name="line-399"></a><span class='hs-definition'>external</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>HtmlM</span> <span class='hs-varid'>a</span> <a name="line-400"></a><span class='hs-definition'>external</span> <span class='hs-layout'>(</span><span class='hs-conid'>Content</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Content</span> <span class='hs-varop'>$</span> <span class='hs-conid'>External</span> <span class='hs-varid'>x</span> <a name="line-401"></a><span class='hs-definition'>external</span> <span class='hs-layout'>(</span><span class='hs-conid'>Append</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Append</span> <span class='hs-layout'>(</span><span class='hs-varid'>external</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>external</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <a name="line-402"></a><span class='hs-definition'>external</span> <span class='hs-layout'>(</span><span class='hs-conid'>Parent</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-varid'>z</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Parent</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-varid'>z</span> <span class='hs-varop'>$</span> <span class='hs-varid'>external</span> <span class='hs-varid'>i</span> <a name="line-403"></a><span class='hs-definition'>external</span> <span class='hs-layout'>(</span><span class='hs-conid'>AddAttribute</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-varid'>z</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AddAttribute</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-varid'>z</span> <span class='hs-varop'>$</span> <span class='hs-varid'>external</span> <span class='hs-varid'>i</span> <a name="line-404"></a><span class='hs-definition'>external</span> <span class='hs-layout'>(</span><span class='hs-conid'>AddCustomAttribute</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-varid'>z</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AddCustomAttribute</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-varid'>z</span> <span class='hs-varop'>$</span> <span class='hs-varid'>external</span> <span class='hs-varid'>i</span> <a name="line-405"></a><span class='hs-definition'>external</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x</span> <a name="line-406"></a><span class='hs-comment'>{-# INLINE external #-}</span> </pre></body> </html>