qt4.8.5 html,Supported HTML Subset

Qt's text widgets are able to display rich text, specified using a subset of HTML 4 markup. Widgets that use QTextDocument, such as QLabel and QTextEdit, are able to display rich text specified in this way.

Using HTML Markup in Text Widgets

Widgets automatically detect HTML markup and display rich text accordingly. For example, setting a label's text property with the string "Hello Qt!" will result in the label displaying text like this: Hello Qt!

When HTML markup is used for text, Qt follows the rules defined by the HTML 4 specification. This includes default properties for text layout, such as the direction of the text flow (left-to-right) which can be changed by applying the dir attribute to blocks of text.

Supported Tags

The following table lists the HTML tags supported by Qt's rich text engine:

TagDescriptionComment

aAnchor or linkSupports the href and name attributes. Note that the :visited selector is one of those that is not supported by the rich text engine. See below for a list of others.

addressAddress

bBold

bigLarger font

blockquoteIndented paragraph

bodyDocument bodySupports the bgcolor attribute, which can be a Qt color name or a #RRGGBB color specification.

brLine break

centerCentered paragraph

citeInline citationSame as i.

codeCodeSame as tt.

ddDefinition data

dfnDefinitionSame as i.

divDocument divisionSupports the standard block attributes.

dlDefinition listSupports the standard block attributes.

dtDefinition termSupports the standard block attributes.

emEmphasizedSame as i.

fontFont size, family, and/or colorSupports the following attributes: size, face, and color (Qt color names or #RRGGBB).

h1Level 1 headingSupports the standard block attributes.

h2Level 2 headingSupports the standard block attributes.

h3Level 3 headingSupports the standard block attributes.

h4Level 4 headingSupports the standard block attributes.

h5Level 5 headingSupports the standard block attributes.

h6Level 6 headingSupports the standard block attributes.

headDocument header

hrHorizontal lineSupports the width attribute, which can be specified as an absolute or relative (%) value.

htmlHTML document

iItalic

imgImageSupports the src, source (for Qt 3 compatibility), width, and height attributes.

kbdUser-entered text

metaMeta-informationIf a text encoding is specified using the meta tag, it is picked up by Qt::codecForHtml(). Likewise, if an encoding is specified to QTextDocument::toHtml(), the encoding is stored using a meta tag, for example:

liList item

nobrNon-breakable text

olOrdered listSupports the standard list attributes.

pParagraphLeft-aligned by default. Supports the standard block attributes.

prePreformated text

qtQt rich-text documentSynonym for html. Provided for compatibility with earlier versions of Qt.

sStrikethrough

sampSample codeSame as tt.

smallSmall font

spanGrouped elements

strongStrongSame as b.

styleStyle sheetAllows styling information to be included with the rich text. A limited subset of CSS syntax can be used to change the appearance of the text.

subSubscript

supSuperscript

tableTableSupports the following attributes: border, bgcolor (Qt color names or #RRGGBB), cellspacing, cellpadding, width (absolute or relative), and height.

tbodyTable bodyDoes nothing.

tdTable data cellSupports the standard table cell attributes.

tfootTable footerDoes nothing.

thTable header cellSupports the standard table cell attributes.

theadTable headerIf the thead tag is specified, it is used when printing tables that span multiple pages.

titleDocument titleThe value specified using the title tag is available through QTextDocument::metaInformation().

trTable rowSupports the bgcolor attribute, which can be a Qt color name or a #RRGGBB color specification.

ttTypewrite font

uUnderlined

ulUnordered listSupports the standard list attributes.

varVariableSame as i.

Block Attributes

The following attributes are supported by the div, dl, dt, h1, h2, h3, h4, h5, h6, p tags:

align (left, right, center, justify)

dir (ltr, rtl)

List Attributes

The following attribute is supported by the ol and ul tags:

type (1, a, A, square, disc, circle)

Table Cell Attributes

The following attributes are supported by the td and th tags:

width (absolute, relative, or no-value)

bgcolor (Qt color names or #RRGGBB)

colspan

rowspan

align (left, right, center, justify)

valign (top, middle, bottom)

CSS Properties

The following table lists the CSS properties supported by Qt's rich text engine:

PropertyValuesDescription

background-colorBackground color for elements

background-imageBackground image for elements

colorText foreground color

font-familyFont family name

font-size[ small | medium | large | x-large | xx-large ] | pt | pxFont size relative to the document font, or specified in points or pixels

font-style[ normal | italic | oblique ]

font-weight[ normal | bold | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 ]Specifies the font weight used for text, where normal and bold are mapped to the corresponding QFont weights. Numeric values are 8 times the equivalent QFont weight values.

text-decorationnone | [ underline || overline || line-through ]Additional text effects

font[ [ || ]? ]Font shorthand property

text-indentpxFirst line text indentation in pixels

white-spacenormal | pre | nowrap | pre-wrapDeclares how whitespace in HTML is handled.

margin-toppxTop paragraph margin in pixels

margin-bottompxBottom paragraph margin in pixels

margin-leftpxLeft paragraph margin in pixels

margin-rightpxRight paragraph margin in pixels

padding-toppxTop table cell padding in pixels

padding-bottompxBottom table cell padding in pixels

padding-leftpxLeft table cell padding in pixels

padding-rightpxRight table cell padding in pixels

paddingpxShorthand for setting all the padding properties at once.

vertical-alignbaseline | sub | super | middle | top | bottomVertical text alignment. For vertical alignment in text table cells only middle, top, and bottom apply.

border-colorBorder color for text tables.

border-stylenone | dotted | dashed | dot-dash | dot-dot-dash | solid | double | groove | ridge | inset | outsetBorder style for text tables.

background[ || ]Background shorthand property

page-break-before[ auto | always ]Make it possible to enforce a page break before the paragraph/table

page-break-after[ auto | always ]Make it possible to enforce a page break after the paragraph/table

float[ left | right | none ]Specifies where an image or a text will be placed in another element. Note that the float property is only supported for tables and images.

text-transform[ uppercase | lowercase ]Select the transformation that will be performed on the text prior to displaying it.

font-variantsmall-capsPerform the smallcaps transformation on the text prior to displaying it.

word-spacingpxSpecifies an alternate spacing between each word.

Supported CSS Selectors

All CSS 2.1 selector classes are supported except pseudo-class selectors such as :first-child, :visited and :hover.