Text.HTML.Tree

Constructing forests

tokensToForest :: [Token] -> Either ParseTokenForestError (Forest Token)

construct a Forest from a Token list.

This code correctly handles void elements. Void elements are required to have a start tag and must not have an end tag. See nonClosing.

This code does not correctly handle optional tags. It assumes all optional start and end tags are present.

https://www.w3.org/TR/html52/syntax.html#optional-tags

data ParseTokenForestError

Constructors

ParseTokenForestErrorBracketMismatch PStack (Maybe Token)

Instances

Show ParseTokenForestError

Defined in Text.HTML.Tree

Methods

showsPrec :: Int -> ParseTokenForestError -> ShowS

show :: ParseTokenForestError -> String

showList :: [ParseTokenForestError] -> ShowS

Eq ParseTokenForestError

Defined in Text.HTML.Tree

Methods

(==) :: ParseTokenForestError -> ParseTokenForestError -> Bool

(/=) :: ParseTokenForestError -> ParseTokenForestError -> Bool

data PStack

Constructors

PStack

Fields

• _pstackToplevelSiblings :: Forest Token
• _pstackParents :: [(Token, Forest Token)]

Instances

Show PStack

Defined in Text.HTML.Tree

Methods

showsPrec :: Int -> PStack -> ShowS

show :: PStack -> String

showList :: [PStack] -> ShowS

Eq PStack

Defined in Text.HTML.Tree

Methods

(==) :: PStack -> PStack -> Bool

(/=) :: PStack -> PStack -> Bool

nonClosing :: [Text]

void elements which must not have an end tag

This list does not include the obsolete <command> and <keygen> elements.

 nonClosing = ["br", "hr", "img", "meta", "area", "base", "col", "embed", "input", "link", "param", "source", "track", "wbr"]

https://www.w3.org/TR/html52/syntax.html#void-elements

Deconstructing forests

tokensFromForest :: Forest Token -> [Token]

convert a Forest of Token into a list of Token.

This code correctly handles void elements. Void elements are required to have a start tag and must not have an end tag. See nonClosing.

tokensFromTree :: Tree Token -> [Token]

convert a Tree of Token into a list of Token.

This code correctly handles void elements. Void elements are required to have a start tag and must not have an end tag. See nonClosing.