1.2.0 • Published 1 year ago

react-styled-spacer v1.2.0

Weekly downloads
-
License
ISC
Repository
github
Last release
1 year ago

React Styled Spacer

A versatile spacing component used to represent whitespace in your layout for both React and React-Native.

Installation

npm i react-styled-spacer

Usage

While not a requirement, configuration is available through the styled-components library.

import Spacer from 'react-styled-spacer'
import { ThemeProvider } from 'styled-components'

const App = () => (
  const spacerConfig = createSpacerConfig({
    debug: false,
    multiplier: 1,
    default: 0
    custom: {
      small: 10,
      medium: 20,
    }
  })

  <ThemeProvider theme={{ ...spacerConfig }}>
    <h1>I have 20px below me</h1>
    {/* Any value can be used, will default to pixels */}
    <Spacer h={20} />
    <p>I have 20px above me</p>
    {/* Works with styled-components theming context */}
    <Spacer h="small" />
    <ul>
      {/* Will space between children if provided */}
      <Spacer h={20}>
        <li>I have 20px below me</li>
        <li>I have 20px below & above me</li>
        <li>I have 20px above me</li>
      </Spacer>
    </ul>
    {/* Will space around children instead if provided spaceAround */}
    <Spacer spaceAround h={20}>
      <p>I have 20 px below and above me</p>
    </Spacer>
  </ThemeProvider>
)

Spacer Props

Propertytyperequireddefaultdescription
hstring, numberfalse10pxSpecifies spacer height
wstring, numberfalse10pxSpecifies spacer width
growstring, numberfalseundefinedflex-grow property for flexbox use
shrinkstring, numberfalseundefinedflex-shrink property for flexbox use
spaceAroundbooleanfalsefalseSpaces around its children

createSpacerConfig params

Propertytyperequireddefaultdescription
customobjectfalse{}Maps the key to represent a value as w/h
debugbooleanfalsefalseShows spacers
defaultstring, numberfalse0Default value for height and width
multipliernumberfalse1Scaling multiplier applied to every spacer
1.2.0

1 year ago

1.1.1

1 year ago

1.1.0

1 year ago

1.1.2

1 year ago

1.0.4

2 years ago

1.0.3

3 years ago

1.0.2

3 years ago

1.0.1

3 years ago

1.0.0

3 years ago