import * as React from "react"; import { cardBase, cardHeaderImage, headerHeight, cardContent } from "../style"; import { cx } from "@emotion/css"; import { preserveAspectRatio, padding } from "../../shared/styles/styleUtils"; import { SpaceSize } from "../../shared/styles/styleUtils/modifiers/modifierUtils"; export enum HeaderSizes { S = "s", M = "m", L = "l" } export interface CardProps extends React.HTMLProps { /** * `[width, height]` Keeps the card's width and height at a specific proportion. e.g.: 2:1 would be [2, 1] */ aspectRatio?: [number, number]; /** * The padding between the border and the content. Can be set for all viewport sizes, or configured to have different values at different viewport width breakpoints */ paddingSize?: SpaceSize; children?: React.ReactNode | string; /** * The card header will be set to the top section of the card optionally. Set a header image along with corresponding alt text. Size can be set to "s", "m", or "l" to increase the header height. */ header?: { /** * The header image will appear as a background image. */ headerImg: string; /** * Alt text can provide additional context for the image for screen readers, if it is not provided it will default to an empty string indicating to the screen reader to not announce the image. */ headerImgAltText?: string | undefined; /** * Size can be set to "s", "m", or "l" to increase the header height. If not specified, size will default to medium. */ size?: HeaderSizes; /** * Allows custom header styling */ className?: string; }; /** * Allows custom styling */ className?: string; /** * Human-readable selector used for writing tests */ "data-cy"?: string; } const Card = ({ className, children, aspectRatio, paddingSize = "m", header, "data-cy": dataCy = "card", ...other }: CardProps) => { const headerSize = header?.size || HeaderSizes.M; const aspectRatioStyle = aspectRatio ? preserveAspectRatio(aspectRatio[0], aspectRatio[1]) : null; return (
{header?.headerImg && (
{header.headerImgAltText
)}
{children}
); }; export default React.memo(Card);