qml포맷
qml포맷
qmlformat은 QML 코딩 규칙에 따라 QML 파일의 형식을 자동으로 지정하는 도구입니다. 더 보기...
옵션
다음 옵션을 사용할 수 있습니다:
| 옵션 | 기본값 | 설명 |
|---|---|---|
| -h, -help | 명령줄 옵션에 대한 도움말을 표시합니다. | |
| -help-all | 일반 Qt 옵션을 포함한 도움말을 표시합니다. | |
| -v, -version | 버전 정보를 표시합니다. | |
| -v, -verbose | 상세 모드. 자세한 정보를 출력합니다. | |
| -write-defaults | 기본 설정을 .qmlformat.ini에 쓰고 종료합니다(경고: 기존 설정 및 주석을 덮어씁니다!). | |
| -ignore-settings | 모든 설정 파일을 무시하고 명령줄 옵션만 고려합니다. | |
| -i, -inplace | stdout으로 출력하는 대신 파일을 제자리에서 편집합니다. | |
| -f, -force | 오류가 발생하더라도 계속 진행합니다. | |
| -t, -tabs | 공백 대신 탭을 사용합니다. | |
| -w, - 들여쓰기-폭 <폭> | 4 | 들여쓰기할 때 공백을 몇 개 사용할지 설정합니다. |
| -n, -normalize | QML 코딩 가이드라인에 따라 객체의 속성을 재정렬합니다. | |
| -F, -파일 <파일> | 파일에 나열된 모든 파일의 서식을 제자리에서 지정합니다. | |
| -l, -newline <새줄> | 사용할 새 줄 형식을 재정의합니다(기본 MacOS 유닉스 창). | |
| -객체 간격 | 개체 사이의 공백을 유지합니다(정규화 옵션에서만 작동). | |
| -함수 간격 | 함수 사이에 공백을 유지합니다(정규화 옵션에서만 작동). |
인수
| 인수입니다: |
|---|
| 파일 이름 |
세부 정보
qmlformat은 유연하며 필요에 따라 구성할 수 있습니다.
출력
qmlformat은 형식이 지정된 버전의 파일을 stdout에 씁니다. 파일을 제자리에서 업데이트하려면 -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은 위치 인수를 무시합니다.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
