QML Best Practices: Coding ConventionsThere are many different ways to code using QML. These are a set of guidelines to help your code look better and consistent. Coding ConventionsThe 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 QMLTo 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 CodeCommenting 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:
Group PropertiesMany 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 } [Previous: QML Best Practices Guides] © 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia. Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. |