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.FileUpload
| 타입 | 정의 / 역할 |
|---|---|
| 파일 선택·드래그 앤 드롭·검증·업로드 진행률을 제공하는 필드입니다. | |
| Qt.labs.folderlistmodel로 로컬 파일 크기를 읽는 보조 타입이며 보통 SyFileUpload가 생성합니다. |
미리보기는 Qt 실행 화면의 이미지입니다. 아래 버튼으로 결과를 전환하세요.
SyFileUpload는 점선 드롭존과 대기 파일 목록이 있는 폼 필드입니다.
import QtQuick
import Syidax.Core
Item {
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
property QtObject settings: QtObject {
id: storyArgs
property string label: "첨부 파일"
property string accept: ""
property bool multiple: true
property real maxSize: 0
property int maxFiles: 0
property string buttonLabel: "Browse files"
property string dragLabel: "Drop files here or browse"
property string helperText: ""
property bool hideFiles: false
property string fieldState: ""
property bool disabled: false
property bool required: false
property string message: ""
}
SyFileUpload {
width: 420
label: storyArgs.label
accept: storyArgs.accept
multiple: storyArgs.multiple
maxSize: storyArgs.maxSize
maxFiles: storyArgs.maxFiles
buttonLabel: storyArgs.buttonLabel
dragLabel: storyArgs.dragLabel
helperText: storyArgs.helperText
hideFiles: storyArgs.hideFiles
fieldState: storyArgs.fieldState
disabled: storyArgs.disabled
required: storyArgs.required
message: storyArgs.message
}
}모든 파일은 메타데이터·읽기 가능 여부·accept/maxFiles/maxSize 검증 후 files/formValue에 들어갑니다.
import QtQuick
import Syidax.Core
Item {
component EventLog: Rectangle {
id: logBox
property var lines: []
implicitWidth: 440
implicitHeight: Math.max(56, logText.implicitHeight + 24)
radius: 4; color: Theme.semantic.backgroundBold
function log(value) { lines = lines.slice(-3).concat([String(value)]) }
Text {
id: logText; x: 12; y: 12; width: parent.width - 24
text: logBox.lines.length ? logBox.lines.join("\n") : "컨트롤을 조작하면 이벤트 결과가 표시됩니다."
wrapMode: Text.Wrap; color: Theme.semantic.textDefault
font.family: Theme.monoFontFamily; font.pixelSize: 12
}
}
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
// Focused Gallery routes: keep only the selected API and its prerequisites.
id: featureStory
readonly property alias uploadControl: upload
Column {
spacing: 12
SyFileUpload {
id: upload
width: 420
accept: ".svg,application/pdf"; maxSize: 5 * 1024 * 1024; maxFiles: 3; multiple: true
onRejected: (detail) => output.log(detail.file.name + ": " + detail.reason)
}
Row {
spacing: 8
SyButton { objectName: "upload-samples"; text: "샘플 파일 추가"; variant: "secondary"; size: "small"; onClicked: upload.addFiles([Qt.resolvedUrl("../avatar/portrait.svg"), Qt.resolvedUrl("samples/notes.txt"), Qt.resolvedUrl("../pdf-viewer/docs/quarterly-report.pdf"), Qt.resolvedUrl("../avatar/portrait.svg"), Qt.resolvedUrl("../pdf-viewer/docs/quarterly-report.pdf")]) }
}
EventLog { id: output }
}
}fieldState는 앱 자체 업로드의 결과를 알리기 위해 드롭존 테두리를 칠합니다: "error", "warning", "success"("" / "default"는 보통 테두리).
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
Column {
spacing: 12
SyFileUpload { id: featureTarget0; visible: true; width: 420; fieldState: "error"; dragLabel: "업로드 실패 — 파일을 다시 놓으세요" }
SyFileUpload { id: featureTarget1; visible: true; width: 420; fieldState: "success"; dragLabel: "모든 파일 업로드 완료" }
SyFileUpload { id: featureTarget2; visible: true; width: 420; disabled: true }
}
}컴포넌트는 업로드하지 않습니다.
import QtQuick
import Syidax.Core
Item {
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
readonly property alias uploadControl: upload
Column {
spacing: 12
SyFileUpload {
id: upload
width: 420
multiple: true
onSelected: (detail) => detail.files.forEach((file) => story.startUpload(file.id))
}
SyButton { objectName: "upload-samples"; text: "샘플 파일 추가"; variant: "secondary"; size: "small"; onClicked: upload.addFiles([Qt.resolvedUrl("../pdf-viewer/docs/quarterly-report.pdf"), Qt.resolvedUrl("../avatar/portrait.svg")]) }
}
id: story
property var uploading: ({})
function startUpload(id) { uploading[id] = 0; ticker.start() }
Timer {
id: ticker
interval: 120
repeat: true
onTriggered: {
let busy = false
for (const id in story.uploading) {
if (story.uploading[id] >= 100) continue
story.uploading[id] += 10
busy = true
if (story.uploading[id] >= 100) upload.setProgress(id, 100, id === "f2" ? "error" : "success")
else upload.setProgress(id, story.uploading[id])
}
if (!busy) ticker.stop()
}
}
}모든 파일은 메타데이터·읽기 가능 여부·accept/maxFiles/maxSize 검증 후 files/formValue에 들어갑니다.
import QtQuick
import Syidax.Core
Item {
component EventLog: Rectangle {
id: logBox
property var lines: []
implicitWidth: 440
implicitHeight: Math.max(56, logText.implicitHeight + 24)
radius: 4; color: Theme.semantic.backgroundBold
function log(value) { lines = lines.slice(-3).concat([String(value)]) }
Text {
id: logText; x: 12; y: 12; width: parent.width - 24
text: logBox.lines.length ? logBox.lines.join("\n") : "컨트롤을 조작하면 이벤트 결과가 표시됩니다."
wrapMode: Text.Wrap; color: Theme.semantic.textDefault
font.family: Theme.monoFontFamily; font.pixelSize: 12
}
}
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
// Focused Gallery routes: keep only the selected API and its prerequisites.
id: featureStory
readonly property alias uploadControl: upload
Column {
spacing: 12
SyFileUpload {
id: upload
width: 420
multiple: true; accept: ".svg,.pdf"
onSelected: (detail) => { if (true) { output.log(("selected: %1").arg(detail.files.map((f) => f.name).join(", "))) } }
onRejected: (detail) => { if (true) { output.log(("rejected: %1 (%2)").arg(detail.file.name).arg(detail.reason)) } }
onChanged: (detail) => { if (true) { output.log(("changed: %1개").arg(detail.files.length)) } }
onRemoved: (detail) => { if (true) { output.log(("removed: %1").arg(detail.file.name)) } }
}
SyButton { id: exampleControl1; visible: true; objectName: "upload-samples"; text: "샘플 파일 추가"; variant: "secondary"; size: "small"; onClicked: upload.addFiles([Qt.resolvedUrl("../avatar/portrait.svg"), Qt.resolvedUrl("samples/notes.txt")]) }
EventLog { id: output }
}
}모든 파일은 메타데이터·읽기 가능 여부·accept/maxFiles/maxSize 검증 후 files/formValue에 들어갑니다.
import QtQuick
import Syidax.Core
Item {
component EventLog: Rectangle {
id: logBox
property var lines: []
implicitWidth: 440
implicitHeight: Math.max(56, logText.implicitHeight + 24)
radius: 4; color: Theme.semantic.backgroundBold
function log(value) { lines = lines.slice(-3).concat([String(value)]) }
Text {
id: logText; x: 12; y: 12; width: parent.width - 24
text: logBox.lines.length ? logBox.lines.join("\n") : "컨트롤을 조작하면 이벤트 결과가 표시됩니다."
wrapMode: Text.Wrap; color: Theme.semantic.textDefault
font.family: Theme.monoFontFamily; font.pixelSize: 12
}
}
implicitWidth: Math.max(360, childrenRect.width)
implicitHeight: childrenRect.height
// Focused Gallery routes: keep only the selected API and its prerequisites.
id: featureStory
readonly property alias uploadControl: upload
Column {
spacing: 12
SyFileUpload { id: upload; width: 420; multiple: true; required: true }
Flow {
width: 560
spacing: 8
SyButton { visible: true; text: "upload.open()"; variant: "secondary"; size: "small"; onClicked: upload.open() }
SyButton { id: exampleControl1; visible: true; text: "upload.addFiles([\"file:///samples/report.pdf\"])"; variant: "secondary"; size: "small"; onClicked: upload.addFiles([Qt.resolvedUrl("../pdf-viewer/docs/quarterly-report.pdf")]) }
SyButton { id: exampleControl2; visible: true; text: "upload.removeFile(upload.getFile(0).id)"; variant: "secondary"; size: "small"; enabled: upload.files.length > 0; onClicked: upload.removeFile(upload.getFile(0).id) }
SyButton { visible: true; text: "upload.getFiles()"; variant: "secondary"; size: "small"; onClicked: output.log("getFiles() → " + JSON.stringify(upload.getFiles().map((f) => f.name))) }
SyButton { visible: true; text: "upload.clear()"; variant: "secondary"; size: "small"; onClicked: upload.clear() }
SyButton { visible: true; text: "upload.reportValidity()"; variant: "secondary"; size: "small"; onClicked: output.log("reportValidity() → " + upload.reportValidity()) }
}
EventLog { id: output }
}
}검증 전·오류 표시·초기화 결과를 비교합니다.
import QtQuick
import Syidax.Core
Column {
width: 440; spacing: 12
SyFileUpload {
id: field; width: parent.width; name: "selection"; required: true
label: "필수 입력"; accept: ".pdf,.png"
error: "계속하려면 이 항목을 입력하세요."
}
Row {
spacing: 8
SyButton { id: check; text: "검증"; onClicked: field.reportValidity() }
SyButton { id: reset; text: "초기화"; onClicked: field.reset() }
}
Text { text: "상태: " + (field.invalid ? "오류" : "입력 준비"); color: Theme.semantic.textDefault }
}업무 규칙에 맞는 오류를 표시하고 초기화합니다.
import QtQuick
import Syidax.Core
Column {
width: 440; spacing: 12
SyFileUpload {
id: field; width: parent.width; name: "selection"; required: true
label: "필수 입력"; accept: ".pdf,.png"
error: "현재 사용할 수 없는 선택입니다. 다른 값을 선택하세요."
}
Row {
spacing: 8
SyButton { id: check; text: "오류 표시"; onClicked: field.setCustomError() }
SyButton { id: reset; text: "초기화"; onClicked: field.reset() }
}
Text { text: "상태: " + (field.invalid ? "오류" : "입력 준비"); color: Theme.semantic.textDefault }
}항목을 가리키거나 선택하면 QML 예제와 복사 버튼이 나타납니다.
| 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|
| list | [] | 대기열: [{ id, name, size, type, progress, status, message, url }]. 읽고, 메서드로 바꾸십시오. | |
| string | "" | 쉼표로 구분한 규칙: .ext · type/* · type/subtype. 비면 전부. | |
| bool | false | 여러 파일. 아니면 새 선택이 대기열을 대체합니다. | |
| real | 0 | 바이트 단위 최대 크기. 크기를 읽은 뒤 검사. 0 = 제한 없음. | |
| int | 0 | 대기열의 최대 파일 수. 0 = 제한 없음. | |
| string | "Browse files" | Browse 버튼(대화상자 제목도). | |
| string | "Drop files here or browse" | 존 안의 문구. | |
| string | "" | 드래그 문구 아래의 자동 제한 줄을 대체. | |
| bool | false | 존 아래에 목록 없음. | |
| string | "" | "" / default · error · warning · success — 테두리를 칠함. 앱이 설정. | |
| string | "" | 클릭한 행의 id(setSelectedFile()). | |
| bool(읽기 전용) | — | 파일이 존 위로 드래그되는 중. | |
| string(읽기 전용) | — | 드래그 중: 파일의 all · some · none이 accept를 통과. 그 밖에는 "". | |
| string(읽기 전용) | — | 실제로 보이는 도움말 줄. | |
| list(읽기 전용) | — | 폼이 제출하는 것: files. | |
| bool(읽기 전용) | — | 존에 키보드 포커스가 있는지 | |
| bool(읽기 전용) | — | 포인터가 위에 있는지. | |
| string | "" | 프레임의 제목, 목록 아래 도움말, 사용자 오류 문구. | |
| string | "" | 프레임의 제목, 목록 아래 도움말, 사용자 오류 문구. | |
| string | "" | 프레임의 제목, 목록 아래 도움말, 사용자 오류 문구. | |
| string | "files" | SyForm.values()의 키. | |
| bool | false | 전부 반응 없음이며 항상 유효 | |
| bool | false | 빈 대기열은 valueMissing. | |
| 읽기 전용 | — | 유효성: "" · valueMissing · custom. invalid는 touched 되거나 report 된 뒤. | |
| 읽기 전용 | — | invalid는 touched 되거나 report 된 뒤. | |
| 읽기 전용 | — | 유효성: "" · valueMissing · custom. invalid는 touched 되거나 report 된 뒤. | |
| real | 360 | 앱이 너비를 정하지 않을 때의 너비. |
| 메서드 | 설명 |
|---|---|
파일 대화상자를 엽니다(accept로 거르고 multiple이면 여러 개 선택). disabled면 무시됩니다. | |
| 모든 파일은 메타데이터·읽기 가능 여부·accept/maxFiles/maxSize 검증 후 files/formValue에 들어갑니다. 검증 전 selected는 발생하지 않습니다. 거부한 파일은 rejected({file,reason})만 발생시킵니다. validating은 대기 상태입니다. 겹친 요청은 순서대로 처리하고 clear는 늦은 결과를 취소합니다. 단일 교체는 새 파일 검증 성공 후 changed.removed에 이전 파일을 포함하며 별도 removed 신호는 발생시키지 않습니다. 실패한 교체는 이전 파일을 유지합니다. | |
항목 하나를 빼고 removed, 그다음 changed를 발생시킵니다. 모르는 id는 무시됩니다. | |
대기열을 비우고 removed에 모든 항목을 담은 changed를 발생시킵니다(removed 시그널은 없음). | |
항목 하나의 바(0 … 100)와 상태(주어진 것, 또는 진행에서 유도)를 갱신하고 changed를 발생시킵니다. | |
| 대기열의 복사본. | |
index의 항목(또는 null). 인덱스가 없으면 선택된 항목, 없으면 첫 항목, 없으면 null. | |
| 그 행을 강조합니다(클릭이 하는 일). | |
| 존의 키보드 포커스 켜기 / 끄기. | |
| 존의 키보드 포커스 켜기 / 끄기. | |
상태가 ""인지 조용히 | |
| 같지만 오류 줄을 드러냄. | |
"", "valueMissing" 또는 "custom". | |
custom 상태를 강제 · 해제. | |
custom 상태를 강제 · 해제. | |
clear() 하고 touched / submitted / custom 플래그를 끕니다. |
| 시그널 | 인자 | 시점 |
|---|---|---|
detail: { files } | 파일이 더해짐(대화상자, 드롭, addFiles()). files는 새 항목만. | |
detail: { file, reason } | 검증 실패. files에는 들어가지 않음. | |
detail: { files, added, removed } | 추가·교체·제거·clear·진행 보고. 검증 실패만으로는 발생하지 않음. | |
detail: { file, files } | 파일 하나가 ×나 removeFile(id)로 빠짐. clear()에는 없음. | |
detail: { files, isValid, status } | 존이 키보드 포커스를 얻음 / 잃음. 블러는 필드를 touched로 표시합니다. | |
detail: { files, isValid, status } | 존이 키보드 포커스를 얻음 / 잃음. 블러는 필드를 touched로 표시합니다. |
| 항목 | 동작 / 조건 |
|---|---|
| 모든 파일은 메타데이터·읽기 가능 여부·accept/maxFiles/maxSize 검증 후 files/formValue에 들어갑니다. 검증 전 selected는 발생하지 않습니다. 거부한 파일은 rejected({file,reason})만 발생시킵니다. validating은 대기 상태입니다. 겹친 요청은 순서대로 처리하고 clear는 늦은 결과를 취소합니다. 단일 교체는 새 파일 검증 성공 후 changed.removed에 이전 파일을 포함하며 별도 removed 신호는 발생시키지 않습니다. 실패한 교체는 이전 파일을 유지합니다. | |
| 모든 파일은 메타데이터·읽기 가능 여부·accept/maxFiles/maxSize 검증 후 files/formValue에 들어갑니다. 검증 전 selected는 발생하지 않습니다. 거부한 파일은 rejected({file,reason})만 발생시킵니다. validating은 대기 상태입니다. 겹친 요청은 순서대로 처리하고 clear는 늦은 결과를 취소합니다. 단일 교체는 새 파일 검증 성공 후 changed.removed에 이전 파일을 포함하며 별도 removed 신호는 발생시키지 않습니다. 실패한 교체는 이전 파일을 유지합니다. | |
| 파일이 존 위로 드래그되는 중. | |
드래그 중: 파일의 all · some · none이 accept를 통과. 그 밖에는 "". | |
쉼표로 구분한 규칙: .ext · type/* · type/subtype. 비면 전부. | |
파일이 더해짐(대화상자, 드롭, addFiles()). files는 새 항목만. | |
항목 하나의 바(0 … 100)와 상태(주어진 것, 또는 진행에서 유도)를 갱신하고 changed를 발생시킵니다. | |
selected({ files })는 새 항목만 전달하며, 각각에 대해 업로드가 진행되는 대로 setProgress(id, progress, status)를 부르십시오: progress는 0 … 100으로 잘리고, status는 "ready", "uploading", "success", "error" 중 하나이며 생략하면 진행에 따릅니다(100 → "success", > 0 → "uploading", 0 → 그대로). 행은 상태가 "ready"를 벗어나면 상태 색의 바를 보이고, 항목의 message가 있으면 이름 아래에 보입니다. | |
selected({ files })는 새 항목만 전달하며, 각각에 대해 업로드가 진행되는 대로 setProgress(id, progress, status)를 부르십시오: progress는 0 … 100으로 잘리고, status는 "ready", "uploading", "success", "error" 중 하나이며 생략하면 진행에 따릅니다(100 → "success", > 0 → "uploading", 0 → 그대로). fieldState는 앱의 결과를 알리기 위해 테두리를 칠하며 — error · warning · success — 컴포넌트는 절대 스스로 설정하지 않습니다. | |
행은 상태가 "ready"를 벗어나면 상태 색의 바를 보이고, 항목의 message가 있으면 이름 아래에 보입니다. label은 위에, message나 오류 줄은 목록 아래에 놓입니다. | |
| 추가·교체·제거·clear·진행 보고. 검증 실패만으로는 발생하지 않음. | |
항목 하나를 빼고 removed, 그다음 changed를 발생시킵니다. 모르는 id는 무시됩니다. | |
클릭한 행의 id(setSelectedFile()). | |
index의 항목(또는 null). 인덱스가 없으면 선택된 항목, 없으면 첫 항목, 없으면 null. | |
| 존 아래에 목록 없음. | |
대기열: [{ id, name, size, type, progress, status, message, url }]. 읽고, 메서드로 바꾸십시오. | |
disabled는 존과 행을 흐리게 하고, 클릭·드롭·포커스·키를 막으며, open() / addFiles()를 무시합니다. | |
파일 대화상자를 엽니다(accept로 거르고 multiple이면 여러 개 선택). disabled면 무시됩니다. | |
| 모든 파일은 메타데이터·읽기 가능 여부·accept/maxFiles/maxSize 검증 후 files/formValue에 들어갑니다. 검증 전 selected는 발생하지 않습니다. 거부한 파일은 rejected({file,reason})만 발생시킵니다. validating은 대기 상태입니다. 겹친 요청은 순서대로 처리하고 clear는 늦은 결과를 취소합니다. 단일 교체는 새 파일 검증 성공 후 changed.removed에 이전 파일을 포함하며 별도 removed 신호는 발생시키지 않습니다. 실패한 교체는 이전 파일을 유지합니다. | |
"" / default · error · warning · success — 테두리를 칠함. 앱이 설정. | |
required인데 대기열이 비면 valueMissing, setCustomError()면 custom, disabled면 "". | |
required인데 대기열이 비면 valueMissing, setCustomError()면 custom, disabled면 "". | |
오류 줄은 필드가 touched 되거나(파일이 더해졌거나 존이 포커스를 잃음) reportValidity() 뒤에 보입니다. | |
SyForm.values()의 키. | |
name은 기본 "files"이고, SyForm.values()는 대기열(formValue), 즉 url이 있는 파일 항목 목록을 받습니다. | |
폼이 제출하는 것: files. | |
존은 최소 96 px 높이이고 필드 너비를 따릅니다: 앱이 width를 정하지 않으면 preferredWidth 360. | |
| 앱이 너비를 정하지 않을 때의 너비. | |
label은 위에, message나 오류 줄은 목록 아래에 놓입니다. |
| 항목 | 동작 / 조건 |
|---|---|
| 메타데이터·읽기 가능 여부·타입·개수·크기 검증이 끝난 파일만 files/formValue와 selected에 들어갑니다. validating 동안 pending 파일은 공개하지 않습니다. 겹친 요청은 호출 순서대로 완료하고 clear 후 늦은 결과는 버립니다. hideFiles도 검증을 생략하지 않습니다. 유효한 단일 파일 교체 시 changed.removed로 이전 파일을 알리며, 교체 실패는 이전 파일을 유지합니다. MIME/accept는 확장자 기준이므로 서버의 내용 검증을 대체하지 않습니다. | |
| Qt.labs.folderlistmodel이 없는 호스트는 fileSize(url)이 읽을 수 있는 파일 크기 또는 -1을 반환하는 Theme.fileMetadataProvider를 등록합니다. 제공한 C++/Python 호스트에 이 어댑터가 포함되어 있습니다. |