QML文書ディレクトリのインポート

QMLファイルのローカルディレクトリは、追加の設定や構成なしにインポートできます。リモートの QML ディレクトリもインポートできますが、qmldir ファイルが存在する必要があります。インポートするクライアントに提供する型名を定義したり、インポーターが利用できるようにする JavaScript リソースを指定するために、ローカルディレクトリにはqmldir ファイルを含めることができます。

ローカルディレクトリのインポート

ローカルファイルシステム上の QML ファイルは、ディレクトリの絶対パスまたは相対パスを参照する import 文を使用することで、ローカルディレクトリをインポートすることができます。

ローカルディレクトリにqmldir ファイルが存在する場合は、qmldir ファイルで指定された型名が使用可能になります。そうでない場合は、QML ドキュメントのファイル名から派生した型名が使用可能になります。それ以外の場合は、QML文書のファイル名に由来する型名で利用できるようになります。ディレクトリにqmldir ファイルが指定されていない場合は、大文字で始まり、".qml "で終わるファイル名のみが型として公開されます。

ディレクトリのインポートはモジュールのインポートよりも優先されます。同じ名前空間にインポートされたモジュールとディレクトリで同じ名前が定義されている場合、モジュールの型だけが利用可能になります。

例

次のようなQMLプロジェクトのディレクトリ構造を考えてみましょう。トップレベルのディレクトリmyapp の下に、mycomponents というサブディレクトリに共通の UI コンポーネントがあり、main というサブディレクトリにメインのアプリケーションコードがあります：

myapp
    |- mycomponents
        |- CheckBox.qml
        |- DialogBox.qml
        |- Slider.qml
    |- main
        |- application.qml

main/application.qml ファイルは、mycomponents ディレクトリを相対パスでインポートし、そのディレクトリ内で定義された QML オブジェクトタイプを使用することができます：

import "../mycomponents"

DialogBox {
    CheckBox {
        // ...
    }
    Slider {
        // ...
    }
}

この場合、そのディレクトリで定義されているQMLオブジェクトの型はすべて修飾されていなければなりません：

import "../mycomponents" as MyComponents

MyComponents.DialogBox {
    // ...
}

ローカルディレクトリをインポートする機能は、アプリケーション内のコンポーネントセットやアプリケーションのプロトタイピングのような場合に便利ですが、そのようなモジュールをインポートするコードは、モジュールディレクトリが別の場所に移動した場合、関連するimport ステートメントを更新しなければなりません。代わりにQMLモジュールを使えば、インストールされたモジュールはファイルシステムのパスではなく、一意な識別子文字列でインポートされるため、このような事態を避けることができます。

暗黙のインポート

QML文書が存在するディレクトリは自動的にインポートされます。"." などを明示的にインポートする必要はありません。

遠隔地にあるディレクトリ

QMLファイルのあるディレクトリが、qmldir 。

例えば、先ほどの例のmyapp ディレクトリが "http://www.my-example-server.com "でホストされており、mycomponents ディレクトリに以下のように定義されたqmldir ファイルがあったとします：

CheckBox CheckBox.qml
DialogBox DialogBox.qml
Slider Slider.qml

そして、このディレクトリは、リモートのmycomponents ディレクトリへのURLを使ってインポートすることができる：

import "http://www.my-example-server.com/myapp/mycomponents"

DialogBox {
    CheckBox {
        // ...
    }
    Slider {
        // ...
    }
}

ネットワーク経由でディレクトリをインポートする場合、そのディレクトリにあるqmldir ファイルで指定された QML ファイルと JavaScript ファイルにしかアクセスできないことに注意してください。

qmldirファイルのディレクトリ一覧

ディレクトリ一覧qmldir ファイルは、モジュール定義 qmldir ファイルとは明確に異なります。ディレクトリリストqmldir ファイルはQML文書群を迅速かつ容易に共有することを可能にしますが、 文書群によって定義されたQMLオブジェクト型を登録する型名前空間を定義したり、 QMLオブジェクト型のバージョン管理をサポートするものではありません。

ディレクトリリストqmldir ファイルのシンタックスは以下の通りです：

RoundedButton RoundedBtn.qml

internal HighlightedButton HighlightedBtn.qml

MathFunctions mathfuncs.js

ローカルファイルシステムのディレクトリにqmldir ファイルを置くことができる。これにより、そのディレクトリをインポートしたクライアントに対して、特定の QML タイプのみを公開することができます。さらに、ディレクトリ内の JavaScript リソースは、qmldir ファイルで宣言されない限り、クライアントに公開されません。