Skip to content
Fix Overflow in react-native for Android
Objective-C Java JavaScript Python
Branch: master
Clone or download
sibelius Merge pull request #58 from jkdf2/patch-1
Add React Native v0.57+ notes to README
Latest commit 889f31a Sep 3, 2019


React Native Version Notice

This library will be useful for React Native versions below v0.57. For v0.57 and beyond, React Native supports Android overflow natively from this commit.


The problem is that a parent View in Android will clip the content of children Views (react-native)

This solves the problem of Overflow on Android (check this

This could make code simpler, so you don't need to move some Components outside parents to make layout work

You can read more about the motivation and this package here

Getting started

$ npm install react-native-view-overflow --save

Mostly automatic installation

$ react-native link react-native-view-overflow


import ViewOverflow from 'react-native-view-overflow';

    <ComponentToEnableOverflow />

Usage with Flatlist

To make this work with FlatList and related components you need to replace CellRendererComponent with ViewOverflow, for example:

  keyExtractor={item =>}
  renderItem={({ item, index }) => (
      <ViewOverflow style={styles.item}>
      // item....

Usage with Animated Views

To make this work in place of an Animated.View, you need to use Animated.createAnimatedComponent to create an animatable version of ViewOverflow. For example:

import ViewOverflow from 'react-native-view-overflow';
const AnimatedViewOverflow = Animated.createAnimatedComponent(ViewOverflow);

You can then use AnimatedViewOverflow in place of Animated.View.

Manual installation

  1. Open up android/app/src/main/java/[...]/
  • Add import com.entria.views.RNViewOverflowPackage; to the imports at the top of the file
  • Add new RNViewOverflowPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
    include ':react-native-view-overflow'
    project(':react-native-view-overflow').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-view-overflow/android')
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
      compile project(':react-native-view-overflow')
You can’t perform that action at this time.