WebEngineSettings QML Type
Permite configurar las propiedades y atributos del navegador. Más...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.1 |
Propiedades
- accelerated2dCanvasEnabled : bool
(since QtWebEngine 1.3) - allowGeolocationOnInsecureOrigins : bool
(since QtWebEngine 1.5) - allowRunningInsecureContent : bool
(since QtWebEngine 1.4) - allowWindowActivationFromJavaScript : bool
(since QtWebEngine 1.6) - autoLoadIconsForPage : bool
(since QtWebEngine 1.3) - autoLoadImages : bool
- backForwardCacheEnabled : bool
(since QtWebEngine 6.10) - defaultTextEncoding : string
(since QtWebEngine 1.2) - dnsPrefetchEnabled : bool
(since QtWebEngine 1.8) - errorPageEnabled : bool
- focusOnNavigationEnabled : bool
(since QtWebEngine 1.4) - forceDarkMode : bool
(since QtWebEngine 6.7) - fullscreenSupportEnabled : bool
(since QtWebEngine 1.2) - hyperlinkAuditingEnabled : bool
- imageAnimationPolicy : enumeration
(since QtWebEngine 6.8) - javascriptCanAccessClipboard : bool
- javascriptCanOpenWindows : bool
- javascriptCanPaste : bool
(since QtWebEngine 1.7) - javascriptEnabled : bool
- linksIncludedInFocusChain : bool
- localContentCanAccessFileUrls : bool
- localContentCanAccessRemoteUrls : bool
- localStorageEnabled : bool
- navigateOnDropEnabled : bool
(since QtWebEngine 6.4) - pdfViewerEnabled : bool
(since QtWebEngine 1.9) - playbackRequiresUserGesture : bool
(since QtWebEngine 1.7) - pluginsEnabled : bool
- preferCSSMarginsForPrinting : bool
(since QtWebEngine 6.9) - printElementBackgrounds : bool
(since QtWebEngine 1.4) - printHeaderAndFooter : bool
(since QtWebEngine 6.9) - readingFromCanvasEnabled : bool
(since QtWebEngine 6.6) - screenCaptureEnabled : bool
(since QtWebEngine 1.3) - scrollAnimatorEnabled : bool
(since QtWebEngine 6.8) - showScrollBars : bool
(since QtWebEngine 1.6) - spatialNavigationEnabled : bool
- touchEventsApiEnabled : bool
(since QtWebEngine 6.9) - touchIconsEnabled : bool
(since QtWebEngine 1.3) - trimAccessibilityIdentifiers : bool
(since QtWebEngine 6.11) - unknownUrlSchemePolicy : enumeration
(since QtWebEngine 1.7) - webGLEnabled : bool
(since QtWebEngine 1.3) - webRTCPublicInterfacesOnly : bool
(since QtWebEngine 1.7)
Descripción detallada
El tipo WebEngineSettings se puede utilizar para configurar propiedades del navegador y atributos genéricos, como el soporte de JavaScript, el comportamiento de enfoque y el acceso a contenido remoto. Este tipo no se puede crear, pero se puede acceder a la configuración predeterminada de todas las vistas del motor web mediante la propiedad WebEngine.settings.
Cada vista del motor web puede tener ajustes individuales a los que se puede acceder utilizando la propiedad WebEngineView.settings.
Documentación de la propiedad
accelerated2dCanvasEnabled : bool [since QtWebEngine 1.3]
Especifica si el lienzo 2D de HTML 5 debe ser un framebuffer OpenGL. Esto hace que muchas operaciones de pintura sean más rápidas, pero ralentiza el acceso a los píxeles.
Habilitado por defecto si está disponible.
Esta propiedad se introdujo en QtWebEngine 1.3.
allowGeolocationOnInsecureOrigins : bool [since QtWebEngine 1.5]
Sólo los orígenes seguros, como HTTPS, pueden solicitar funciones de Geolocalización. Esta opción permite que los orígenes no seguros vuelvan a acceder a la geolocalización.
Deshabilitado por defecto.
Esta propiedad se introdujo en QtWebEngine 1.5.
allowRunningInsecureContent : bool [since QtWebEngine 1.4]
Por defecto, las páginas HTTPS no pueden ejecutar JavaScript, CSS, plugins o web-sockets desde URLs HTTP. Esto solía ser posible y esto proporciona una anulación para obtener el comportamiento antiguo.
Deshabilitado por defecto.
Esta propiedad fue introducida en QtWebEngine 1.4.
allowWindowActivationFromJavaScript : bool [since QtWebEngine 1.6]
Permite el método window.focus() en JavaScript. Deshabilitado por defecto.
Esta propiedad se introdujo en QtWebEngine 1.6.
autoLoadIconsForPage : bool [since QtWebEngine 1.3]
Descarga automáticamente los iconos de las páginas web.
Activado por defecto.
Esta propiedad se introdujo en QtWebEngine 1.3.
autoLoadImages : bool
Carga automáticamente las imágenes en las páginas web.
Activado por defecto.
backForwardCacheEnabled : bool [since QtWebEngine 6.10]
Activa el soporte de la caché atrás/adelante (o bfcache) para acelerar la navegación atrás y adelante.
Deshabilitado por defecto.
Esta propiedad se introdujo en QtWebEngine 6.10.
defaultTextEncoding : string [since QtWebEngine 1.2]
Establece la codificación por defecto. El valor debe ser una cadena que describa una codificación como "utf-8" o "iso-8859-1".
Si se deja vacío, se usará un valor por defecto.
Esta propiedad se introdujo en QtWebEngine 1.2.
dnsPrefetchEnabled : bool [since QtWebEngine 1.8]
Activa la precarga especulativa de registros DNS para enlaces HTML antes de que se activen.
Deshabilitado por defecto.
Esta propiedad se introdujo en QtWebEngine 1.8.
errorPageEnabled : bool
Permite mostrar las páginas de error integradas de Chromium.
Activado por defecto.
focusOnNavigationEnabled : bool [since QtWebEngine 1.4]
El foco se da a la vista cada vez que se produce una operación de navegación (cargar, detener, recargar, recargar y omitir caché, avanzar, retroceder, establecer contenido, etc.).
Desactivada por defecto.
Esta propiedad se introdujo en QtWebEngine 1.4.
forceDarkMode : bool [since QtWebEngine 6.7]
Renderiza automáticamente todos los contenidos web utilizando un tema oscuro.
Desactivado por defecto.
Esta propiedad se introdujo en QtWebEngine 6.7.
fullscreenSupportEnabled : bool [since QtWebEngine 1.2]
Indica al motor web si esta aplicación admite pantalla completa o no.
Deshabilitada por defecto.
Esta propiedad se introdujo en QtWebEngine 1.2.
hyperlinkAuditingEnabled : bool
Activa la compatibilidad con el atributo ping para hipervínculos.
Desactivado por defecto.
imageAnimationPolicy : enumeration [since QtWebEngine 6.8]
Especifica cómo debe tratarse una animación de imagen cuando los fotogramas de la imagen se renderizan para la animación.
| Constante | Descripción |
|---|---|
WebEngineSettings.ImageAnimationPolicy.Allow | Permite todas las animaciones de imagen cuando se renderizan los cuadros de imagen. |
WebEngineSettings.ImageAnimationPolicy.AnimateOnce | Anima la imagen una vez cuando se renderizan los cuadros de imagen. |
WebEngineSettings.ImageAnimationPolicy.Disallow | Deshabilita todas las animaciones de imagen cuando se renderizan los cuadros de imagen. |
El valor por defecto es WebEngineSettings.ImageAnimationPolicy.Allow.
Esta propiedad se introdujo en QtWebEngine 6.8.
javascriptCanAccessClipboard : bool
Permite a los programas JavaScript escribir (copiar) contenido desinfectado en el portapapeles. Una escritura desinfectada se realiza con las llamadas a la API del portapapeles de JavaScript write y writeText y debe ir acompañada de una acción del usuario.
Las escrituras no desinfectadas y la lectura del portapapeles se activan mediante javascriptCanPaste.
Antes de la versión 81 de Chromium, esta configuración habilitaba todas las escrituras en el portapapeles.
Dado que el acceso ilimitado al portapapeles es un posible problema de seguridad, se recomienda que las aplicaciones lo dejen desactivado y respondan a las solicitudes de permiso de la función ClipboardReadWrite.
Deshabilitado por defecto.
javascriptCanOpenWindows : bool
Permite a los programas JavaScript abrir ventanas emergentes sin interacción del usuario.
Activado por defecto.
javascriptCanPaste : bool [since QtWebEngine 1.7]
Permite a los programas JavaScript leer (pegar) desde el portapapeles y escribir contenido no desinfectado. Una escritura desinfectada se realiza con las llamadas a la API del portapapeles de JavaScript write y writeText y debe ir acompañada de una acción del usuario; las escrituras no desinfectadas son aquellas que no cumplen estos criterios.
Para que esta configuración tenga algún efecto, javascriptCanAccessClipboard también debe estar activada.
Dado que el acceso no restringido al portapapeles es un posible problema de seguridad, se recomienda que las aplicaciones dejen esta opción desactivada y, en su lugar, respondan a las solicitudes de permiso de la función ClipboardReadWrite.
Desactivada por defecto.
Esta propiedad se introdujo en QtWebEngine 1.7.
javascriptEnabled : bool
Permite la ejecución de programas JavaScript.
Activado por defecto.
linksIncludedInFocusChain : bool
Incluye hipervínculos en la cadena de enfoque del teclado.
Activado por defecto.
localContentCanAccessFileUrls : bool
Permite que los documentos cargados localmente accedan a otras URL locales.
Activado por defecto.
localContentCanAccessRemoteUrls : bool
Permite que los documentos cargados localmente accedan a URL remotas.
Desactivado por defecto.
localStorageEnabled : bool
Activa la compatibilidad con la función de almacenamiento local de HTML 5.
Activado por defecto.
navigateOnDropEnabled : bool [since QtWebEngine 6.4]
Especifica que las navegaciones pueden activarse soltando URLs en la vista.
Activada por defecto.
Esta propiedad se introdujo en QtWebEngine 6.4.
pdfViewerEnabled : bool [since QtWebEngine 1.9]
Especifica que los documentos PDF se abrirán en el visor de PDF interno en lugar de descargarse.
Activada por defecto.
Esta propiedad se introdujo en QtWebEngine 1.9.
playbackRequiresUserGesture : bool [since QtWebEngine 1.7]
Inhibe la reproducción de contenido multimedia hasta que el usuario interactúa con la página.
Por defecto, Qt WebEngine utiliza la configuración de Chromium, como se describe en Cambios en la política de reproducción automática. Para sobrescribir el comportamiento predeterminado, esta propiedad debe establecerse en false.
Nota: El comportamiento es similar al de Chrome en Android cuando está habilitado, y similar al de Chrome en ordenadores de sobremesa cuando está deshabilitado.
Esta propiedad se introdujo en QtWebEngine 1.7.
pluginsEnabled : bool
Activa la compatibilidad con plugins de Pepper, como el reproductor Flash.
Desactivado por defecto.
preferCSSMarginsForPrinting : bool [since QtWebEngine 6.9]
Activa la preferencia de márgenes CSS sobre los tamaños predeterminados (0, 0, 0, 0) al imprimir una página web.
Deshabilitado por defecto.
Esta propiedad se introdujo en QtWebEngine 6.9.
printElementBackgrounds : bool [since QtWebEngine 1.4]
Activa la impresión de fondos CSS al imprimir una página web.
Activada por defecto.
Esta propiedad se introdujo en QtWebEngine 1.4.
printHeaderAndFooter : bool [since QtWebEngine 6.9]
Especifica que los resultados de impresión contendrán la información básica de la página (URL, título, fecha, número de página) en el área de cabecera y pie de página. Es responsabilidad del incrustador proporcionar espacio suficiente para estos textos estableciendo los márgenes superior e inferior adecuados.
Desactivada por defecto.
Esta propiedad se introdujo en QtWebEngine 6.9.
readingFromCanvasEnabled : bool [since QtWebEngine 6.6]
Especifica que se active la lectura de todos los elementos canvas.
Esta configuración afectará a todos los elementos canvas de HTML5, independientemente de su origen, y puede desactivarse para evitar que se tomen huellas digitales del canvas.
Habilitado por defecto.
Esta propiedad se introdujo en QtWebEngine 6.6.
screenCaptureEnabled : bool [since QtWebEngine 1.3]
Indica al motor web si la captura de pantalla está soportada o no en esta aplicación.
Deshabilitada por defecto.
Esta propiedad se introdujo en QtWebEngine 1.3.
scrollAnimatorEnabled : bool [since QtWebEngine 6.8]
Activa el desplazamiento animado.
Desactivado por defecto.
Esta propiedad se introdujo en QtWebEngine 6.8.
showScrollBars : bool [since QtWebEngine 1.6]
Muestra las barras de desplazamiento. Activada por defecto.
Esta propiedad se introdujo en QtWebEngine 1.6.
spatialNavigationEnabled : bool
Activa la función de navegación espacial, es decir, la posibilidad de navegar entre elementos enfocables, como hipervínculos y controles de formularios, en una página web utilizando las teclas de flecha Izquierda, Derecha, Arriba y Abajo.
Por ejemplo, si un usuario pulsa la tecla Derecha, la heurística determina si hay un elemento que podría estar intentando alcanzar hacia la derecha y cuál es el elemento que probablemente desea.
Desactivado por defecto.
touchEventsApiEnabled : bool [since QtWebEngine 6.9]
Habilita la compatibilidad con la API de eventos táctiles de JavaScript, lo que significa que los manejadores de ontouchstart, ontouchend y ontouchmove estarán presentes en el objeto document.window.
Tenga en cuenta que algunos sitios web utilizan esta API para decidir si se ejecutan en un dispositivo móvil o en un ordenador de sobremesa y basan su diseño en ello. Esto puede provocar resultados no deseados en portátiles con pantalla táctil u otras configuraciones que emulen un dispositivo táctil falso.
Habilitada por defecto si el sistema detecta un dispositivo táctil y deshabilitada en caso contrario.
Esta propiedad se introdujo en QtWebEngine 6.9.
touchIconsEnabled : bool [since QtWebEngine 1.3]
Activa la compatibilidad con iconos táctiles e iconos táctiles precompuestos.
Deshabilitado por defecto.
Esta propiedad se introdujo en QtWebEngine 1.3.
trimAccessibilityIdentifiers : bool [since QtWebEngine 6.11]
Fuerza al atributo HTML 'id' a ser usado como el identificador de automatización (QAccessible::Identifier) sin modificación. Cuando está deshabilitado, Qt antepondrá en su lugar toda la jerarquía de objetos al identificador.
Deshabilitada por defecto.
Esta propiedad fue introducida en QtWebEngine 6.11.
unknownUrlSchemePolicy : enumeration [since QtWebEngine 1.7]
Especifica cómo se gestionan las peticiones de navegación a URLs con esquemas desconocidos.
| Constante | Descripción |
|---|---|
WebEngineSettings.DisallowUnknownUrlSchemes | Deshabilita todas las peticiones de navegación a URLs con esquemas desconocidos. |
WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction | Permite las peticiones de navegación a URLs con esquemas desconocidos que se emiten desde la interacción del usuario (como un clic del ratón), mientras que otras peticiones de navegación (por ejemplo desde JavaScript) se suprimen. |
WebEngineSettings.AllowAllUnknownUrlSchemes | Permite todas las peticiones de navegación a URL con esquemas desconocidos. |
El valor por defecto es WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction.
Esta propiedad se introdujo en QtWebEngine 1.7.
webGLEnabled : bool [since QtWebEngine 1.3]
Activa la compatibilidad con HTML 5 WebGL.
Habilitado por defecto si está disponible.
Esta propiedad se introdujo en QtWebEngine 1.3.
webRTCPublicInterfacesOnly : bool [since QtWebEngine 1.7]
Limita WebRTC sólo a direcciones IP públicas. Cuando está desactivado, WebRTC también puede utilizar direcciones IP de red local, pero los hosts remotos también pueden ver su dirección IP de red local.
Deshabilitado por defecto.
Esta propiedad se introdujo en QtWebEngine 1.7.
© 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.
