qmlformat
qmlformat
qmlformatはQMLファイルをQMLコーディング規約に従って自動的にフォーマットするツールです。詳細...
オプション
以下のオプションが利用できる：
| オプション | デフォルト値 | 説明 |
|---|---|---|
| -h, -help | コマンドラインオプションのヘルプを表示する。 | |
| -help-all | 一般的な Qt オプションを含むヘルプを表示します。 | |
| -v, -version | バージョン情報を表示します。 | |
| -V, -verbose | 冗長モード。より詳細な情報を出力します。 | |
| -write-defaults | デフォルトの設定を .qmlformat.ini に書き込んで終了する (警告: 既存の設定やコメントが上書きされます!)。 | |
| -無視設定 | すべての設定ファイルを無視し、コマンドラインオプションのみを考慮します。 | |
| -i, -inplace | 標準出力に出力する代わりに、ファイルをインプレースで編集します。 | |
| -f, -force | エラーが発生しても続行する。 | |
| -t, -tabs | スペースの代わりにタブを使う。 | |
| -w, -インデント幅 <width | 4 | インデント時に使用するスペース数を指定する。 |
| -n, -normalize | QML Coding Guidelinesに従ってオブジェクトの属性を並べ替える。 | |
| -F, -files <ファイル | fileにリストされているすべてのファイルをインプレースで整形する。 | |
| -l, -newline <改行 | 使用する改行フォーマットをオーバーライドする(ネイティブ macos unix windows)。 | |
| -objects-spacing | オブジェクト間のスペースを確保する（normalizeオプションでのみ動作）。 | |
| -functions-spacing | 関数間のスペースを確保する（normalizeオプションでのみ動作）。 |
引数
| 引数を指定します： |
|---|
| ファイル名 |
詳細
qmlformatは柔軟で、必要に応じて設定することができる。
出力
qmlformat はフォーマットされたファイルを標準出力に書き出します。ファイルをインプレースで更新したい場合は-i フラグを指定してください。
プロパティ、関数、シグナルのグループ化
-n または--normalize フラグを指定すると、qmlformat はすべてのプロパティ、関数、シグナルをグループ化します。
設定ファイル
設定ファイル.qmlformat.ini をプロジェクトソース、またはプロジェクトソースフォルダの親ディレクトリに含めることで、qmlformatを設定することができます。デフォルトの設定ファイルは--write-defaults フラグを渡すことで取得できます。これにより、現在の作業ディレクトリに.qmlformat.ini ファイルが生成されます。
警告： --write-defaults は既存の設定やコメントを上書きします！
ファイル一覧のフォーマット
フォーマットしたいファイルのリストを引数として渡すこともできますが、qmlformatは-F 、ファイルに格納されたファイル群をフォーマットするオプションを提供しています。この場合、フォーマットはインプレースで行われます。
// FileList.txt main.qml mycomponent.qml
そして、次のように使います。
qmlformat -F FileList.txt
注意: ファイルに無効なエントリーが含まれている場合、例えば存在しないファイルパスや、有効なファイルパスであっても内容が無効なqmlドキュメントである場合、qmlformat 、その特定のエントリーはエラーになります。有効なファイルエントリーはそのままフォーマットされます。
警告 Fオプションを指定すると、qmlformatは位置引数を無視します。
本ドキュメントに含まれる文書の著作権はそれぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
