组件
ShadcnCard
卡片容器:CardHeader / CardContent / CardFooter 组合。

纯组合组件:Card = CardHeader / CardContent / CardFooter,对齐 shadcn 组合方式。
用法
ShadcnCard {
width: 320
// size: ShadcnCard.Size.Default(padding 24px)/ Small(16px)
ShadcnCardHeader {
ShadcnCardTitle { text: qsTr("Card Title") }
ShadcnCardDescription { text: qsTr("Card Description") }
}
ShadcnCardContent {
Text { text: qsTr("内容区") }
}
ShadcnCardFooter {
ShadcnButton { text: qsTr("取消"); variant: ShadcnButton.Variant.Outline; size: ShadcnButton.Size.Small }
ShadcnButton { text: qsTr("确定"); size: ShadcnButton.Size.Small }
}
}
布局
内容容器是 ColumnLayout(0.2.0 起,此前是 Column),所以卡片内部可以用布局属性表达伸缩:
ShadcnCard {
Layout.fillWidth: true
Layout.fillHeight: true // 卡片自身在父布局里伸缩
ShadcnCardHeader { ShadcnCardTitle { text: "对话" } }
ShadcnCardContent {
Layout.fillHeight: true // 内容占满 Header/Footer 之外的剩余高度
}
}
三点注意:
- 直接子项不要用
x/y自由定位,位置由 ColumnLayout 接管;需要居中用Layout.alignment: Qt.AlignCenter CardHeader/CardContent/CardFooter的宽度由 Card 统一管理,不要再给它们设width- 卡片自身声明了
Layout.minimumWidth: 0,放进RowLayout时可以自由压缩,一行放多张不会把窗口顶宽
子组件
| 组件 | 说明 |
|---|---|
ShadcnCardHeader | 头部:Title(16px Medium)+ Description(14px mutedForeground)垂直堆叠(gap 6px) |
ShadcnCardTitle | 标题文本 |
ShadcnCardDescription | 描述文本 |
ShadcnCardContent | 内容区 |
ShadcnCardFooter | 底部按钮区,水平排列(gap 8px) |
视觉
bg-card+ 1px 前景色环(light 5% / dark 10%)+shadow-md+theme.radius圆角- size Default 内边距 24px,Small 16px
