QML Best Practices: Coding Conventions

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.

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

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