3.2.3 • Published 4 years ago

react-native-auto-image1 v3.2.3

Weekly downloads
-
License
MIT
Repository
github
Last release
4 years ago

react-native-auto-image

Inspired by vivaxy/react-native-auto-height-image

NPM Version NPM Downloads MIT License Conventional Commits Financial Contributors on Open Collective

This component provides you a simple way to load a remote image and automatically set Image crossAxisSize to the image dimension which fits the provided mainAxisSize.

ReactNative Image component needs users to set both mainAxisSize and crossAxisSize props.

Installation

yarn add react-native-auto-image

npm install react-native-auto-image

Usage

Use local or remote files:

import React, { Component } from 'react';
import AutoImage from 'react-native-auto-image';

import image from 'gallifrey-falls.png';

export default class Demo extends Component {
  render() {
    return (
      <View>

        <AutoImage
          mainAxisSize={100}
          mainAxis='horizontal'
          source={image}
        />

        <AutoImage
          mainAxisSize={100}
          mainAxis='vertical'
          source={{uri: 'http://placehold.it/350x150'}}
        />

      </View>
    );
  }
}

You can even specify fallback images for when the source fails to load:

import React, { Component } from 'react';
import AutoImage from 'react-native-auto-image';

import image from 'gallifrey-falls.png';

export default class Demo extends Component {
  render() {
    return (
      <AutoImage
        mainAxisSize={100}
        source={{uri: 'https://vivaxy.github.io/404'}}
        fallbackSource={image}
      />
    );
  }
}

Props

nametypeisRequireddefaultdescription
mainAxisSizenumberN/Aimage mainAxisSize to fit
mainAxis'horizontal''vertical'N/Amain axis
maxCrossAxisSizenumberInfinityimage max crossAxisSize
sourcenumber or objectN/Alocal (i.e. require/import) or remote image ({uri: '...'})
fallbackSourcenumber or objectN/Alocal (i.e. require/import) or remote image ({uri: '...'})
onCrossAxisSizeChangefunc(crossAxisSize) => {}called when updating image crossAxisSize, the argument crossAxisSize might be 0
animatedboolfalseUse Animated.Image instead of Image

Other image props except resizeMode are accepted.

Change Log

Change log

Contributing

Contributing

Licence

MIT