QtShadcn
组件

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
Copyright © 2026