xhtml-3000.2.1: An XHTML combinator library

Safe HaskellSafe
LanguageHaskell98

Text.XHtml.Strict

Contents

Description

Produces XHTML 1.0 Strict.

Synopsis

Data types

data HtmlAttr Source

Attributes with name and value.

Instances

Classes

class HTML a where Source

HTML is the class of things that can be validly put inside an HTML tag. So this can be one or more Html elements, or a String, for example.

Minimal complete definition

toHtml

Methods

toHtml :: a -> Html Source

toHtmlFromList :: [a] -> Html Source

Instances

class ADDATTRS a where Source

Methods

(!) :: a -> [HtmlAttr] -> a infixl 8 Source

Instances

class CHANGEATTRS a where Source

CHANGEATTRS is a more expressive alternative to ADDATTRS

Methods

changeAttrs :: a -> ([HtmlAttr] -> [HtmlAttr]) -> a Source

Instances

Primitives and basic combinators

(<<) infixr 7 Source

Arguments

:: HTML a 
=> (Html -> b)

Parent

-> a

Child

-> b 

Put something inside an HTML element.

concatHtml :: HTML a => [a] -> Html Source

(+++) :: (HTML a, HTML b) => a -> b -> Html infixr 2 Source

Create a piece of HTML which is the concatenation of two things which can be made into HTML.

noHtml :: Html Source

An empty piece of HTML.

isNoHtml :: Html -> Bool Source

Checks whether the given piece of HTML is empty.

tag Source

Arguments

:: String

Element name

-> Html

Element contents

-> Html 

Constructs an element with a custom name.

itag :: String -> Html Source

Constructs an element with a custom name, and without any children.

primHtml :: String -> Html Source

This is not processed for special chars. use stringToHtml or lineToHtml instead, for user strings, because they understand special chars, like <.

stringToHtmlString :: String -> String Source

Processing Strings into Html friendly things.

docType :: String Source

The DOCTYPE for XHTML 1.0 Strict.

Rendering

showHtml :: HTML html => html -> String Source

Output the HTML without adding newlines or spaces within the markup. This should be the most time and space efficient way to render HTML, though the ouput is quite unreadable.

renderHtml :: HTML html => html -> String Source

Outputs indented HTML. Because space matters in HTML, the output is quite messy.

renderHtmlWithLanguage Source

Arguments

:: HTML html 
=> String

The code of the "dominant" language of the webpage.

-> html

All the Html, including a header.

-> String 

Outputs indented XHTML. Because space matters in HTML, the output is quite messy.

prettyHtml :: HTML html => html -> String Source

Outputs indented HTML, with indentation inside elements. This can change the meaning of the HTML document, and is mostly useful for debugging the HTML output. The implementation is inefficient, and you are normally better off using showHtml or renderHtml.

showHtmlFragment :: HTML html => html -> String Source

Render a piece of HTML without adding a DOCTYPE declaration or root element. Does not add any extra whitespace.

renderHtmlFragment :: HTML html => html -> String Source

Render a piece of indented HTML without adding a DOCTYPE declaration or root element. Only adds whitespace where it does not change the meaning of the document.

prettyHtmlFragment :: HTML html => html -> String Source

Render a piece of indented HTML without adding a DOCTYPE declaration or a root element. The indentation is done inside elements. This can change the meaning of the HTML document, and is mostly useful for debugging the HTML output. The implementation is inefficient, and you are normally better off using showHtmlFragment or renderHtmlFragment.

Elements in XHTML Strict

Attributes in XHTML Strict

Converting strings to HTML

stringToHtml :: String -> Html Source

Convert a String to Html, converting characters that need to be escaped to HTML entities.

lineToHtml :: String -> Html Source

This converts a string, but keeps spaces as non-line-breakable.

linesToHtml :: [String] -> Html Source

This converts a string, but keeps spaces as non-line-breakable, and adds line breaks between each of the strings in the input list.

Html abbreviations

copyright :: Html Source

Copyright sign.

spaceHtml :: Html Source

Non-breaking space.

p :: Html -> Html Source

Same as paragraph.

Hotlinks

Lists

ordList :: HTML a => [a] -> Html Source

unordList :: HTML a => [a] -> Html Source

defList :: (HTML a, HTML b) => [(a, b)] -> Html Source

Forms

menu :: String -> [Html] -> Html Source

Deprecated: menu generates strange XHTML, and is not flexible enough. Roll your own that suits your needs.