QMLQT QUICK · C++ · PYTHON
QML 컴포넌트, 공통 디자인 토큰과 직접 실행할 수 있는 예제로 데스크톱 화면을 만드세요.
QML Core는 별도 제품입니다. C++와 Python에서 같은 QML 화면을 사용합니다.
QML CORE
56개 컴포넌트 중 56개
START WITH A WORKING APP
SDK 압축을 풀고 플러그인 버전과 호환되는 Qt 키트로 빌드하세요.
cmake -S examples/cmake-app -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=C:/Qt/6.12.0/msvc2022_64 -DCMAKE_MSVC_DEBUG_INFORMATION_FORMAT=Embedded -DCMAKE_POLICY_DEFAULT_CMP0141=NEW
cmake --build build
build/syidax-example --license your.license.json --example workbench순수 QML 버전을 사용하고 Python 바인딩을 명시적으로 선택하세요.
python -m venv .venv
.venv/Scripts/python -m pip install -r examples/python-app/requirements-pyside6.txt
.venv/Scripts/python examples/python-app/main.py --binding pyside6 --license your.license.json --example records--diagnose --json으로 Qt 버전, import 경로, 폰트, 실행 상태와 라이선스를 점검하세요. 라이선스 토큰은 출력하지 않습니다.
Gallery 평가 앱을 지금 사용할 수 있습니다. 유료 SDK 판매와 다운로드는 준비 중입니다. 위 설치 예제는 SDK 출시 후 사용하는 방법입니다.
아래 버전에서 네이티브 창과 예제의 기본 실행을 검사했습니다. Qt 6.8은 소스 최소 기준이며 모든 Qt 버전의 검증을 뜻하지 않습니다. Gallery는 software 렌더러를 사용합니다.
실행 중인 Windows 앱을 단계별로 캡처했습니다. 재생·일시 정지로 각 상태를 살펴보세요.
TRY IT YOURSELF
Windows 앱에서 예제를 실행하고 속성을 살펴보며 밝은 테마와 어두운 테마를 전환하세요. Gallery는 평가용이며 상업용 SDK는 별도 제품입니다.
Gallery 다운로드 · Windows x64$24.99 / 월
$249.99 / 년 · 개발자 1명 기준
Chart와 동일한 정규 단가입니다. 첫 구매·추가 좌석·갱신에 같은 가격이 적용됩니다.
문서, 실행 가능한 예제와 진단 도구를 제공합니다. 개별 기술 지원, 온보딩, SLA는 제공하지 않습니다.
구매 및 라이선스 조건 보기 →--qml 경로가 Syidax 폴더를 포함하는지 확인하세요. Python에서는 qml-pure를 사용합니다. 소스 저장소가 아닌 압축 해제한 SDK를 기준으로 실행하세요.
QML Core 인증서를 다시 다운로드한 뒤 --license로 전달하세요. Web Core·Chart·Grid 인증서는 QML을 활성화하지 않습니다. 월간 만료 시 사용이 종료되며, 연간은 이용 기간 내 출시 버전에 한해 보유 권한이 적용됩니다.
플러그인 빌드의 Qt 버전과 아키텍처를 확인하세요. 서로 다른 Python Qt 바인딩을 혼용하지 마세요. qml-pure로 플러그인 ABI 의존성을 피할 수 있습니다.
PDF는 별도 QtQuick.Pdf 모듈이 필요합니다. 이 모듈이 없어도 나머지 Core 컴포넌트는 사용 가능합니다. 아이콘 팩 등록과 리소스 경로는 SDK의 ICON-PACKS 문서를 확인하세요.
예제는 사용자 앱 데이터 폴더에만 저장합니다. 권한과 디스크 공간을 확인하세요. 잘못된 JSON은 백업한 뒤 초기 데이터로 복구됩니다. 저장 실패 시 입력 값이 유지됩니다.
컨트롤의 이름이나 용도를 표시하는 라벨입니다. 필수 입력 표시와 도움말을 함께 제공할 수 있습니다.
import Syidax.Core.Label
| 타입 | 정의 / 역할 |
|---|---|
| 필수 입력 표시와 비활성 상태를 지원하는 라벨입니다. |
미리보기는 Qt 실행 화면의 이미지입니다. 아래 버튼으로 결과를 전환하세요.
SyLabel은 컨트롤의 캡션입니다: 제목(value)이 라벨 안에 선언한 컨트롤(또는 target으로 가리킨 아이템) 앞에 놓이고, 제목을 클릭하면 그 컨트롤에 포커스가 가며 — 체크박스나 스위치처럼 toggle() 함수가 있으면 토글까지 — 라벨의 required와 disabled가 켜져 있으면 컨트롤에 기록되어 캡션과 컨트롤이 어긋나지 않습니다.
import QtQuick
import Syidax.Core
Item {
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
id: story
property QtObject settings: QtObject {
id: storyArgs
property string value: "이름"
property bool required: false
property string requiredPosition: "right"
property string valuePosition: "left"
property real labelWidth: 0
property bool disabled: false
}
SyLabel {
value: storyArgs.value
required: storyArgs.required
requiredPosition: storyArgs.requiredPosition
valuePosition: storyArgs.valuePosition
labelWidth: storyArgs.labelWidth
disabled: storyArgs.disabled
TextInput {
width: 160; text: "홍길동"
font.family: Theme.fontFamily; font.pixelSize: 14; color: Theme.semantic.textDefault
}
}
}required: true는 제목 옆에 붉은 별표(테마의 오류 색)를 더하고, requiredPosition이 그것을 글자의 "right"(기본) 또는 "left"에 둡니다.
import QtQuick
import Syidax.Core
Item {
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
// Focused Gallery routes: keep only the selected API and its prerequisites.
id: featureStory
property QtObject settings: QtObject {
id: storyArgs
property bool required: true
property string requiredPosition: "right"
}
SyLabel { id: featureTarget0;
value: "이메일"
required: storyArgs.required
requiredPosition: storyArgs.requiredPosition
TextInput {
width: 200; text: "hong@example.com"
font.family: Theme.fontFamily; font.pixelSize: 14; color: Theme.semantic.textDefault
}
}
}labelWidth는 제목 열의 너비를 px로 고정하고(0 = 제목의 자연 너비), valuePosition은 그 열 안에서 제목을 정렬합니다: "left"(기본), "center", "right".
import QtQuick
import Syidax.Core
Item {
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
// Focused Gallery routes: keep only the selected API and its prerequisites.
id: story
property QtObject settings: QtObject {
id: storyArgs
property string valuePosition: "right"
}
Item {
width: 320
height: 40
Rectangle {
width: 120
height: parent.height
color: "transparent"
border.width: 1
border.color: Theme.semantic.borderBold
}
SyLabel { id: featureTarget0;
anchors.verticalCenter: parent.verticalCenter
value: "이름"
labelWidth: 120
valuePosition: storyArgs.valuePosition
TextInput {
width: 160; text: "홍길동"
font.family: Theme.fontFamily; font.pixelSize: 14; color: Theme.semantic.textDefault
}
}
}
}disabled: true는 제목을 가장 옅은 글자색으로 흐리게 하고, 포인터 커서를 끄며, 제목 클릭이 아무 일도 하지 않게 합니다(포커스도 toggle()도 없음).
import QtQuick
import Syidax.Core
Item {
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
property QtObject settings: QtObject {
id: storyArgs
property bool disabled: true
}
SyLabel {
value: "동작"
disabled: storyArgs.disabled
SyButton { text: "저장하기" }
}
}target은 라벨 안이 아니라 다른 곳 — 그리드의 다른 칸, 라벨 행 바깥 — 에 선언한 컨트롤을 가리킵니다.
import QtQuick
import Syidax.Core
Item {
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
property QtObject settings: QtObject {
id: storyArgs
property bool disabled: false
}
Row {
spacing: 16
SyLabel { anchors.verticalCenter: parent.verticalCenter; value: "동작"; target: saveButton; disabled: storyArgs.disabled }
SyButton { id: saveButton; text: "저장하기"; variant: "primary" }
}
}required · requiredPosition 설정을 적용한 오른쪽 필수 표시 예제입니다.
import QtQuick
import Syidax.Core
Item {
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
id: story
property QtObject settings: QtObject {
id: storyArgs
property string value: "이름"
property bool required: true
property string requiredPosition: "right"
property string valuePosition: "left"
property real labelWidth: 0
property bool disabled: false
}
SyLabel {
value: storyArgs.value
required: storyArgs.required
requiredPosition: storyArgs.requiredPosition
valuePosition: storyArgs.valuePosition
labelWidth: storyArgs.labelWidth
disabled: storyArgs.disabled
TextInput {
width: 160; text: "홍길동"
font.family: Theme.fontFamily; font.pixelSize: 14; color: Theme.semantic.textDefault
}
}
}항목을 가리키거나 선택하면 QML 예제와 복사 버튼이 나타납니다.
| 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|
| list (기본 속성) | — | 안에 선언한 컨트롤. target이 없으면 첫 번째가 라벨이 붙는 컨트롤입니다. | |
| string | "" | 캡션 글자(14 px). | |
| bool | false | 별표를 보이고, 켜져 있거나 바뀔 때 컨트롤에 required가 있으면 거기에 기록합니다. | |
| string | "right" | "left" · "right" — 별표의 위치. | |
| string | "left" | "left" · "center" · "right" — labelWidth 열 안에서의 제목 정렬. labelWidth: 0이면 눈에 띄는 효과 없음. | |
| real | 0 | 제목 열의 고정 너비(px). 0 = 제목의 자연 너비. 컨트롤은 열 뒤에서 시작합니다. | |
| bool | false | 제목을 흐리게 하고 제목 클릭을 막으며, 켜져 있거나 바뀔 때 컨트롤에 disabled가 있으면 거기에 기록합니다(아니면 컨트롤 자신의 disabled: true가 유지됨). | |
| Item | null | 다른 곳에 선언한 컨트롤. 설정되면 안의 아이템 대신 이것이 라벨이 붙는 컨트롤입니다. | |
| var (읽기 전용) | — | 라벨이 작용하는 아이템: target, 아니면 안의 첫 아이템, 아니면 null. |
| 메서드 | 설명 |
|---|---|
라벨의 required와 disabled 가운데 켜진 플래그를 현재 컨트롤에(그 컨트롤이 가진 속성에 한해) 기록합니다. 컨트롤이 들어올 때 자동으로 호출되고, required나 disabled가 바뀔 때는 두 플래그를 있는 그대로 기록하며 호출됩니다. 라벨 모르게 컨트롤의 그 속성을 바꾼 뒤에만 직접 호출하십시오. 반환값 없음. |
| 항목 | 동작 / 조건 |
|---|---|
SyLabel은 자체 시그널을 선언하지 않습니다. 속성 변경 시그널(onControlChanged, onRequiredChanged, …)은 쓸 수 있습니다. 제목 클릭은 알리지 않습니다 — 컨트롤에 포커스를 주고(토글하고) 컨트롤이 자기 변화를 알립니다. | |
SyLabel은 자체 시그널을 선언하지 않습니다. 속성 변경 시그널(onControlChanged, onRequiredChanged, …)은 쓸 수 있습니다. 제목 클릭은 알리지 않습니다 — 컨트롤에 포커스를 주고(토글하고) 컨트롤이 자기 변화를 알립니다. |
| 항목 | 동작 / 조건 |
|---|---|
라벨이 작용하는 아이템: target, 아니면 안의 첫 아이템, 아니면 null. | |
| 다른 곳에 선언한 컨트롤. 설정되면 안의 아이템 대신 이것이 라벨이 붙는 컨트롤입니다. | |
제목을 흐리게 하고 제목 클릭을 막으며, 켜져 있거나 바뀔 때 컨트롤에 disabled가 있으면 거기에 기록합니다(아니면 컨트롤 자신의 disabled: true가 유지됨). | |
별표를 보이고, 켜져 있거나 바뀔 때 컨트롤에 required가 있으면 거기에 기록합니다. | |
"left" · "right" — 별표의 위치. | |
| 제목은 가장 옅은 글자색을 씁니다. 컨트롤은 위의 전달을 통해서만 자체 비활성 모양을 갖습니다. | |
제목 열의 고정 너비(px). 0 = 제목의 자연 너비. 컨트롤은 열 뒤에서 시작합니다. | |
"left" · "center" · "right" — labelWidth 열 안에서의 제목 정렬. labelWidth: 0이면 눈에 띄는 효과 없음. | |
| 라벨의 암시적 크기는 행(제목 열 + 4 px + 컨트롤)의 크기이며 컨트롤은 자기 크기를 유지합니다. |
| 항목 | 동작 / 조건 |
|---|---|
완전한 폼에는 SyForm과 SyFormItem; 흔한 컨트롤로 SyInput, SyCheckbox, SySwitch, SySelect(뒤의 셋은 제목 클릭으로 토글되거나 포커스를 받습니다). |