react-toolbox/components/card
Javi Velasco 0cb8d8bdb2 Get rid of jsx extensions 🔮 2016-04-10 21:23:04 +02:00
..
Card.js Get rid of jsx extensions 🔮 2016-04-10 21:23:04 +02:00
CardActions.js Get rid of jsx extensions 🔮 2016-04-10 21:23:04 +02:00
CardMedia.js Get rid of jsx extensions 🔮 2016-04-10 21:23:04 +02:00
CardText.js Get rid of jsx extensions 🔮 2016-04-10 21:23:04 +02:00
CardTitle.js Get rid of jsx extensions 🔮 2016-04-10 21:23:04 +02:00
_config.scss Added !default to all config values as per #424 2016-04-02 00:47:39 +02:00
index.js Fixed docs component scope error and added card example 2015-11-24 00:53:00 -05:00
readme.md Cleaned up Card documentation. 2016-03-26 18:37:29 -04:00
style.scss Fix scss-lint errors 2015-12-20 17:57:04 +01:00

readme.md

Card

A Card is a piece of paper with unique related data that serves as an entry point to more detailed information. For example, a card could contain a photo, text, and a link about a single subject.

Cards are composed of multiple subcomponents in React Toolbox. You can combine each of the subcomponents to create all different Material Design Cards given in the spec.

import { Card, CardMedia, CardTitle, CardText, CardActions } from 'react-toolbox/lib/card';

const dummyText = 'Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry\'s standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.';

const TestCards = () => (
  <Card style={{width: '350px'}}>
    <CardTitle
      avatar="https://placeimg.com/80/80/animals"
      title="Avatar style title"
      subtitle="Subtitle here"
    />
    <CardMedia
      aspectRatio="wide"
      image="https://placeimg.com/800/450/nature"
    />
    <CardTitle
      title="Title goes here"
      subtitle="Subtitle here"
    />
    <CardText>{dummyText}</CardText>
    <CardActions>
      <Button label="Action 1" />
      <Button label="Action 2" />
    </CardActions>
  </Card>
);

return <TestCards />;

Card

The base card component. This acts as the main card container that all subcomponents are placed within.

Properties

Name Type Default Description
children Any Child components, usually Card subcomponents.
className String Additional class(es) for custom styling.
raised Boolean Increases the shadow depth to appear elevated.

CardTitle

A versatile title block that can be used in various places on the card, including the media area. This component can also display an avatar next to the title content.

Properties

Name Type Default Description
avatar String or Element A string URL or Element to specify an avatar in the left side of the title.
children String, Element or Array Children to pass through the component.
className String Additional class(es) for custom styling.
subtitle String Text used for the sub header of the card.
title String Text used for the title of the card.

CardMedia

Used for displaying media such as images or videos on a card. Can also be used with a solid background color instead of an image.

Properties

Name Type Default Description
aspectRatio enum('wide','square') Forces a 16:9 or 1:1 aspect ratio respectively. Unset, the media area will have a flexible height.
children Any Usually an image/video element or a <CardTitle> component.
className String Additional class(es) for custom styling.
color String Sets the background color
contentOverlay Boolean Creates a dark overlay underneath the child components.
image String, Element Can be used instead of children. Accepts an element or a URL string.

CardText

Basic card content container. Good for small descriptions or other supplementary text.

Properties

Name Type Default Description
children Any Children to pass through the component.
className String Additional class(es) for custom styling.

CardActions

This component is used as a container for supplemental card actions. Supplemental actions within the card are explicitly called out using icons, text, and UI controls, typically placed at the bottom of the card.

Properties

Name Type Default Description
children Any Children to pass through the component.
className String Additional class(es) for custom styling.