import * as React from 'react'; import {cornerShapeStencil, createComponent} from '@workday/canvas-kit-react/common'; import {BoxProps, mergeStyles} from '@workday/canvas-kit-react/layout'; import {createStencil, cssVar, px2rem} from '@workday/canvas-kit-styling'; import {system} from '@workday/canvas-tokens-web'; import {CardBody} from './CardBody'; import {CardHeading} from './CardHeading'; export interface CardProps extends BoxProps { /** * Children of the Card. Should contain a `` and an optional `` */ children?: React.ReactNode; /** * The variant of the Card. Can be `alt`, `tonal` or default. * @default 'default' */ variant?: 'alt' | 'tonal'; } // .cnvs-card export const cardStencil = createStencil({ extends: cornerShapeStencil, vars: { background: '', }, base: ({background}) => ({ [cornerShapeStencil.vars.shape]: system.legacy.shape.xxl, display: 'flex', flexDirection: 'column', gap: system.legacy.padding.sm, padding: system.legacy.padding.xl, background: cssVar(background, system.legacy.color.surface.default), border: `${px2rem(1)} solid ${system.legacy.color.border.default}`, }), modifiers: { variant: { tonal: ({background}) => ({ background: cssVar(background, system.legacy.color.surface.alt.strong), borderColor: system.color.border.transparent, }), alt: ({background}) => ({ background: cssVar(background, system.sana.color.surface.elevated), borderColor: system.sana.color.border.elevated, }), }, }, }); /** * `Card` is a container component that holds a {@link CardBody Card.Body} and an optional * {@link CardHeading Card.Heading}. `Card` wraps a non-semantic `div` element. The element can be * replaced using the `as` prop, or a `role` or other `aria-*` attributes can be added to give * `Card` semantic meaning. * * **Note**: Changing the `Card` container to certain semantic elements will put accessibility at * risk. For example, using the `as` prop to change the cards to buttons will flatten the content in * the card. Headings, calls to action, etc. will not function as expected for users with * disabilities. Semantic container elements like `
`, or using `
  • ` grouped together in a * common `
      ` can be a useful way to elevate the accessibility of your design. */ export const Card = createComponent('div')({ displayName: 'Card', Component: ({children, variant, ...elemProps}: CardProps, ref, Element) => { return ( {children} ); }, subComponents: { /** * `Card.Heading` is an optional subcomponent that is meant to describe the Card. Since `Card` * is a non-semantic presentational component, `Card.Heading` does not automatically have any * semantic meaning. If your use case requires the Heading to label the Card, you must do so * manually. * * For example, {@link Modal} (which uses a `Card`) adds an `aria-labelledby` and a `role` to * the `Card`, as well as an `id` to the `Card.Heading`. * * ```tsx * * Card Title * Card Contents * * ``` * * `Card.Heading` defaults to an `

      ` element, but it can be changed using the `as` prop. */ Heading: CardHeading, /** * `Card.Body` is a non-semantic subcomponent that contains the body of the card. Attributes may * be added to give `Card.Body` semantic meaning. If `Card.Body` is brief (like in a short * dialog), it may be helpful to add an `aria-describedby` referencing the `id` of the * `Card.Body` to the `Card` container. */ Body: CardBody, }, });