Sur cette page

Le langage QML

Le langage QML constitue la base de la création d’interfaces utilisateur dynamiques et déclaratives. Cette section présente les principales fonctionnalités et la syntaxe du langage.

Concepts fondamentaux

Syntaxe

La section «Notions de base sur la syntaxe QML » présente les principes fondamentaux de QML, notamment les déclarations d’objets, les affectations de propriétés et les structures hiérarchiques d’objets. La maîtrise de ces notions de base est indispensable pour écrire du code QML.

Documents

La section «Documents QML » explique comment le code QML est organisé en fichiers et présente la structure d’un document QML. Chaque document peut définir des types réutilisables et comprend des importations, des déclarations d’objets et des définitions de propriétés.

Liaison de propriétés

La liaison de propriétés est l’une des fonctionnalités les plus puissantes de QML : elle permet aux propriétés de se mettre à jour automatiquement lorsque leurs dépendances changent. Les liaisons créent des relations dynamiques entre les propriétés sans nécessiter de code impératif.

Système d’événements « signal et gestionnaire »

Le système d'événements « signaux et gestionnaires » fournit le mécanisme de gestion des événements de QML. Les objets peuvent émettre des signaux lorsque certains événements se produisent, et d'autres objets peuvent y répondre en implémentant des gestionnaires de signaux, ce qui permet un couplage faible entre les composants.

Système d’importation

Instructions d'importation

Les instructions d'importation vous permettent d'inclure des modules QML, des fichiers JavaScript et des modules ECMAScript dans vos documents QML. Elles définissent les types et les fonctionnalités disponibles dans le champ d'application d'un document.

L'importation de répertoires de documents QML vous permet d'importer tous les types QML d'un répertoire sans définir explicitement de module. Cela est utile pour partager des composants QML au sein d'un projet pendant le développement.

L’importation de ressources JavaScript dans QML explique comment inclure des fichiers JavaScript du point de vue de JavaScript. Cela inclut l’importation dans des documents QML ou dans d’autres fichiers JavaScript.

Fonctionnalités avancées du langage

Masquage des propriétés et sémantique de redéfinition

La section «Masquage des propriétés et sémantique de redéfinition » décrit ce qui se passe lorsque des types dérivés redéfinissent les propriétés de leurs types de base. La compréhension de cette sémantique est essentielle pour un héritage correct et la personnalisation des composants.

Portée et résolution des noms

Portée et résolution des noms explique comment QML résout les identifiants et les propriétés dans des hiérarchies d'objets imbriquées. Cela inclut la compréhension des portées d'ID, des propriétés de contexte et de la chaîne de portée JavaScript.

Chargement des ressources et transparence réseau

Chargement des ressources et transparence réseau montre comment QML peut charger des ressources à partir de fichiers locaux ou d'URL réseau en utilisant la même syntaxe. Cela permet une intégration transparente du contenu distant et simplifie la gestion des ressources.

Voir également La référence QML et Le système de types 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.