[{"data":1,"prerenderedAt":248},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-introduction":56,"-getting-started-introduction-surround":245},[4,36,46],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":35},"快速开始","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15,20,25,30],{"title":11,"path":12,"stem":13,"icon":14},"简介","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"安装与构建","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"如何使用","\u002Fgetting-started\u002Fusage","1.getting-started\u002F3.usage","i-lucide-play",{"title":26,"path":27,"stem":28,"icon":29},"项目结构","\u002Fgetting-started\u002Fproject-structure","1.getting-started\u002F4.project-structure","i-lucide-folder-tree",{"title":31,"path":32,"stem":33,"icon":34},"里程碑","\u002Fgetting-started\u002Fmilestones","1.getting-started\u002F5.milestones","i-lucide-map",false,{"title":37,"icon":38,"path":39,"stem":40,"children":41,"page":35},"设计","i-lucide-drafting-compass","\u002Fdesign","2.design",[42],{"title":43,"path":44,"stem":45,"icon":38},"技术方案","\u002Fdesign\u002Ftechnical-design","2.design\u002F1.technical-design",{"title":47,"icon":48,"path":49,"stem":50,"children":51,"page":35},"开发","i-lucide-puzzle","\u002Fdevelopment","3.development",[52],{"title":53,"path":54,"stem":55,"icon":48},"组件开发流程","\u002Fdevelopment\u002Fcomponent-workflow","3.development\u002F1.component-workflow",{"id":57,"title":11,"body":58,"description":238,"extension":239,"links":240,"meta":241,"navigation":242,"path":12,"seo":243,"stem":13,"__hash__":244},"docs\u002F1.getting-started\u002F1.introduction.md",{"type":59,"value":60,"toc":230},"minimark",[61,66,81,88,93,126,130,138,142,148,154,158],[62,63,65],"h1",{"id":64},"qtshadcn-简介","QtShadcn 简介",[67,68,69],"p",{},[70,71,72,73,80],"strong",{},"QtShadcn — A modern, composable UI component library for Qt 6 \u002F QML, inspired by ",[74,75,79],"a",{"href":76,"rel":77},"https:\u002F\u002Fui.shadcn.com",[78],"nofollow","shadcn\u002Fui",".",[67,82,83,84,87],{},"对齐 shadcn\u002Fui 的设计哲学：",[70,85,86],{},"Design Token → Component → Composition → Theme","。组件可组合、可复制、无黑盒依赖；开发者在组件上组合出页面，而不是在画布上摆放控件。",[89,90,92],"h2",{"id":91},"特性","✨ 特性",[94,95,96,108,114,120],"ul",{},[97,98,99,102,103,107],"li",{},[70,100,101],{},"Design Token 驱动"," — 语义化颜色 \u002F 圆角 \u002F 间距 token，",[104,105,106],"code",{},"theme.mode = \"dark\""," 全局随动",[97,109,110,113],{},[70,111,112],{},"QML 管 UI，C++ 管能力"," — Theme 引擎、Icon 注册、Model 等能力层落在 C++，不退化成一个「QML 样式库」",[97,115,116,119],{},[70,117,118],{},"复用 Qt Quick Controls"," — 键盘导航、Focus、无障碍开箱即得，只做视觉与组件 API",[97,121,122,125],{},[70,123,124],{},"可组合组件"," — Card = CardHeader \u002F CardContent \u002F CardFooter，对齐 shadcn\u002Fui 组合方式",[89,127,129],{"id":128},"明确不做","🚫 明确不做",[94,131,132,135],{},[97,133,134],{},"❌ QWidget + QPainter 手绘控件（传统桌面控件库路线）",[97,136,137],{},"❌ 重新发明 Qt Quick Controls 的基础行为（键盘导航 \u002F Focus \u002F Accessibility \u002F 输入事件 \u002F Tab 顺序）",[89,139,141],{"id":140},"️-核心原则","🏗️ 核心原则",[67,143,144,147],{},[70,145,146],{},"QML 负责 UI，C++ 负责能力。"," 依赖方向单向：QML 组件 → C++ 能力层（Theme 引擎、Icon 系统、Model、原生能力）。C++ 不反向依赖具体 QML 组件。",[149,150,151],"blockquote",{},[67,152,153],{},"反模式警告：全部纯 QML 会让项目退化成「一个 QML 样式库」。",[89,155,157],{"id":156},"技术栈","📦 技术栈",[159,160,161,174],"table",{},[162,163,164],"thead",{},[165,166,167,171],"tr",{},[168,169,170],"th",{},"层",[168,172,173],{},"选型",[175,176,177,186,194,202,218],"tbody",{},[165,178,179,183],{},[180,181,182],"td",{},"UI \u002F Style",[180,184,185],{},"QML（声明式组合）",[165,187,188,191],{},[180,189,190],{},"基础行为",[180,192,193],{},"Qt Quick Controls 2（Basic style，token 自绘前提）",[165,195,196,199],{},[180,197,198],{},"能力层",[180,200,201],{},"C++（Qt 6）",[165,203,204,207],{},[180,205,206],{},"构建",[180,208,209,210,213,214,217],{},"CMake + ",[104,211,212],{},"qt_add_qml_module","（",[104,215,216],{},"import QtShadcn","）",[165,219,220,223],{},[180,221,222],{},"环境",[180,224,225,226,229],{},"Qt 6.5+ \u002F CMake 3.24+（本机 Qt 6.11.1 @ ",[104,227,228],{},"~\u002FQt\u002F6.11.1\u002Fmacos",", arm64）",{"title":231,"searchDepth":232,"depth":232,"links":233},"",2,[234,235,236,237],{"id":91,"depth":232,"text":92},{"id":128,"depth":232,"text":129},{"id":140,"depth":232,"text":141},{"id":156,"depth":232,"text":157},"QtShadcn 项目定位与设计哲学。","md",null,{},{"icon":14},{"title":11,"description":238},"8LgLwWQnOP5Pq0C_-C1rTqoYiuJ8ANpWrnfx_mEFWYs",[240,246],{"title":16,"path":17,"stem":18,"description":247,"icon":19,"children":-1},"克隆、构建并运行 QtShadcn showcase。",1787050744172]