react-native-spacer-view

A little helper view to give you granular control over your layouts.

---

Installation

yarn add react-native-spacer-view

Note

This component depends on safe area insets provided by react-native-safe-area-context. If you don't have this library installed, you'll need to add it and wrap the root of your app in SafeAreaProvider.

API

Extends ViewProps. Note that view props are applied last, so they will take precendence over Spacer's props. For example, if you pass flex={2} and style={{ flex: 5 }}, the flex: 5 will win out.

All props are optional.

Prop	Type	Description
height	number	Adds to total height of Spacer.
width	number	Adds to total width of Spacer.
safeTop	boolean	Adds the device's top safe area inset to the total height of Spacer.
safeBottom	boolean	Adds the device's bottom safe area inset to the total height of Spacer.
flex	true or number	Passing true gives Spacer flex: 1, passing a number gives Spacer flex: [number].

Usage

import { ScrollView } from 'react-native';
import { Spacer } from 'react-native-spacer-view';
import { Content, Footer, Header } from './components';

export function MyNeatScreen() {
  return (
    <ScrollView>
      <Spacer safeTop height={16} />
      <Header />
      <Spacer height={16} />
      <Content />
      <Spacer height={16} />
      <Footer />
      <Spacer safeBottom height={24} />
    </ScrollView>
  );
}

Example App

You can run an example implementation of how you might use Spacer in a FlatList by cloning this repo and running the following commands:

cd example
yarn
yarn ios (or yarn android)

License

MIT

---

Made with create-react-native-library