Поддерживаемый подмножество HTML

Текстовые виджеты Qt способны отображать форматированный текст, заданный с помощью подмножества разметки HTML 4. Виджеты, которые используют QTextDocument, такие как QLabel и QTextEdit, способны отображать форматированный текст, заданный таким образом.

Использование разметки HTML в текстовых виджетах

Виджеты автоматически распознают разметку HTML и отображают форматированный текст соответственно. Например, установка свойства текста метки со строкой "<b>Hello</b> <i>Qt!</i>" приведет к отображению текста метки следующим образом: Привет Qt!

При использовании разметки HTML для текста Qt следует правилам, определенным в спецификации HTML 4. Это включает в себя стандартные свойства для форматирования текста, такие как направление потока текста (слева направо), которое можно изменить, применив атрибут dir к блокам текста.

Поддерживаемые теги

В следующей таблице перечислены теги HTML, поддерживаемые движком форматированного текста Qt:

Тег	Описание	Комментарий
`a`	Якорная ссылка	Поддерживает атрибуты `href` и `name`.
`address`	Адрес
`b`	Жирный шрифт
`big`	Крупный шрифт
`blockquote`	Отступленный абзац
`body`	Тело документа	Поддерживает атрибут `bgcolor`, который может быть именем цвета Qt цвета или спецификацией цвета `#RRGGBB`.
`br`	Перевод строки
`center`	Абзац по центру
`cite`	Вставка цитаты	Аналогично `i`.
`code`	Код	Аналогично `tt`.
`dd`	Данные определения
`dfn`	Определение	Аналогично `i`.
`div`	Раздел документа	Поддерживает стандартные атрибуты блоков.
`dl`	Список определений	Поддерживает стандартные атрибуты блоков.
`dt`	Термин определения	Поддерживает стандартные атрибуты блоков.
`em`	Выделено	Аналогично `i`.
`font`	Размер шрифта, семейство и/или цвет	Поддерживает следующие атрибуты: `size`, `face`, и `color` (имена цветов Qt цвета или `#RRGGBB`).
`h1`	Заголовок уровня 1	Поддерживает стандартные атрибуты блоков.
`h2`	Заголовок уровня 2	Поддерживает стандартные атрибуты блоков.
`h3`	Заголовок уровня 3	Поддерживает стандартные атрибуты блоков.
`h4`	Заголовок уровня 4	Поддерживает стандартные атрибуты блоков.
`h5`	Заголовок уровня 5	Поддерживает стандартные атрибуты блоков.
`h6`	Заголовок уровня 6	Поддерживает стандартные атрибуты блоков.
`head`	Заголовок документа
`hr`	Горизонтальная линия	Поддерживает атрибут `width`, который может быть задан как абсолютное или относительное (`%`) значение.
`html`	Документ HTML
`i`	Курсив
`img`	Изображение	Поддерживает атрибуты `src`, `source` (для совместимости с Qt 3), `width`, и `height`.
`kbd`	Введённый текст
`meta`	Метаинформация	Если кодировка текста указана с помощью тега `meta`, она будет взята Qt::codecForHtml(). Аналогично, если кодировка указана для QTextDocument::toHtml(), кодировка хранится с помощью тега `meta`, например: `<meta http-equiv="Content-Type" content="text/html; charset=EUC-JP" />`
`li`	Элемент списка
`nobr`	Неразрывный текст
`ol`	Нумерованный список	Поддерживает стандартные атрибуты списков.
`p`	Абзац	По умолчанию выровнен по левому краю. Поддерживает стандартные атрибуты блоков.
`pre`	Форматированный текст
`qt`	Документ форматированного текста Qt	Синоним для `html`. Предоставлено для совместимости с более ранними версиями Qt.
`s`	Зачеркнуто
`samp`	Образец кода	Аналогично `tt`.
`small`	Мелкий шрифт
`span`	Сгруппированные элементы
`strong`	Сильный	Аналогично `b`.
`sub`	Подстрочный символ
`sup`	Надстрочный символ
`table`	Таблица	Поддерживает следующие атрибуты: `border`, `bgcolor` (имена цветов Qt цвета или `#RRGGBB`), `cellspacing`, `cellpadding`, `width` (абсолютное или относительное) и `height`.
`tbody`	Тело таблицы	Ничего не делает.
`td`	Ячейка таблицы	Поддерживает стандартные атрибуты ячеек таблицы.
`tfoot`	Подвал таблицы	Ничего не делает.
`th`	Ячейка заголовка таблицы	Поддерживает стандартные атрибуты ячеек таблицы.
`thead`	Заголовок таблицы	Если указан тег `thead`, он используется при печати таблиц, которые занимают несколько страниц.
`title`	Заголовок документа	Значение, заданное с помощью тега `title`, доступно через QTextDocument::metaInformation().
`tr`	Строка таблицы	Поддерживает атрибут `bgcolor`, который может быть именем цвета Qt цвета или спецификацией цвета `#RRGGBB`.
`tt`	Шрифт печатающей машинки
`u`	Подчёркнуто
`ul`	Маркированный список	Поддерживает стандартные атрибуты списков.
`var`	Переменная	Аналогично `i`.

Атрибуты блоков

Следующие атрибуты поддерживаются тегами div, dl, dt, h1, h2, h3, h4, h5, h6, p:

align (left, right, center, justify)
dir (ltr, rtl)

Атрибуты списков

Следующий атрибут поддерживается тегами ol и ul:

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

Атрибуты ячеек таблицы

Следующие атрибуты поддерживаются тегами td и th:

width (абсолютное, относительное или без значения)
bgcolor (имена цветов Qt цветов или #RRGGBB)
colspan
rowspan
align (left, right, center, justify)
valign (top, middle, bottom)

Свойства CSS

В следующей таблице перечислены свойства CSS, поддерживаемые движком форматирования богатого текста Qt:

Свойство	Значения	Описание
`background-color`	<цвет>	Цвет фона для элементов
`background-image`	<ссылка>	Изображение фона для элементов
`color`	<цвет>	Цвет текста
`font-family`	<имя_шрифта>	Имя семейства шрифтов
`font-size`	[ small \| medium \| large \| x-large \| xx-large ] \| <размер>pt \| <размер>px	Размер шрифта относительно размера шрифта документа или указанный в пунктах или пикселях
`font-style`	[ normal \| italic \| oblique ]
`font-weight`	[ normal \| bold \| 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 ]	Устанавливает начертание шрифта, где `normal` и `bold` сопоставлены соответствующим весам QFont. Численные значения равны 8-кратному значению эквивалентных весов QFont.
`text-decoration`	none \| [ underline \|\| overline \|\| line-through ]	Дополнительные эффекты текста
`font`	[ [ <'font-style'> \|\| <'font-weight'> ]? <'font-size'> <'font-family'> ]	Сокращенное свойство шрифта
`text-indent`	<длина>px	Отступ первой строки в пикселях
`white-space`	normal \| pre \| nowrap \| pre-wrap	Определяет, как обрабатываются пробелы в HTML.
`margin-top`	<длина>px	Верхний отступ абзаца в пикселях
`margin-bottom`	<длина>px	Нижний отступ абзаца в пикселях
`margin-left`	<длина>px	Левый отступ абзаца в пикселях
`margin-right`	<длина>px	Правый отступ абзаца в пикселях
`padding-top`	<длина>px	Отступ ячейки таблицы по вертикали в пикселях
`padding-bottom`	<длина>px	Нижний отступ ячейки таблицы в пикселях
`padding-left`	<длина>px	Левый отступ ячейки таблицы в пикселях
`padding-right`	<длина>px	Правый отступ ячейки таблицы в пикселях
`padding`	<длина>px	Сокращенное свойство для одновременной установки всех свойств отступа.
`vertical-align`	baseline \| sub \| super \| middle \| top \| bottom	Вертикальное выравнивание текста. Для вертикального выравнивания в текстовых ячейках таблицы применяются только middle, top и bottom.
`border-color`	<цвет>	Цвет границы для текстовых таблиц.
`border-style`	none \| dotted \| dashed \| dot-dash \| dot-dot-dash \| solid \| double \| groove \| ridge \| inset \| outset	Стиль границы для текстовых таблиц.
`background`	[ <'background-color'> \|\| <'background-image'> ]	Сокращенное свойство фона
`page-break-before`	[ auto \| always ]	Возможность принудительной вставки разрыва страницы перед абзацем/таблицей
`page-break-after`	[ auto \| always ]	Возможность принудительной вставки разрыва страницы после абзаца/таблицы
float	[ left \| right \| none ]	Указывает, где будет размещено изображение или текст в другом элементе. Обратите внимание, что свойство `float` поддерживается только для таблиц и изображений.
`text-transform`	[ uppercase \| lowercase ]	Выберите преобразование, которое будет выполнено над текстом перед отображением.
`font-kerning`	[ normal \| none ]	Включает или отключает кернинг между символами текста.
`font-variant`	small-caps	Выполните преобразование smallcaps над текстом перед его отображением.
`word-spacing`	<ширина>px	Устанавливает альтернарный интервал между словами.

Поддерживаемые селекторы CSS

Поддерживаются все классы селекторов CSS 2.1, за исключением псевдоклассов, таких как :first-child, :visited и :hover.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/richtext-html-subset.html