Skip to content

Responsive styles for react-native and react-native-web

License

Notifications You must be signed in to change notification settings

chrda81/rn-responsive-styles

 
 

Repository files navigation

React Native Responsive Styles

rn-responsive-styles
Create responsive styles for react-native and react-native-web with minimal rerenders

Current npm package version.

This library adds support for dynamic styling based on device size, it was built to replace inline dynamic styles for individual components.

This library builds a single stylesheet from the provided styles and conditionally returns them based on device size. It uses a custom version of React Native's useWindowDimensions so that it only re-renders when the device size passes over one of the breakpoints, instead of re-rendering on every pixel change.

Installation

yarn add rn-responsive-styles or npm install rn-responsive-styles --save

Demo

Demo of Responsive Styles

Usage

import { Text, View } from 'react-native'
import { CreateResponsiveStyle, DEVICE_SIZES } from 'rn-responsive-styles'

export default function App() {
  const { styles, deviceSize } = useStyles()

  return (
    <View style={styles('container')}>
      <Text style={styles('text')}>Device Size: {deviceSize}</Text>
    </View>
  )
}

const useStyles = CreateResponsiveStyle(
  {
    container: {
      flex: 1,
      backgroundColor: '#fff',
      alignItems: 'center',
      justifyContent: 'center',
    },
    text: {
      fontSize: 30,
      color: 'white',
    },
  },
  {
    [DEVICE_SIZES.EXTRA_LARGE_DEVICE]: {
      container: {
        backgroundColor: 'blue',
      },
    },
    [DEVICE_SIZES.SMALL_DEVICE]: {
      container: {
        backgroundColor: 'red',
      },
      text: {
        fontSize: 20,
      },
    },
  },
)

Options

The currently configured breakpoints are:

Size Value Breakpoints
extra small DEVICE_SIZES.EXTRA_SMALL_DEVICE width <= 540
small DEVICE_SIZES.SMALL_DEVICE 540 < width <= 768
medium DEVICE_SIZES.MEDIUM_DEVICE 768 < width <= 992
large DEVICE_SIZES.LARGE_DEVICE 992 < width <= 1200
extra large DEVICE_SIZES.EXTRA_LARGE_DEVICE 1200 < width

Right now there is no way to customize the breakpoint values, but I plan on adding that in the future.

About

Responsive styles for react-native and react-native-web

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 93.3%
  • JavaScript 6.7%