Importación de recursos de JavaScript en QML
Los documentos QML y otros recursos JavaScript pueden importarrecursos JavaScript. Estos recursos pueden importarse mediante URL relativas o absolutas. En el caso de una URL relativa, la ubicación se resuelve en relación con la ubicación del documento QML o del recurso JavaScript que contiene la importación. Si no se puede acceder al archivo de script, se producirá un error. Si es necesario obtener el JavaScript de un recurso de red, la propiedad « status » del componente se establece en «Loading» hasta que se haya descargado el script.
Los recursos JavaScript también pueden importar módulos QML y otros recursos JavaScript. La sintaxis de una instrucción de importación dentro de un recurso JavaScript difiere ligeramente de la de una instrucción de importación dentro de un documento QML, lo cual se documenta detalladamente a continuación.
Importación de un recurso JavaScript desde un documento QML
Un documento QML puede importar un recurso JavaScript con la siguiente sintaxis:
import "ResourceURL" as QualifierPor ejemplo:
import "jsfile.js" as LogicLos recursos JavaScript importados siempre se califican mediante la palabra clave «as». El calificador de los recursos JavaScript debe comenzar con una letra mayúscula y debe ser único, por lo que siempre existe una correspondencia uno a uno entre los calificadores y los archivos JavaScript. (Esto también significa que los calificadores no pueden tener el mismo nombre que los objetos JavaScript integrados, como Date y Math).
Las funciones definidas en un archivo JavaScript importado están disponibles para los objetos definidos en el documento QML que las importa, mediante la sintaxis "Qualifier.functionName(params)". Las funciones de los recursos JavaScript pueden aceptar parámetros cuyos tipos pueden ser cualquier tipo de valor u objeto de QML, así como los tipos normales de JavaScript. Se aplicarán las reglas habituales de conversión de tipos de datos a los parámetros y a los valores de retorno al llamar a dichas funciones desde QML.
Importaciones dentro de recursos JavaScript
En QtQuick 2.0 se ha añadido compatibilidad para permitir que los recursos JavaScript importen otros recursos JavaScript y también espacios de nombres de tipo QML utilizando una variante de la sintaxis de importación estándar de QML (donde se aplican todas las reglas y restricciones descritas anteriormente).
Debido a la capacidad de un recurso de JavaScript para importar otro script o módulo QML de esta manera en QtQuick 2.0, se definen algunas semánticas adicionales:
- un script con sentencias de importación no heredará las importaciones del documento QML que lo haya importado (por ejemplo, el acceso a `Component.errorString` fallará)
- un script sin sentencias de importación heredará las importaciones del documento QML que lo haya importado (por ejemplo, el acceso a `Component.errorString` se realizará correctamente)
- un script compartido (definido como .pragma library) no heredará las importaciones de los documentos QML, incluso si el script no importa otros scripts o módulos
La primera semántica es conceptualmente correcta, dado que un script concreto puede ser importado por cualquier número de archivos QML. La segunda semántica se mantiene por motivos de compatibilidad con versiones anteriores. La tercera semántica no cambia con respecto a la semántica actual para los scripts compartidos, pero aquí se aclara en relación con el nuevo caso posible (en el que el script importa otros scripts o módulos).
Importación de un recurso JavaScript desde otro recurso JavaScript
Un recurso JavaScript puede importar otro de la siguiente manera:
import * as MathFunctions from "factorial.mjs";O bien:
.import "filename.js" as QualifierLa primera es la sintaxis estándar de ECMAScript para importar módulos de ECMAScript, y solo funciona desde dentro de módulos de ECMAScript, tal y como indica la extensión de archivo mjs. La segunda es una extensión de JavaScript proporcionada por el motor QML y funcionará también con elementos que no sean módulos. Al tratarse de una extensión sustituida por el estándar ECMAScript, se desaconseja su uso.
Cuando se importa un archivo JavaScript de esta forma, se importa con un calificador. Las funciones de ese archivo son entonces accesibles desde el script importador a través del calificador (es decir, como Qualifier.functionName(params)).
A veces resulta conveniente que las funciones estén disponibles en el contexto de importación sin necesidad de calificarlas. En este caso, deben utilizarse los módulos ECMAScript y la instrucción JavaScript ` import ` sin el calificador ` as `.
Por ejemplo, el código QML de la parte inferior izquierda llama a ` showCalculations() ` en ` script.mjs`, que a su vez puede llamar a ` factorial() ` en ` factorial.mjs`, ya que ha incluido ` factorial.mjs ` utilizando ` import`.
| |
|
La función Qt.include() incluye un archivo JavaScript desde otro sin utilizar módulos ECMAScript y sin calificar la importación. Hace que todas las funciones y variables del otro archivo estén disponibles en el espacio de nombres del archivo actual, pero ignora todos los pragmas e importaciones definidos en ese archivo. Esto no es recomendable, ya que una llamada a una función nunca debería modificar el contexto del llamante.
Qt.include() está obsoleta y debe evitarse. Se eliminará en una futura versión de Qt.
Importación de un módulo QML desde un recurso JavaScript
Un recurso de JavaScript puede importar un módulo QML de la siguiente manera:
.import TypeNamespace MajorVersion.MinorVersion as QualifierA continuación se muestra un ejemplo que también ilustra cómo utilizar los tipos QML de un módulo importado en JavaScript:
.import Qt.test 1.0 as JsQtTest
var importedEnumValue = JsQtTest.MyQmlObject.EnumValue3En concreto, esto puede resultar útil para acceder a la funcionalidad proporcionada a través de un tipo singleton; consulta QML_SINGLETON para obtener más información.
Por defecto, tu recurso JavaScript puede acceder a todas las importaciones del componente que importa el recurso. No tiene acceso a las importaciones del componente si este se declara como una biblioteca sin estado (utilizando .pragma library) o contiene una instrucción explícita .import.
Nota: La sintaxis .import no funciona para los scripts utilizados en WorkerScript
Véase también Definición de recursos JavaScript en QML.
© 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.