Documentos QML
Un documento QML es una cadena que cumple con la sintaxis de los documentos QML. Un documento define un tipo de objeto QML. Por lo general, un documento se carga desde un archivo ` ".qml" ` almacenado de forma local o remota, aunque también puede crearse manualmente en el código. Se puede crear una instancia del tipo de objeto definido por un documento utilizando un ` Component ` en código QML, o un ` QQmlComponent ` en C++. Alternativamente, si el tipo de objeto se expone explícitamente al sistema de tipos de QML con un nombre de tipo concreto, dicho tipo se puede utilizar directamente en las declaraciones de objetos de otros documentos.
La capacidad de definir tipos de objetos QML reutilizables en documentos es un factor clave que permite a los clientes escribir código modular, de gran legibilidad y fácil de mantener.
Desde Qt 5.4, un documento también puede tener la extensión de archivo ".ui.qml". El motor QML gestiona estos archivos como archivos .qml estándar e ignora la parte .ui de la extensión. Qt Design Studio gestiona esos archivos como archivos de interfaz de usuario. Los archivos solo pueden contener un subconjunto de las características del lenguaje QML.
Estructura de un documento QML
Un documento QML consta de dos secciones: la sección de importaciones y la sección de declaración de objetos. La sección de importaciones de un documento contiene sentencias de importación que definen qué tipos de objetos QML y qué recursos de JavaScript puede utilizar el documento. La sección de declaración de objetos define el árbol de objetos que se creará al instanciar el tipo de objeto definido por el documento.
A continuación se muestra un ejemplo de documento sencillo:
import QtQuick 2.0
Rectangle {
width: 300
height: 200
color: "blue"
}Consulte la sección «Estructura de un documento QML » para obtener más información sobre este tema.
Sintaxis del lenguaje QML
La sección de declaración de objetos del documento debe especificar una jerarquía de objetos válida con la sintaxis QML adecuada. Una declaración de objeto puede incluir la especificación de atributos de objeto personalizados. Los atributos de métodos de objeto pueden especificarse como funciones de JavaScript, y a los atributos de propiedades de objeto se les pueden asignar expresiones de enlace de propiedades.
Consulte la documentación sobre la sintaxis de QML para obtener más información sobre la sintaxis válida, y consulte la documentación sobre la integración de QML y JavaScript para obtener información detallada sobre este tema.
Definición de tipos de objetos a través de documentos QML
Tal y como se ha descrito brevemente en la sección anterior, un documento define implícitamente un tipo de objeto QML. Uno de los principios fundamentales de QML es la capacidad de definir y reutilizar tipos de objetos. Esto mejora la facilidad de mantenimiento del código QML, aumenta la legibilidad de las declaraciones de jerarquías de objetos y fomenta la separación entre la definición de la interfaz de usuario y la implementación de la lógica.
En el siguiente ejemplo, el desarrollador del cliente define un tipo ` Button ` mediante un documento en un archivo:
// Button.qml
import QtQuick
Rectangle {
width: 100; height: 100
color: "red"
MouseArea {
anchors.fill: parent
onClicked: console.log("Button clicked!")
}
}A continuación, el tipo ` Button ` se puede utilizar en una aplicación:
|
Consulte la documentación sobre la definición de tipos de objeto en documentos para obtener información detallada sobre el tema.
Carga de recursos y transparencia de red
Es importante señalar que QML es transparente en cuanto a la red. Las aplicaciones pueden importar documentos desde rutas remotas con la misma facilidad que desde rutas locales. De hecho, a cualquier propiedad de ` url ` se le puede asignar una URL remota o local, y el motor de QML se encargará de toda la comunicación de red necesaria.
Consulte la documentación sobre transparencia de red para obtener más información sobre la transparencia de red en las importaciones.
Ámbito y resolución de nombres
Las expresiones de los documentos suelen incluir objetos o propiedades de objetos, y dado que pueden definirse varios objetos y que distintos objetos pueden tener propiedades con el mismo nombre, QML debe definir una semántica predefinida para la resolución de símbolos. Consulte la página sobre ámbito y resolución de símbolos para obtener información detallada sobre el tema.
© 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.
