Skip to content

React Native Image component which scales width or height automatically to keep the original aspect ratio

License

Notifications You must be signed in to change notification settings

ihor/react-native-scalable-image

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

React Native Scalable Image

React Native <Image/> component which scales width or height automatically to keep the aspect ratio. Is useful when you need to display an entire network image but don't know its size and can limit it only by width or height.

The following example creates an image which fits the full screen width and maximum height of 300:

import React from 'react';
import { Dimensions } from 'react-native';
import Image from 'react-native-scalable-image';

const image = <Image width={Dimensions.get('window').width} maxHeight={300} source={{uri: '<image uri>'}} />;

Install

npm install react-native-scalable-image --save

Usage

Specify width or height which may be calculated dynamically like in the example above. All other props are the same as in regular React Native <Image/> component.

props

name type default description
height number Calculated dynamically Image height
width number Calculated dynamically Image width
maxHeight number Number.MAX_VALUE Maximum image height
maxWidth number Number.MAX_VALUE Maximum image width