react-native-magic-moving

MagicMoving

A novel transition animation between components.

1. Examples

Download the repository, cd the examples directory, and run it on simulator.

git clone [e-mail]:SmallStoneSK/react-native-magic-moving.git
cd examples
react-native run-ios      # for ios
react-native run-android  # for android

2. Basic Usage

At first, you should install react-native-magic-moving. Like this:

npm install react-native-magic-moving --save

Then, you can refer to the following example. At least, you should pass 4 properties to MagicMoving:

1. data: the dataSource for rendered list.
2. cardStyle: it will work on the list's card container.
3. renderCardContent: custom what you want to show in the card.
4. renderPopupLayerContent: custom what you want to show in the popup layer.

Note: each item in the data should have a image. Because it is the image source of popup layer banner image.

import React from 'react';
import {Text, Image, StyleSheet} from 'react-native';
import {MagicMoving} from 'react-native-magic-moving';

const mockedData = [
  {
    image: {uri: 'https://hellorfimg.zcool.cn/preview260/525525049.jpg'},
    content: 'card 0'
  },
  {
    image: {uri: 'https://hellorfimg.zcool.cn/preview260/267756197.jpg'},
    content: 'card 1'
  },
  {
    image: {uri: 'https://hellorfimg.zcool.cn/preview260/409679020.jpg'},
    content: 'card 2'
  },
  {
    image: {uri: 'https://hellorfimg.zcool.cn/preview260/682966966.jpg'},
    content: 'card 3'
  }
];

export class Demo extends React.Component {

  _renderCardContent = (item, index) => {
    return <Image style={styles.cardImage} source={item.image}/>;
  };

  _renderPopupLayerContent = (item, index) => {
    return <Text>{item.content}</Text>;
  };

  render() {
    return (
      <MagicMoving
        data={mockedData}
        cardStyle={styles.cardContainer}
        renderCardContent={this._renderCardContent}
        renderPopupLayerContent={this._renderPopupLayerContent}
      />
    );
  }
}

const styles = StyleSheet.create({
  cardContainer: {
    marginTop: 20,
    marginHorizontal: 20
  },
  cardImage: {
    width: 335,
    height: 200
  }
});

In the example above, the content of popup layer is ready before it shows. If you want to read it asynchronously from the network, you can see the demo2 (click here).

In fact, you can do much things as MagicMoving offers 3 methods for you: onPopupLayerWillShow, onPopupLayerDidShow, onPopupLayerDidHide.

3. Properties

Prop	Default	Type	Description
style	-	object	allow custom list
cardStyle	-	object	allow custom list card
data	[]	array	data source of list
openDuration	300	number	duration of showing popup layer animation
closeDuration	300	number	duration of closing popup layer animation
renderCardContent	-	function	complete control how to render the content of list card
renderPopupLayerContent	-	function	complete control how to render the content of popup layer
renderPopupLayerBanner	-	function	you can custom the popup layer's banner using this function with params(bannerImageStyle)
onPopupLayerWillShow	-	function	be called before popup layer showing
onPopupLayerDidShow	-	function	be called after popup layer has shown
onPopupLayerDidHide	-	function	be called after popup layer has hidden