En esta página

El lenguaje QML

El lenguaje QML proporciona la base para crear interfaces de usuario dinámicas y declarativas. En esta sección se describen las características y la sintaxis fundamentales del lenguaje.

Conceptos básicos

Sintaxis

«Conceptos básicos de la sintaxis de QML» presenta los fundamentos de QML, incluidas las declaraciones de objetos, las asignaciones de propiedades y las estructuras jerárquicas de objetos. Comprender estos conceptos básicos es esencial para escribir cualquier código en QML.

Documentos

«Documentos QML» explica cómo se organiza el código QML en archivos y la estructura de un documento QML. Cada documento puede definir tipos reutilizables e incluye importaciones, declaraciones de objetos y definiciones de propiedades.

Enlace de propiedades

El enlace de propiedades es una de las características más potentes de QML, ya que permite que las propiedades se actualicen automáticamente cuando cambian sus dependencias. Los enlaces crean relaciones dinámicas entre propiedades sin necesidad de código imperativo.

Sistema de eventos de señales y controladores

El sistema de eventos de señales y controladores proporciona el mecanismo de gestión de eventos de QML. Los objetos pueden emitir señales cuando se producen determinados eventos, y otros objetos pueden responder implementando controladores de señales, lo que permite un acoplamiento débil entre los componentes.

Sistema de importación

Instrucciones de importación

Las instrucciones de importación te permiten incluir módulos QML, archivos JavaScript y módulos ECMAScript en tus documentos QML. Definen qué tipos y funcionalidades están disponibles dentro del ámbito de un documento.

La importación de directorios de documentos QML te permite importar todos los tipos QML de un directorio sin definir explícitamente un módulo. Esto resulta útil para compartir componentes QML dentro de un proyecto durante el desarrollo.

La importación de recursos de JavaScript en QML explica cómo incluir archivos de JavaScript desde la perspectiva de JavaScript. Esto incluye la importación a documentos QML o a otros archivos de JavaScript.

Características avanzadas del lenguaje

Oscurecimiento de propiedades y semántica de la anulación

«Ocultación de propiedades y semántica de sobrescritura» describe lo que ocurre cuando los tipos derivados redefinen propiedades de sus tipos base. Comprender esta semántica es fundamental para una herencia adecuada y la personalización de componentes.

Ámbito y resolución de nombres

«Ámbito y resolución de nombres » explica cómo QML resuelve identificadores y propiedades en jerarquías de objetos anidadas. Esto incluye comprender los ámbitos de los ID, las propiedades de contexto y la cadena de ámbito de JavaScript.

Carga de recursos y transparencia de red

Carga de recursos y transparencia de red muestra cómo QML puede cargar recursos desde archivos locales o URL de red utilizando la misma sintaxis. Esto permite una integración perfecta del contenido remoto y simplifica la gestión de activos.

Véase también La referencia de QML y El sistema de tipos de 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.