Definición de recursos de JavaScript en QML
La lógica de programa de una aplicación QML puede definirse en JavaScript. El código JavaScript puede definirse directamente en los documentos QML o separarse en archivos JavaScript (conocidos como « JavaScript Resources » en QML).
Hay dos tipos diferentes de recursos de JavaScript compatibles con QML: los archivos de implementación «code-behind» y los archivos compartidos (bibliotecas). Ambos tipos de recursos de JavaScript pueden importarse desde otros recursos de JavaScript o incluirse en módulos QML.
Recurso de implementación «code-behind»
La mayoría de los archivos JavaScript importados a un documento QML son implementaciones con estado para el documento QML que los importa. En estos casos, cada instancia del tipo de objeto QML definido en el documento requiere una copia independiente de los objetos y el estado de JavaScript para funcionar correctamente.
El comportamiento predeterminado al importar archivos de JavaScript es proporcionar una copia única y aislada para cada instancia de componente QML. Si ese archivo de JavaScript no importa ningún recurso ni módulo mediante la instrucción ` .import `, su código se ejecutará en el mismo ámbito que la instancia del componente QML y, por consiguiente, podrá acceder y manipular los objetos y propiedades declarados en dicho componente QML. De lo contrario, tendrá su propio ámbito único, y los objetos y propiedades del componente QML deberán pasarse como parámetros a las funciones del archivo JavaScript si son necesarios.
A continuación se muestra un ejemplo de recurso de implementación «code-behind»:
// MyButton.qml
import QtQuick 2.0
import "my_button_impl.js" as Logic // A new instance of this JavaScript resource
// is loaded for each instance of Button.qml.
Rectangle {
id: rect
width: 200
height: 100
color: "red"
MouseArea {
id: mousearea
anchors.fill: parent
onClicked: Logic.onClicked(rect)
}
}// my_button_impl.js
var clickCount = 0; // this state is separate for each instance of MyButton
function onClicked(button) {
clickCount += 1;
if ((clickCount % 5) == 0) {
button.color = Qt.rgba(1,0,0,1);
} else {
button.color = Qt.rgba(0,1,0,1);
}
}En general, la lógica sencilla debe definirse directamente en el archivo QML, pero la lógica más compleja debe separarse en recursos de implementación «code-behind» para facilitar el mantenimiento y la legibilidad.
Recursos JavaScript compartidos (bibliotecas)
Por defecto, los archivos JavaScript importados desde QML comparten su contexto con el componente QML. Esto significa que los archivos JavaScript tienen acceso a los mismos objetos QML y pueden modificarlos. En consecuencia, cada importación debe tener una copia única de estos archivos.
La sección anterior trata sobre las importaciones con estado de archivos JavaScript. Sin embargo, algunos archivos JavaScript carecen de estado y actúan más bien como bibliotecas reutilizables, en el sentido de que proporcionan un conjunto de funciones auxiliares que no requieren nada del lugar desde donde se han importado. Puedes ahorrar una cantidad significativa de memoria y acelerar la instanciación de los componentes QML si marcas dichas bibliotecas con un pragma especial, tal y como se muestra en el siguiente ejemplo.
// factorial.js
.pragma library
var factorialCount = 0;
function factorial(a) {
a = parseInt(a);
// factorial recursion
if (a > 0)
return a * factorial(a - 1);
// shared state
factorialCount += 1;
// recursion base-case.
return 1;
}
function factorialCallCount() {
return factorialCount;
}La declaración del pragma debe aparecer antes de cualquier código JavaScript, excluyendo los comentarios.
Ten en cuenta que varios documentos QML pueden importar ` "factorial.js" ` y llamar a las funciones `factorial` y `factorialCallCount` que proporciona. El estado de la importación de JavaScript se comparte entre los documentos QML que la importan y, por lo tanto, el valor de retorno de la función `factorialCallCount` puede ser distinto de cero cuando se llama desde un documento QML que nunca ha llamado a la función `factorial`.
Por ejemplo:
// Calculator.qml
import QtQuick 2.0
import "factorial.js" as FactorialCalculator // This JavaScript resource is only
// ever loaded once by the engine,
// even if multiple instances of
// Calculator.qml are created.
Text {
width: 500
height: 100
property int input: 17
text: "The factorial of " + input + " is: " + FactorialCalculator.factorial(input)
}Al ser compartidos, los archivos de biblioteca .pragma no pueden acceder directamente a los objetos de instancia ni a las propiedades de los componentes QML, aunque los valores QML pueden pasarse como parámetros de función.
© 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.