Fluid Transitions for React Navigation
chrfalch Merge pull request #106 from fram-x/Fix-104/RNScreensOnAndroid
Updated react-native-screens usage on Android
Latest commit 7063e23 Sep 24, 2018
Permalink
Failed to load latest commit information.
.vscode Added attach to packager as target. Aug 30, 2018
Examples Updated react-native-screens usage on Android Sep 24, 2018
android Updated react-native-screens usage on Android Sep 24, 2018
docs Updated directory references to reflect new folder structure. Aug 28, 2018
ios Updated with support for react-native-screens Sep 21, 2018
lib Updated react-native-screens usage on Android Sep 24, 2018
.babelrc Updated project with latest dependencies and simpler directory struct… Aug 28, 2018
.buckconfig Updated project with latest dependencies and simpler directory struct… Aug 28, 2018
.eslintrc Removed no-multi-comp Aug 29, 2018
.flowconfig Updated project with latest dependencies and simpler directory struct… Aug 28, 2018
.gitattributes Updated project with latest dependencies and simpler directory struct… Aug 28, 2018
.gitignore Updated project with latest dependencies and simpler directory struct… Aug 28, 2018
.watchmanconfig Updated project with latest dependencies and simpler directory struct… Aug 28, 2018
App.js Updated with support for react-native-screens Sep 21, 2018
LICENSE Readded license file Aug 28, 2018
README.md Update README.md Sep 5, 2018
app.json Updated project with latest dependencies and simpler directory struct… Aug 28, 2018
index.js Updated project with latest dependencies and simpler directory struct… Aug 28, 2018
package.json Updated with support for react-native-screens Sep 21, 2018
yarn.lock Updated with support for react-native-screens Sep 21, 2018

README.md

Fluid Transitions for React Navigation

Introduction

This project aims to implement a simple yet powerful set of constructs for building fluid transitions between elements when navigating with React Navigation.

The library is JavaScript only - no linking required.

Snack

The library implements a new navigator component called FluidNavigator with the same interface and routing configuration as the StackNavigator. The library has a component called Transition which can be used to build different types of transitions that will automatically be run when navigating between screens using the regular navigation actions.

The Navigator's API is identical to the StackNavigator except that it does not support a header component. It can easily be integrated with redux and your existing navigation setups.

Medium article
React Native Animation Challenge #1

Installation

To install the library into your project, run yarn or npm:

yarn add react-navigation-fluid-transitions

or

npm i -S react-navigation-fluid-transitions

Note on versions: react-navigation-fluid-transitions@0.2.x is compatible with react-navigation@2.0.x, while react-navigation-fluid-transitions@0.1.x is compatible with react-navigation@1.x. Future improvements and development will be on react-navigation-fluid-transitions@0.2.x.

Examples

Examples are included in the project and should be runnable from the root of the project folder.

To start the example run the following commands from the terminal:

npm i or yarn

To start the project run

react-native run-ios or react-native run-android

Shared Element Transitions

This example shows how two elements can be set up to automatically transition between each other when navigating between screens. A more detailed edition of this example can be found in the file SharedElements.js.

Note that a shared transition happens between two elements that looks the same. The library animates position and scale between the two hence using different styles and content between the two elements will result in strange transitions.

const Screen1 = (props) => (
  <View style={styles.container}>
    <Text>Screen 1</Text>
    <View style={styles.screen1}>
      <Transition shared='circle'>
        <View style={styles.circle}/>
      </Transition>
    </View>
    <Button
      title='Next'
      onPress={() => props.navigation.navigate('screen2')}
    />
  </View>
);

const Screen2 = (props) => (
  <View style={styles.container}>
    <Text>Screen 2</Text>
    <View style={styles.screen2}>
      <Transition shared='circle'>
        <View style={styles.circle2}/>
      </Transition>
    </View>
    <Button
      title='Back'
      onPress={() => props.navigation.goBack()}
    />
  </View>
);

const Navigator = FluidNavigator({
  screen1: { screen: Screen1 },
  screen2: { screen: Screen2 },
});

Transitions

The library also supports transitions for elements wrapped in the Transition component. You can provide appear/disappear transitions that will be animated during navigation.

The Transition element supports appear and disappear transitions (appear will be used if disappear is not set), and these can either be one of the predefined transitions - or functions where you provide your own transitions.

<Transition appear='scale' disappear='bottom'>
  <View style={styles.circle}/>
</Transition>

Transition Types

Name Description
scale Scales the element in and out
top Translates the element in/out from the top of the screen
bottom Translates the element in/out from the bottom of the screen
left Translates the element in/out from the left of the screen
right Translates the element in/out from the right of the screen
horizontal Translates the element in/out from the left/right of the screen
vertical Translates the element in/out from the top/bottom of the screen
flip Flips the element in/out

Custom transitions

It is easy to provide custom transitions - just add the transition function to your component's appear or disappear property. The following example creates a transition that will scale in from 88 times the original size of the wrapped component:

<Transition appear={myCustomTransitionFunction}>
  <View style={styles.circle}/>
</Transition>

myCustomTransitionFunction = (transitionInfo) => {
  const { progress, start, end } = transitionInfo;
  const scaleInterpolation = progress.interpolate({
    inputRange: [0, start, end, 1],
    outputRange: [88, 80, 1, 1],
  });
  return { transform: [{ scale: scaleInterpolation }] };
}

Read more about the parameters and functionality for building custom transitions.

API

FluidNavigator

Transition

Credit

Some of the concepts in the library builds on ideas from @lintonye's pull request and suggestion found here: Shared element transition #941.

Contributors

Christian Falch (@chrfalch), Yuuki Arisawa (@uk-ar), Joe Goodall (@joegoodall1), sonaye, David Chavez, muhaimincs, KingTayTay, pedrobullo, Nathan James, Filip Engberg, DadImScared

Sponsors

Fram X - a cross platform app company from Norway.