Skip to content

Latest commit

 

History

History

box

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

Box

npm (scoped)

Overview

Box is a polymorphic component that renders a given component depending on the provided props. For example, providing the href prop can indicate Box should be rendered as an anchor tag. Providing the as prop indicates that Box should be rendered as the component referenced by as. By default, Box will render as the HTML element div.

This can be useful for simplifying components that are repetitively used, but need different behaviors.

Installation

Yarn

yarn add @leafygreen-ui/box

NPM

npm install @leafygreen-ui/box

Example

import Box from '@leafygreen-ui/box';

<Box href="https://mongodb.design">I shall render as a link</Box>;

Output HTML

<a href="https://mongodb.design">I shall render as a link</a>

Properties

Prop Type Description Default
as React.ElementType The component or HTML tag to be rendered by the <Box /> component. Note: This will supersede the behavior of any other props. div
href string When provided, <Box /> will render an anchor tag with this href value.
children React.ReactElement Content to be rendered in an HTML element, or provided as a prop to the rendered component
... native attributes of component passed to as prop Any other properties will be spread on the rendered HTML element or component.