En esta página

Integración de QML y JavaScript

El lenguaje QML utiliza una sintaxis similar a la de JSON y permite definir diversas expresiones y métodos como funciones de JavaScript. También permite a los usuarios importar archivos de JavaScript y utilizar la funcionalidad que proporcionan dichas importaciones.

Esto permite a los desarrolladores y diseñadores aprovechar sus conocimientos de JavaScript para desarrollar rápidamente tanto interfaces de usuario como la lógica de las aplicaciones.

Expresiones de JavaScript

QML cuenta con una profunda integración con JavaScript y permite definir controladores de señales y métodos en JavaScript. Otra característica fundamental de QML es la capacidad de especificar y hacer cumplir relaciones entre propiedades de objetos mediante enlaces de propiedades, que también se definen con JavaScript.

Consulta la página de documentación titulada «Expresiones de JavaScript en documentos QML» para obtener más información sobre el uso de expresiones de JavaScript en QML.

Creación dinámica de objetos QML desde JavaScript

QML admite la creación dinámica de objetos desde JavaScript. Esto resulta útil para retrasar la instanciación de objetos hasta que sea necesario, mejorando así el tiempo de inicio de la aplicación. También permite crear objetos visuales de forma dinámica y añadirlos a la escena en respuesta a la entrada del usuario u otros eventos. Esta funcionalidad puede utilizarse de dos formas principales.

Los objetos se pueden crear dinámicamente desde JavaScript de forma imperativa mediante la creación dinámica de objetos. Esto puede resultar útil, por ejemplo, cuando se utiliza QML como lenguaje de scripting de la aplicación.

Nota: A la hora de crear interfaces de usuario, la forma recomendada de crear objetos dinámicamente es utilizar construcciones declarativas, ya que estas se integran mejor con el motor y las herramientas de QML. Existen varios tipos que permiten esta funcionalidad, como los tipos ` Loader`, ` Instantiator` y ` Repeater `.

Recursos de JavaScript

La lógica de la aplicación definida en funciones de JavaScript puede separarse en archivos de JavaScript independientes, conocidos como recursos de JavaScript. Existen varios tipos diferentes de recursos de JavaScript, con semánticas distintas.

Consulte la página de documentación titulada «Definición de recursos de JavaScript en QML» para obtener más información sobre cómo definir recursos de JavaScript para QML.

Importaciones de JavaScript

Un documento QML puede importar recursos de JavaScript, y los recursos de JavaScript pueden importar otros recursos de JavaScript, así como módulos QML. Esto permite al desarrollador de aplicaciones proporcionar la lógica de la aplicación en archivos modulares e independientes.

Consulta la página de documentación titulada «Importación de recursos de JavaScript» para obtener más información sobre cómo importar recursos de JavaScript y cómo utilizar la funcionalidad que proporcionan.

Entorno de ejecución de JavaScript

El motor QML proporciona un entorno de JavaScript que presenta algunas diferencias con respecto al entorno de JavaScript que ofrece un navegador web. Se aplican ciertas limitaciones al código que se ejecuta en este entorno, y el motor QML proporciona varios objetos en el contexto raíz que pueden resultar desconocidos para los desarrolladores de JavaScript.

Estas limitaciones y extensiones se documentan en la descripción del entorno de ejecución de JavaScript que proporciona el motor QML.

También hay una descripción detallada de la gestión de memoria empleada por el motor de JavaScript.

Configuración del motor de JavaScript

Para casos de uso específicos, es posible que desees anular algunos de los parámetros que utiliza el motor de JavaScript para gestionar la memoria y compilar JavaScript. Consulta «Configuración del motor de JavaScript » para obtener más información sobre estos parámetros.

Hacer que las aplicaciones sean programables

Además de utilizar JavaScript en documentos Qml, Qt también permite integrar un motor de JavaScript en aplicaciones C++ para que sean programables mediante scripts. Esto permite ampliar la funcionalidad de la aplicación utilizando JavaScript sin necesidad de recompilarla.

Consulte «Hacer que las aplicaciones sean programables» para obtener información detallada sobre el uso del motor de JavaScript en aplicaciones de C++, incluyendo cómo exponer instancias de ` QObject ` a los scripts y las consideraciones de seguridad.

© 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.