En esta página

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.

EtiquetaDescripciónComentario
aAncla o enlaceAdmite los atributos « href », « name » y « title ».
addressDirección
bNegrita
bigLetra más grande
blockquotePárrafo sangrado
bodyCuerpo del documentoAdmite el atributo « bgcolor », que puede ser una especificación de color de Qt color name o de #RRGGBB.
brSalto de línea
centerPárrafo centrado
citeCita en el textoIgual que i.
codeCódigoIgual que en tt.
ddDatos de definición
delEliminadoIgual que en s. Desde Qt 6.11
dfnDefiniciónIgual que en i.
divDivisión de documentosAdmite los atributos de bloque estándar.
dlLista de definicionesAdmite los atributos de bloque estándar.
dtTérmino de definiciónAdmite los atributos de bloque estándar.
emEnfatizadoIgual que « i ».
fontTamaño, tipo y/o color de la fuenteAdmite los siguientes atributos: size, face y color (Qt color names o #RRGGBB).
h1Encabezado de nivel 1Admite los atributos de bloque estándar.
h2Título de nivel 2Admite los atributos de bloque estándar.
h3Título de nivel 3Admite los atributos estándar de los bloques.
h4Título de nivel 4Admite los atributos estándar de los bloques.
h5Encabezado de nivel 5Admite los atributos estándar de los bloques.
h6Encabezado de nivel 6Admite los atributos estándar de los bloques.
headEncabezado del documento
hrLínea horizontalAdmite el atributo « width », que puede especificarse como un valor absoluto o relativo (%).
htmlDocumento HTML
iCursiva
imgImagenAdmite los atributos « src », « width », « height », « style », « alt » y « title ».
kbdTexto introducido por el usuario
metaMetainformaciónSi 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" />
liElemento de lista
nobrTexto no separable
olLista ordenadaAdmite los atributos estándar de las listas.
pPárrafoAlineado a la izquierda por defecto. Admite los atributos estándar de bloque.
preTexto preformateado
qtDocumento de texto enriquecido de QtSinónimo de « html ». Se proporciona para garantizar la compatibilidad con versiones anteriores de Qt.
sTachado
sampCódigo de ejemploLo mismo que « tt ».
smallLetra pequeña
spanElementos agrupados
strongNegritaIgual que en b.
subSubíndice
supSuperíndice
tableTablaAdmite los siguientes atributos: border, bgcolor (Qt color names o #RRGGBB), cellspacing, cellpadding, width (absoluto o relativo) y height.
tbodyCuerpo de la tablaNo realiza ninguna acción.
tdCeldas de datos de la tablaAdmite los atributos estándar de las celdas de tabla.
tfootPie de tablaNo hace nada.
thCeldilla de encabezado de tablaAdmite los atributos estándar de las celdas de tabla.
theadEncabezado de tablaSi se especifica la etiqueta « thead », se utiliza al imprimir tablas que abarcan varias páginas.
titleTítulo del documentoEl valor especificado mediante la etiqueta ` title ` está disponible a través de ` QTextDocument::metaInformation()`.
trFila de la tablaAdmite el atributo ` bgcolor `, que puede ser un objeto `Qt` ` color name ` o una especificación de color ` #RRGGBB `.
ttFuente de máquina de escribir
uSubrayado
ulLista sin ordenarAdmite los atributos estándar de lista.
varVariableIgual 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)
  • colspan
  • rowspan
  • align (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:

PropiedadValoresDescripció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> pxTamañ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-decorationnone | [ underline || overline || line-through ]Efectos de texto adicionales
font[ [ <'font-style'> || <'font-weight'> ]? <'font-size'> <'font-family'> ]Propiedad abreviada de fuente
text-indent<longitud>pxSangría de la primera línea de texto en píxeles
white-spacenormal | pre | nowrap | pre-wrapEstablece cómo se gestionan los espacios en blanco en HTML.
margin-top<longitud>pxMargen superior del párrafo en píxeles
margin-bottom<longitud>pxMargen inferior del párrafo en píxeles
margin-left<length>pxMargen izquierdo del párrafo en píxeles
margin-right<longitud>pxMargen derecho del párrafo en píxeles
padding-top<longitud>pxRelleno superior de la celda de la tabla en píxeles
padding-bottom<longitud>pxRelleno inferior de la celda de la tabla en píxeles
padding-left<longitud>pxRelleno izquierdo de la celda de la tabla en píxeles
padding-right<longitud>pxRelleno derecho de la celda de la tabla en píxeles
padding<longitud>pxNotación abreviada para establecer todas las propiedades de relleno a la vez.
vertical-alignlínea de base | sub | super | medio | superior | inferiorAlineació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-collapsecolapsar | separarModo 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-styleninguno | punteado | discontinuo | punto-rayita | punto-punto-rayita | continuo | doble | ranura | cresta | hacia dentro | hacia fueraEstilo 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>pxAncho del borde de la tabla o de la celda
border-top-width<longitud>pxAncho del borde superior de las celdas de la tabla.
border-bottom-width<longitud>pxAncho del borde inferior de las celdas de la tabla.
border-left-width<longitud>pxAncho del borde izquierdo de las celdas de la tabla.
border-right-width<longitud>pxAncho 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-variantversalitasAplica la transformación de versalitas al texto antes de mostrarlo.
word-spacing<anchura>pxEspecifica 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:
  • altura de línea fija en píxeles, puntos o centímetros.
  • un porcentaje del tamaño de fuente actual.

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:

PropiedadValoresDescripció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-typeemptyOculta el bloque de texto.
-qt-table-typeroot | frameroot 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.