使用法

Card は、CardBodyCardHeaderCardFooter などの便利な サブコンポーネント のセットを提供します(以下を参照)。

  1. import {
  2. Card,
  3. CardHeader,
  4. CardBody,
  5. CardFooter,
  6. __experimentalText as Text,
  7. __experimentalHeading as Heading,
  8. } from '@wordpress/components';
  9. function Example() {
  10. return (
  11. <Card>
  12. <CardHeader>
  13. <Heading level={ 4 }>Card Title</Heading>
  14. </CardHeader>
  15. <CardBody>
  16. <Text>Card Content</Text>
  17. </CardBody>
  18. <CardFooter>
  19. <Text>Card Footer</Text>
  20. </CardFooter>
  21. </Card>
  22. );
  23. }

プロパティ

elevation: number

スタイルシステムのエレベーションシステムに基づくエレベーションシャドウのサイズです。特定のコンテンツを強調表示するのに役立つ場合があります。詳細については、Elevationを確認してください。

  • 必須: いいえ
  • デフォルト: 0

isBorderless: boolean

境界線なしでレンダリングします。

  • 必須: いいえ
  • デフォルト: false

isRounded: boolean

角が丸い形でレンダリングします。

  • 必須: いいえ
  • デフォルト: true

size: string

コンポーネント内のパディングの量を決定します。

  • 必須: いいえ
  • デフォルト: medium
  • 許可される値: xSmallsmallmediumlarge

継承されたプロパティ

Card は、すべての Surface プロパティ を継承します。

サブコンポーネント

このコンポーネントは、さまざまなインターフェースを構成するために使用できるサブコンポーネントのコレクションを提供します。

サブコンポーネントの例

  1. import {
  2. Card,
  3. CardBody,
  4. CardDivider,
  5. CardFooter,
  6. CardHeader,
  7. CardMedia,
  8. } from '@wordpress/components';
  9. const Example = () => (
  10. <Card>
  11. <CardHeader>...</CardHeader>
  12. <CardBody>...</CardBody>
  13. <CardDivider />
  14. <CardBody>...</CardBody>
  15. <CardMedia>
  16. <img src="..." />
  17. </CardMedia>
  18. <CardFooter>...</CardFooter>
  19. </Card>
  20. );

コンテキスト

<Card /> のサブコンポーネントは、コンテキストを使用して <Card /> に接続されています。sizeisBorderless のような特定のプロパティは、一部のサブコンポーネントに渡されます。

次の例では、<CardBody />small のサイズでレンダリングされます:

  1. import { Card, CardBody } from '@wordpress/components';
  2. const Example = () => (
  3. <Card size="small">
  4. <CardBody>...</CardBody>
  5. </Card>
  6. );

これらのサブコンポーネントは柔軟性を持つように設計されています。コンテキストプロパティは、必要に応じてサブコンポーネントによってオーバーライドできます。次の例では、最後の <CardBody /> は指定されたサイズでレンダリングされます:

  1. import { Card, CardBody } from '@wordpress/components';
  2. const Example = () => (
  3. <Card size="small">
  4. <CardBody>...</CardBody>
  5. <CardBody>...</CardBody>
  6. <CardBody size="large">...</CardBody>
  7. </Card>
  8. );