文档演练博客

单选按钮卡片

一组交互式卡片，每次只能选择一个选项。

View source Report an issue View in Playground

<Box maxWidth="600px">
	<RadioCards.Root defaultValue="1" columns={{ initial: "1", sm: "3" }}>
		<RadioCards.Item value="1">
			<Flex direction="column" width="100%">
				<Text weight="bold">8-core CPU</Text>
				<Text>32 GB RAM</Text>
			</Flex>
		</RadioCards.Item>
		<RadioCards.Item value="2">
			<Flex direction="column" width="100%">
				<Text weight="bold">6-core CPU</Text>
				<Text>24 GB RAM</Text>
			</Flex>
		</RadioCards.Item>
		<RadioCards.Item value="3">
			<Flex direction="column" width="100%">
				<Text weight="bold">4-core CPU</Text>
				<Text>16 GB RAM</Text>
			</Flex>
		</RadioCards.Item>
	</RadioCards.Root>
</Box>

API 参考

¥API Reference

此组件继承了单选按钮组基础组件的属性并支持常用边距属性。

¥This component inherits props from the Radio Group primitive and supports common margin props.

根

¥Root

Prop	Type	Default
`asChild`	`boolean`	No default value
`size`	`Responsive<"1" \| "2" \| "3">`	`"2"`
`variant`	`"surface" \| "classic"`	`"surface"`
`color`	`enum`	No default value
`highContrast`	`boolean`	No default value
`columns`	`Responsive<enum \| string>`	`"repeat(auto-fit, minmax(160px, 1fr))"`
`gap`	`Responsive<enum \| string>`	`"4"`

项目

¥Item

组中可勾选的项目。

¥An item in the group that can be checked.

示例

¥Examples

尺寸

¥Size

使用 size 属性控制大小。

¥Use the size prop to control the size.

<Flex align="center" gap="3">
	<RadioCards.Root size="1">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root size="2">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root size="3">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>
</Flex>

变体

¥Variant

使用 variant 属性控制视觉样式。

¥Use the variant prop to control the visual style.

<Flex direction="column" gap="3" maxWidth="200px">
	<RadioCards.Root variant="surface">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root variant="classic">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>
</Flex>

颜色

¥Color

使用 color 属性指定特定的 color。

¥Use the color prop to assign a specific color.

<Flex direction="column" gap="3" maxWidth="200px">
	<RadioCards.Root defaultValue="1" color="indigo">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="cyan">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="orange">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="crimson">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>
</Flex>

高对比度

¥High-contrast

使用 highContrast 属性增加与背景的颜色对比度。

¥Use the highContrast prop to increase color contrast with the background.

<Grid columns="2" gap="3" display="inline-grid">
	<RadioCards.Root defaultValue="1" color="indigo">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="indigo" highContrast>
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="cyan">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="cyan" highContrast>
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="orange">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="orange" highContrast>
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="crimson">
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root defaultValue="1" color="crimson" highContrast>
		<RadioCards.Item value="1">8-core CPU</RadioCards.Item>
	</RadioCards.Root>
</Grid>

已禁用

¥Disabled

<Flex direction="column" gap="4" maxWidth="450px">
	<RadioCards.Root columns="2" defaultValue="2">
		<RadioCards.Item value="1">Off</RadioCards.Item>
		<RadioCards.Item value="2">On</RadioCards.Item>
	</RadioCards.Root>

	<RadioCards.Root columns="2" defaultValue="2">
		<RadioCards.Item value="1" disabled>
			Off
		</RadioCards.Item>
		<RadioCards.Item value="2" disabled>
			On
		</RadioCards.Item>
	</RadioCards.Root>
</Flex>

Previous单选按钮组

Next滚动区域

概览

主题

布局

排版

组件

实用工具

单选按钮卡片