Subconjunto de HTML compatible
Los widgets de texto de Qt pueden mostrar texto enriquecido, especificado mediante un subconjunto del marcado HTML 4. Los widgets que utilizan QTextDocument, como QLabel y QTextEdit, pueden mostrar texto enriquecido especificado de esta manera.
Uso del marcado HTML en widgets de texto
Los widgets detectan automáticamente el marcado HTML y muestran el texto enriquecido en consecuencia. Por ejemplo, al establecer la propiedad ` text ` de una etiqueta con la cadena ` "<b>Hello</b> <i>Qt!</i>" `, la etiqueta mostrará un texto como este: ¡Hola, Qt!
Cuando se utiliza marcado HTML para el texto, Qt sigue las reglas definidas por la especificación HTML 4. Esto incluye propiedades predeterminadas para el diseño del texto, como la dirección del flujo de texto (de izquierda a derecha), que se puede modificar aplicando el dir a los bloques de texto.
Etiquetas compatibles
La siguiente tabla enumera las etiquetas HTML compatibles con el motor de texto enriquecido de Qt.
Nota: La funcionalidad implementada para las etiquetas que se enumeran a continuación es un subconjunto de la especificación completa de HTML 4. No se admiten todos los atributos; consulta los comentarios de cada etiqueta.
| Etiqueta | Descripción | Comentario |
|---|---|---|
a | Ancla o enlace | Admite los atributos « href », « name » y « title ». |
address | Dirección | |
b | Negrita | |
big | Letra más grande | |
blockquote | Párrafo sangrado | |
body | Cuerpo del documento | Admite el atributo « bgcolor », que puede ser una especificación de color de Qt color name o de #RRGGBB. |
br | Salto de línea | |
center | Párrafo centrado | |
cite | Cita en el texto | Igual que i. |
code | Código | Igual que en tt. |
dd | Datos de definición | |
del | Eliminado | Igual que en s. Desde Qt 6.11 |
dfn | Definición | Igual que en i. |
div | División de documentos | Admite los atributos de bloque estándar. |
dl | Lista de definiciones | Admite los atributos de bloque estándar. |
dt | Término de definición | Admite los atributos de bloque estándar. |
em | Enfatizado | Igual que « i ». |
font | Tamaño, tipo y/o color de la fuente | Admite los siguientes atributos: size, face y color (Qt color names o #RRGGBB). |
h1 | Encabezado de nivel 1 | Admite los atributos de bloque estándar. |
h2 | Título de nivel 2 | Admite los atributos de bloque estándar. |
h3 | Título de nivel 3 | Admite los atributos estándar de los bloques. |
h4 | Título de nivel 4 | Admite los atributos estándar de los bloques. |
h5 | Encabezado de nivel 5 | Admite los atributos estándar de los bloques. |
h6 | Encabezado de nivel 6 | Admite los atributos estándar de los bloques. |
head | Encabezado del documento | |
hr | Línea horizontal | Admite el atributo « width », que puede especificarse como un valor absoluto o relativo (%). |
html | Documento HTML | |
i | Cursiva | |
img | Imagen | Admite los atributos « src », « width », « height », « style », « alt » y « title ». |
kbd | Texto introducido por el usuario | |
meta | Metainformación | Si se especifica una codificación de texto mediante la etiqueta ` meta `, Qt::codecForHtml() la recoge. Del mismo modo, si se especifica una codificación en ` QTextDocument::toHtml()`, dicha codificación se almacena utilizando una etiqueta ` meta `, por ejemplo: <meta http-equiv="Content-Type" content="text/html; charset=EUC-JP" /> |
li | Elemento de lista | |
nobr | Texto no separable | |
ol | Lista ordenada | Admite los atributos estándar de las listas. |
p | Párrafo | Alineado a la izquierda por defecto. Admite los atributos estándar de bloque. |
pre | Texto preformateado | |
qt | Documento de texto enriquecido de Qt | Sinónimo de « html ». Se proporciona para garantizar la compatibilidad con versiones anteriores de Qt. |
s | Tachado | |
samp | Código de ejemplo | Lo mismo que « tt ». |
small | Letra pequeña | |
span | Elementos agrupados | |
strong | Negrita | Igual que en b. |
sub | Subíndice | |
sup | Superíndice | |
table | Tabla | Admite los siguientes atributos: border, bgcolor (Qt color names o #RRGGBB), cellspacing, cellpadding, width (absoluto o relativo) y height. |
tbody | Cuerpo de la tabla | No realiza ninguna acción. |
td | Celdas de datos de la tabla | Admite los atributos estándar de las celdas de tabla. |
tfoot | Pie de tabla | No hace nada. |
th | Celdilla de encabezado de tabla | Admite los atributos estándar de las celdas de tabla. |
thead | Encabezado de tabla | Si se especifica la etiqueta « thead », se utiliza al imprimir tablas que abarcan varias páginas. |
title | Título del documento | El valor especificado mediante la etiqueta ` title ` está disponible a través de ` QTextDocument::metaInformation()`. |
tr | Fila de la tabla | Admite el atributo ` bgcolor `, que puede ser un objeto `Qt` ` color name ` o una especificación de color ` #RRGGBB `. |
tt | Fuente de máquina de escribir | |
u | Subrayado | |
ul | Lista sin ordenar | Admite los atributos estándar de lista. |
var | Variable | Igual que « i ». |
Atributos de bloque
Las etiquetas div, dl, dt, h1, h2, h3, h4, h5, h6 y p admiten los siguientes atributos:
align(left,right,center,justify)dir(ltr,rtl)
Atributos de la lista
Las etiquetas ol y ul admiten el siguiente atributo:
type(1,a,A,square,disc,circle)
Además, la etiqueta ` ol ` admite el siguiente atributo:
start
Atributos de celda de tabla
Las etiquetas ` td ` y ` th ` admiten los siguientes atributos:
width(absoluto, relativo o sin valor)bgcolor(Qt XML color names o#RRGGBB)colspanrowspanalign(left,right,center,justify)valign(top,middle,bottom)
Propiedades CSS
La siguiente tabla enumera las propiedades CSS compatibles con el motor de texto enriquecido de Qt:
| Propiedad | Valores | Descripción |
|---|---|---|
background-color | <color> | Color de fondo de los elementos |
background-image | <uri> | Imagen de fondo para los elementos |
color | <color> | Color de primer plano del texto |
font-family | <nombre de la familia> | Nombre de la familia tipográfica |
font-size | [ pequeño | mediano | grande | extragrande | doble extragrande ] | <tamaño> pt | <tamaño> px | Tamaño de la fuente en relación con la fuente del documento, o especificado en puntos o píxeles |
font-style | [ normal | cursiva | oblicua ] | |
font-weight | [ normal | negrita | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 ] | Especifica el peso de la fuente utilizado para el texto, donde normal y bold se asignan a los pesos correspondientes de QFont. Los valores numéricos son 8 veces los valores de peso equivalentes de QFont. |
text-decoration | none | [ underline || overline || line-through ] | Efectos de texto adicionales |
font | [ [ <'font-style'> || <'font-weight'> ]? <'font-size'> <'font-family'> ] | Propiedad abreviada de fuente |
text-indent | <longitud>px | Sangría de la primera línea de texto en píxeles |
white-space | normal | pre | nowrap | pre-wrap | Establece cómo se gestionan los espacios en blanco en HTML. |
margin-top | <longitud>px | Margen superior del párrafo en píxeles |
margin-bottom | <longitud>px | Margen inferior del párrafo en píxeles |
margin-left | <length>px | Margen izquierdo del párrafo en píxeles |
margin-right | <longitud>px | Margen derecho del párrafo en píxeles |
padding-top | <longitud>px | Relleno superior de la celda de la tabla en píxeles |
padding-bottom | <longitud>px | Relleno inferior de la celda de la tabla en píxeles |
padding-left | <longitud>px | Relleno izquierdo de la celda de la tabla en píxeles |
padding-right | <longitud>px | Relleno derecho de la celda de la tabla en píxeles |
padding | <longitud>px | Notación abreviada para establecer todas las propiedades de relleno a la vez. |
vertical-align | línea de base | sub | super | medio | superior | inferior | Alineación vertical del texto. Para la alineación vertical en las celdas de texto de una tabla, solo se aplican las opciones «middle», «top» y «bottom». |
border-collapse | colapsar | separar | Modo de colapso de bordes para tablas de texto. Si se establece en «colapse», no se aplicará el espaciado entre celdas. |
border-color | <color> | Color de los bordes para tablas de texto y celdas de tabla. |
border-top-color | <color> | Color del borde superior de las celdas de la tabla. |
border-bottom-color | <color> | Color del borde inferior de las celdas de las tablas. |
border-left-color | <color> | Color del borde izquierdo de las celdas de la tabla. |
border-right-color | <color> | Color del borde derecho de las celdas de la tabla. |
border-style | ninguno | punteado | discontinuo | punto-rayita | punto-punto-rayita | continuo | doble | ranura | cresta | hacia dentro | hacia fuera | Estilo de borde para tablas de texto y celdas de tabla. |
border-top-style | <border-style> | Estilo del borde superior de las celdas de la tabla. |
border-bottom-style | <border-style> | Estilo del borde inferior de las celdas de las tablas. |
border-left-style | <border-style> | Estilo del borde izquierdo de las celdas de la tabla. |
border-right-style | <border-style> | Estilo del borde derecho de las celdas de la tabla. |
border-width | <width>px | Ancho del borde de la tabla o de la celda |
border-top-width | <longitud>px | Ancho del borde superior de las celdas de la tabla. |
border-bottom-width | <longitud>px | Ancho del borde inferior de las celdas de la tabla. |
border-left-width | <longitud>px | Ancho del borde izquierdo de las celdas de la tabla. |
border-right-width | <longitud>px | Ancho del borde derecho de las celdas de la tabla. |
border-top | <ancho>px <estilo-borde> <color-borde> | Notación abreviada para establecer el ancho, el estilo y el color del borde superior |
border-bottom | <anchura>px <estilo-borde> <color-borde> | Notación abreviada para establecer el ancho, el estilo y el color del borde inferior |
border-left | <ancho>px <estilo-borde> <color-borde> | Notación abreviada para establecer el ancho, el estilo y el color del borde izquierdo |
border-right | <ancho>px <estilo-borde> <color-borde> | Notación abreviada para establecer el ancho, el estilo y el color del borde derecho |
border-top | <ancho>px <estilo-borde> <color-borde> | Notación abreviada para establecer el ancho, el estilo y el color del borde superior |
border-bottom | <ancho>px <estilo-borde> <color-borde> | Notación abreviada para establecer el ancho, el estilo y el color del borde inferior |
border | <ancho>px <estilo-borde> <color-borde> | Notación abreviada para establecer el ancho, el estilo y el color de los cuatro bordes |
background | [ <'background-color'> || <'background-image'> ] | Propiedad abreviada de fondo |
page-break-before | [ auto | always ] | Permite forzar un salto de página antes del párrafo o la tabla |
page-break-after | [ auto | always ] | Permite forzar un salto de página después del párrafo o la tabla |
float | [ left | right | none ] | Especifica dónde se colocará una imagen o un texto dentro de otro elemento. Ten en cuenta que la propiedad « float » solo es compatible con tablas e imágenes. |
text-transform | [ mayúsculas | minúsculas ] | Selecciona la transformación que se aplicará al texto antes de mostrarlo. |
font-kerning | [ normal | none ] | Activa o desactiva el kerning entre los caracteres del texto. |
font-variant | versalitas | Aplica la transformación de versalitas al texto antes de mostrarlo. |
word-spacing | <anchura>px | Especifica un espaciado alternativo entre cada palabra. |
line-height | <número>[% | px | pt | cm] | Especifica la altura de una línea. Puede ser uno de los siguientes valores:
|
Nota: Ciertas propiedades CSS solo son compatibles cuando se aplican a una etiqueta de bloque, como <p>. Establecer estas propiedades en un <span>, por ejemplo, no tendrá ningún efecto. El margen es un ejemplo de este tipo de propiedad. Consulta QTextBlockFormat y QTextCharFormat para obtener una visión general de las opciones de formato disponibles para bloques y spans en QTextDocument.
Propiedades CSS específicas de Qt
Además de las propiedades CSS estándar enumeradas anteriormente, también se pueden utilizar las siguientes propiedades específicas de Qt para aplicar estilos a un bloque de texto:
| Propiedad | Valores | Descripción |
|---|---|---|
-qt-block-indent | <number> | Sangra el bloque de texto el número de espacios especificado. |
-qt-list-indent | <number> | Ajusta la sangría de los elementos de la lista según el número de espacios especificado. |
-qt-list-number-prefix | <string> | Añade la cadena indicada como prefijo al número de la lista en una lista ordenada HTML. |
-qt-list-number-suffix | <cadena> | Añade la cadena indicada como sufijo al número de la lista en una lista ordenada HTML. |
-qt-paragraph-type | empty | Oculta el bloque de texto. |
-qt-table-type | root | frame | root Muestra los bloques de texto en línea, sin bordes ni sangría, mientras que frame los muestra en una nueva línea con un marco alrededor. |
-qt-user-state | <number> | Lo añade como datos de usuario para el bloque de texto. |
Selectores CSS compatibles
Se admiten todas las clases de selectores CSS 2.1, excepto los selectores de pseudoclases como :first-child, :visited y :hover.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.