@styled-system/css

Styled System for the css prop

1npm i @styled-system/css

Styled System CSS lets you write style objects with responsive, theme-aware Styled System shortcuts.

1// usage with the css prop
2import React from 'react'
3import css from '@styled-system/css'
4
5const Beep = props =>
6  <div
7    {...props}
8    css={css({
9      fontSize: [4, 5, 6],
10      color: 'primary',
11    })}
12  />

1// usage with a styled HOC
2import styled from '@emotion/styled'
3import css from '@styled-system/css'
4
5const Boop = styled('div')(
6  css({
7    fontSize: [ 4, 5, 6 ],
8    color: 'primary',
9    bg: 'gray',
10    '&:hover': {
11      color: 'secondary',
12    },
13  })
14)

To make the css prop work with styled-components, babel-plugin-styled-components must be enabled.

Theme Keys

The following keys in your style object will work the same as Styled System props, pulling values from your theme object.

Property	Theme Key
fontFamily	fonts
fontSize	fontSizes
fontWeight	fontWeights
lineHeight	lineHeights
letterSpacing	letterSpacings
color	colors
backgroundColor, bg	colors
margin, m	space
marginTop, mt	space
marginRight, mr	space
marginBottom, mb	space
marginLeft, ml	space
marginX, mx	space
marginY, my	space
padding, p	space
paddingTop, pt	space
paddingRight, pr	space
paddingBottom, pb	space
paddingLeft, pl	space
paddingX, px	space
paddingY, py	space
top	space
bottom	space
left	space
right	space
border	borders
borderTop	borders
borderRight	borders
borderBottom	borders
borderLeft	borders
borderColor	colors
borderWidth	borderWidths
borderStyle	borderStyles
borderRadius	radii
boxShadow	shadows
textShadow	shadows
zIndex	zIndices
width	sizes
minWidth	sizes
maxWidth	sizes
height	sizes
minHeight	sizes
maxHeight	sizes
size	sizes

Responsive Arrays

All CSS properties accept arrays as values for responsive styles.

1<div
2  css={css({
3    fontSize: [ 4, 5, 6 ],
4  })}
5/>

In this example, fontSize accepts an array, picking up values from the theme.fontSizes scale, and borderBottom is passed through as plain CSS.

1<div
2  css={css({
3    // Styled System key
4    fontSize: [ 3, 4, 5 ],
5    // CSS property
6    borderBottom: '2px solid tomato',
7  })}
8/>

MIT License