Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QML Best Practices: Coding Conventions

There are many different ways to code using QML. These are a set of guidelines to help your code look better and consistent.

Coding Conventions

The official QML Coding Conventions may be found at QML Coding Conventions. This is the recommended convention that will be used throughout the QML documentation.

In addition, Qt's official code style may be found at the Qt Coding Style.

Importing Files into QML

To import items such as directories, use the "import" keyword, similar to the way the import QtQuick 1.0 statement is used.

 import QtQuick 1.0
 import QtWebKit 1.0
 import "subdirectory"
 import "script.js"

To facilitate the import of QML components, it is best to begin the QML file with an uppercase character. This way, the user can simply declare the component using the file name as the component name. For example, if a QML component is in a file named Button.qml, then the user may import the component by declaring a Button {}. Note that this method only works if the QML files are in the same directory.

It is also possible to import QML files which have file names that begin in lower case or files in a different directory by using a qmldir file.

A qmldir file tells your QML application which QML components, plugins, or directories to import. The qmldir file must reside in an imported directory. By using the qmldir file, users may import any QML file and assign any valid QML component name to the component.

For more information, read the section on Loading a Component.

Commenting Code

Commenting code allows others to read the source code better. As well, comments allow the programmer to think about his or her code; a confusing comment may mean the code is confusing.

Similar to JavaScript or C++, there are two ways of commenting QML code:

  • Single line comments start with // and finish at the end of the line
  • Multiline comments start with /* and finish with */

Group Properties

Many QML properties are attached or group properties. For convenience, you may treat them as another element when dealing with multiple properties belonging to the same group.

 border.width: 1
 border.color: "red"
 anchors.bottom: parent.bottom
 anchors.left: parent.left

Treating groups of properties as a block can ease confusion and help relate the properties with other properties.

 border {
     width: 1;
     color: "red"
 }
 anchors {
     bottom: parent.bottom;
     left: parent.left
 }
Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. La rubrique Qt a besoin de vous ! 1
Page suivante

Le Qt Labs au hasard

Logo

Construire l'avenir : (ré-)introduction aux composants de Qt Quick

Les Qt Labs sont les laboratoires des développeurs de Qt, où ils peuvent partager des impressions sur le framework, son utilisation, ce que pourrait être son futur. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.7-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web