Handling HTML: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
(Format)
Line 6: Line 6:
This page discusses various available options for working with [http://en.wikipedia.org/wiki/HTML HTML] documents in your Qt application. Please also read the general considerations outlined on the [[Handling_Document_Formats | Handling Document Formats]] page.
This page discusses various available options for working with [http://en.wikipedia.org/wiki/HTML HTML] documents in your Qt application. Please also read the general considerations outlined on the [[Handling_Document_Formats | Handling Document Formats]] page.


<pre style="background-color: #E6E6FA">Note that this information is collaboratively collected by the community, with no promise
{| style="background-color:LightCyan;" cellpadding="20" cellspacing="0" border="1"
| Note that this information is collaboratively collected by the community, with no promise
of completeness or correctness. In particular, use your own research and judgment
of completeness or correctness. In particular, use your own research and judgment
when evaluating third-party libraries or tools! </pre>
when evaluating third-party libraries or tools!
|}


== Reading / Writing ==
== Reading / Writing ==
Line 24: Line 26:
Keep in mind though that loading an HTML document in this way will not just passively parse it (like the Scribe framework or the XML/HTML parsers discussed below would), but actively evaluate it like a browser would, i.e. loading linked content like iframes, running JavaScript that is set to run on start-up, etc. Whether this is useful or problematic will depend on your specific use-case.
Keep in mind though that loading an HTML document in this way will not just passively parse it (like the Scribe framework or the XML/HTML parsers discussed below would), but actively evaluate it like a browser would, i.e. loading linked content like iframes, running JavaScript that is set to run on start-up, etc. Whether this is useful or problematic will depend on your specific use-case.


<pre style="background-color: moccasin">TODO: Can someone confirm whether this is true (and unavoidable), and edit this section accordingly?</pre>
{| style="background-color:moccasin;" cellpadding="20" cellspacing="0" border="1"
| TODO: Can someone confirm whether this is true (and unavoidable), and edit this section accordingly?
|}


=== Manual XML processing ===
=== Manual XML processing ===
Line 95: Line 99:
=== Scribe ===
=== Scribe ===


As already described above, Qt's Scribe framework supports automatically importing HTML content into a [[Doc:QTextDocument]].
As already described above, Qt's Scribe framework supports automatically importing HTML content into a [http://doc.qt.io/qt-5/qtextdocument.html QTextDocument].
Once in that form, you can…
Once in that form, you can…
* …render it onto any [http://doc.qt.io/qt-5/qpaintdevice.html QPaintDevice] using [http://doc.qt.io/qt-4.8/qtextdocument.html#drawContents QTextDocument::drawContents].
* …render it onto any [http://doc.qt.io/qt-5/qpaintdevice.html QPaintDevice] using [http://doc.qt.io/qt-4.8/qtextdocument.html#drawContents QTextDocument::drawContents].
* …show it to the user through a [http://doc.qt.io/qt-5/qtextedit.html QTextEdit] widget (either in read-only mode, or in editable mode which allows the user to actually edit the document interactively).
* …show it to the user through a [http://doc.qt.io/qt-5/qtextedit.html QTextEdit] widget (either in read-only mode, or in editable mode which allows the user to actually edit the document interactively).


Again, the restriction to the "limited subset of static HTML 4 / CSS 2.1":/doc/qt-4.8/richtext-html-subset.html supported by QTextDocument applies.
Again, the restriction to the [http://doc.qt.io/qt-4.8/richtext-html-subset.html limited subset of static HTML 4 / CSS 2.1] supported by QTextDocument applies.


=== QtWebKit ===
=== QtWebKit ===


[[Image:Webkit-examples.png|right] If you need more powerful viewing / user-interaction capabilities, take a look at the [http://doc.qt.io/qt-5/qtwebkit-index.html QtWebKit browser framework] which is included with Qt. It can interactively display pretty much any modern web document (which may make use of HTML 5, XHTML, CSS 3, SVG, JavaScript, plugins like Flash, etc.). The viewer component is available in the following forms:
[[Image:Webkit-examples.png|right]]If you need more powerful viewing / user-interaction capabilities, take a look at the [http://doc.qt.io/qt-5/qtwebkit-index.html QtWebKit browser framework] which is included with Qt. It can interactively display pretty much any modern web document (which may make use of HTML 5, XHTML, CSS 3, SVG, JavaScript, plugins like Flash, etc.). The viewer component is available in the following forms:
* As a QWidget ([http://doc.qt.io/qt-5/qwebview.html QWebView] )
* As a QWidget ([http://doc.qt.io/qt-5/qwebview.html QWebView] )
* As a QGraphicsItem ([http://doc.qt.io/qt-5/qgraphicswebview.html QGraphicsWebView])
* As a QGraphicsItem ([http://doc.qt.io/qt-5/qgraphicswebview.html QGraphicsWebView])

Revision as of 10:11, 30 March 2015


This page discusses various available options for working with HTML documents in your Qt application. Please also read the general considerations outlined on the Handling Document Formats page.

Note that this information is collaboratively collected by the community, with no promise

of completeness or correctness. In particular, use your own research and judgment when evaluating third-party libraries or tools!

Reading / Writing

Scribe

Qt's Scribe framework (see Handling Document Formats) has built-in support for loading from / saving to HTML (see QTextDocument::setHtml and toHtml as well as QTextDocumentWriter). Together with the format-independent API that QTextDocument provides for modifying documents (or creating them from scratch), this makes Scribe an adequate framework for processing or generating HTML documents.

However, it only supports a limited subset of static HTML 4 / CSS 2.1 - corresponding to the limited set of built-in document features which QTextDocument supports internally.

QtWebKit

The Webkit-based web browser framework shipped with Qt provides the QWebPage and QWebFrame classes, which can be used to load an HTML document (or any web page) without actually rendering it, and access or modify it through a DOM-like API. Saving back to HTML is possible using QWebFrame::toHtml.

Keep in mind though that loading an HTML document in this way will not just passively parse it (like the Scribe framework or the XML/HTML parsers discussed below would), but actively evaluate it like a browser would, i.e. loading linked content like iframes, running JavaScript that is set to run on start-up, etc. Whether this is useful or problematic will depend on your specific use-case.

TODO: Can someone confirm whether this is true (and unavoidable), and edit this section accordingly?

Manual XML processing

If your application needs to parse or write HTML/XHTML documents which are valid XML, consider processing them using Qt's XML handling classes (see Handling Document Formats).

Note that there are third-party tools/libraries available for automatically converting "normal" (and even broken) HTML documents into valid XHTML/XML which is suitable for processing:

type platforms license
HTML Tidy stand-alone tool Win, Mac, Linux, … MIT-like [permissive]
TidyLib C library Win, Mac, Linux, … MIT-like [permissive]
Chilkat C+ library Win, Mac, Linux, … proprietary

Manual HTML processing

For specialized HTML parsers with a similarly low-level API as Qt's XML handling classes, refer to third-party C/C++ libraries, e.g.:

API parsing writing parsing modes platforms license
libxml2 C yes ? stream, SAX, DOM (non-validating?) Win, Mac, Linux, … MIT [permissive]
htmlcxx C++ yes yes SAX, DOM, ? (non-validating) Win, Linux, ? LGPL [weak copyleft]
libhtml C yes yes stream (strongly-validating) Linux, ? ICS [permissive]

Rendering / Interactive Viewing

Scribe

As already described above, Qt's Scribe framework supports automatically importing HTML content into a QTextDocument. Once in that form, you can…

Again, the restriction to the limited subset of static HTML 4 / CSS 2.1 supported by QTextDocument applies.

QtWebKit

Webkit-examples.png

If you need more powerful viewing / user-interaction capabilities, take a look at the QtWebKit browser framework which is included with Qt. It can interactively display pretty much any modern web document (which may make use of HTML 5, XHTML, CSS 3, SVG, JavaScript, plugins like Flash, etc.). The viewer component is available in the following forms:

The framework also allows rendering an HTML page to any QPaintDevice using QWebFrame::render.


See Also