Props

名称	类型	默认值	说明
width	number | string	-	卡片宽度。数字按像素解释，字符串按原样使用。在弹性行或网格轨道里这是首选宽度：行更窄时卡片仍然会让位。
height	number | string	-	卡片高度。数字按像素解释，字符串按原样使用。给出固定高度后，卡片的内部内容会自己滚动；auto 和不传则交给内容决定。
maxWidth	number | string	-	卡片的最大宽度。
minHeight	number | string	-	卡片的最小高度。
padding	SpacingStep	-	四边的内边距，取间距比例的一档：0、0.5、1、1.5、2、3、4、5、6、8、10。省略时使用主题的卡片内边距（无主题时为间距步进 4），所以传入步进值意味着覆盖主题，而不是复述默认值。
variant	CardVariant	'default'	背景变体。default 使用标准卡片表面并带描边，transparent 去掉背景和描边，muted 使用弱化背景。非语义色相：blue、cyan、gray、green、orange、pink、purple、red、teal、yellow。
elevation	CardElevation	'none'	静止时的阴影深度，可选 none、low、med、high。只有在卡片需要浮在周围内容之上时才抬升它。

插槽

名称	说明
default	卡片的内容，通常是一个装着标题、文字和操作的 Stack。

主题变量

名称	默认值	说明
--astryx-card-padding	--astryx-spacing-4	主题的卡片内边距。为 padding 传入步进值时会绕过它。同族的 --astryx-card-padding-inline、--astryx-card-padding-inline-start、--astryx-card-padding-inline-end、--astryx-card-padding-block-start、--astryx-card-padding-block-end 可以按边细化。
--astryx-card-background	-	default 变体的背景。
--astryx-card-muted-background	-	muted 变体的背景。
--astryx-card-border	-	default 变体的描边颜色。宽度固定为 --astryx-border-width。
--astryx-card-<色相>-background	-	十个色相变体的背景，例如 --astryx-card-blue-background。
--astryx-card-shadow-low、-med、-high	内置阴影	三档抬升阴影，分别对应 elevation 的 low、med、high。主题未定义时使用内置的阴影值。
--_card-radius	--astryx-radius-container	卡片圆角。内部变量，主题可以覆盖。
--_card-elevation	0 0 transparent	静止阴影，由 elevation 写入。它与 --_card-ring 一起组成卡片的 box-shadow，所以描边环和抬升阴影可以共存。
--_card-ring	0 0 transparent	画在卡片阴影列表里的内环，供需要表达选中状态的组合组件设置。

原生属性

根元素为 <div>。

以下内容传入根元素：

• HTML 属性。
• aria-* 属性。
• data-* 属性。
• class。
• style。

variant、elevation、padding 会同时反映为根元素上的 data-variant、data-elevation、data-padding，height 为固定值时还会带上 data-scrollable="true"。