NAME¶
HTMLDocument::readFromString - Convert a String to HTML
SYNOPSIS¶
Void readFromString( ElementTree location, String input, WhiteList
safety, Doctype doctype )
ARGUMENTS¶
location The location in the document to append the converted String
input The String to convert
safety The allowed elements and attributes
doctype The document type of the input string. This is independent of the
document type of the document and controls certain aspects of parsing - for
example, if the doctype is
HTML4Strict , the end tags for
p or
td elements may be omitted, and the code will be case-insensitive.
DESCRIPTION¶
Convert a String to HTML. An Exception will be thrown if the parser cannot
construct an unambiguous tree from the string, and it is considerably less
forgiving than the parsers in most web browsers. (On the other hand, it's a
bit more forgiving in places than a strict XML parser, especially if the
HTML4Strict doctype is used). As usual, parsing with XHTML strictness
will be quicker.
Read the
HTMLDocument.WhiteList (3kaya) documentation for important
information on safety when converting these Strings
If you need to read poor-quality HTML, you can use the
TagSoup setting
for the doctype parameter, but this will be somewhat slower - if you're
writing the HTML yourself it's much more efficient to write good quality code
in the first place. This parsing model rarely throws an Exception (though it
is still possible on very poor code)
-
-
str = "<p>This is a <strong>crucial</strong>
paragraph</p>";
readFromString(parent,str,AllElements(Safe),HTML4Strict);
AUTHORS¶
Kaya standard library by Edwin Brady, Chris Morris and others
(kaya@kayalang.org). For further information see
http://kayalang.org/
LICENSE¶
The Kaya standard library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public License (version
2.1 or any later version) as published by the Free Software Foundation.
HTMLDocument.Doctype (3kaya)
HTMLDocument.WhiteList (3kaya)
HTMLDocument.readFromTemplate (3kaya)
HTMLDocument.string (3kaya)
