Understanding the Image Component in React Native

Understanding the Image Component in React Native

Images are an essential aspect of any mobile app. This tutorial will introduce you to the image component and show you how to use images in your React Native app. You will also learn how to create your own photo gallery!

Prerequisites to Create a React Native App

We will use the Expo CLI for this project. With Expo, developers can create React Native apps without all the frustrations that come with installing and configuring software dependencies such as Android Studio, Xcode, or all the other tools which are needed to develop and run a React Native app. If you want to learn more about Expo, check out our post on how Expo makes React Native app development easier.

  • React Native
    Easier React Native Development With Expo
    Wern Ancheta

If you don’t already have Expo CLI, first ensure you have Node.js installed. Then install the Expo CLI (command line interface) globally on your machine:

Then, use the expo command to initialize a new project

If you need to use images when testing, add them to the assets folder of the project. 

Add Images to a React Native App

To add images in the application, you first need to import the Image component from react-native The React Native image component allows you to display images from different sources, such as:

  • network images
  • static
  • temporary local images and 
  • local disk images ie. from the camera roll

To import the Image component, add it to the import statement at the top of app.js, as shown below.

Display Static Images

To display a static image, the first thing is to add is the image file in the assets folder of the project. Static images are loaded by providing the image path. The code for displaying a static image will look something like this:

Here is the result.

Displaying a static image in React Native

Displaying Web-Based Images or URI Data Images

Displaying an image from a network or web-based source is similar to displaying a static image. Within the Image component, use the source attribute and set the path of the image in an object with the uri key, as shown below. 

You’ll also need to to add the dimensions of the image with a style attribute, just like you would in HTML.  Here is the final result for both images.

Network image and static image

You can also display images via a data URI, in which case all the image data is actually encoded in the URI. This is only recommended for very small or dynamic images. For a URI-encoded image, you’ll provide the image data with a source attribute like source={{  uri:'data:image/png;base64,iVBOR...=='}}

Don’t forget that for network and URI-encoded images, you will need to manually specify the dimensions of your image.

Background Images

You can also use an image as the background for your screen. To do so, get a background image of your choice and add it to the assets folder. Next, import the ImageBackground component from react-native as shown below.

The ImageBackground component wraps and displays a background for whatever elements are inside it. In this case, we will replace the View tag with the ImageBackground tag and wrap it around all the content in the app.

Create a Photo Gallery

In this section, I’ll show you how to display a grid of photos in a FlatList. This component are used to display large quantities of scrollable content and can scroll horizontally or vertically. 

FlatLists use the renderItem prop to render each item in their input data. The renderItem prop is a function that takes an item from the data array and maps it to a React element.  Each item in the data needs a unique id, this is found in item.key by default, though you can specify another way to find or build the id by using the keyExtractor function prop.

We will use useState to append to an array of images. The useState hook can store any type of value: a number, a string, an array, an object, etc. Add the following code to app.js.

Note that you’ll need to have these images in the assets folder. 

Next, we’ll return a FlatList that renders those images:

We set up the FlatList element to use the images array as its data source. Then we defined a custom render function that takes an item in the images array and generates an Image component to display it. 

Here is the complete photo gallery:

photo gallery


As you have seen, working with images in React Native is very easy!

If you want to jump start your next React Native app, or to learn from a professionally-built app, check out the mobile app templates on CodeCanyon. CodeCanyon is an online marketplace that has hundreds of mobile app templates—for Android, iOS, React Native, and Ionic. You can save days, even months, of effort by using one of them.

CodeCanyon mobile app template bestsellers

If you have trouble deciding which template on CodeCanyon is right for you, these articles should help: 

  • App Templates
    22 Best Android App Templates of 2020
    Franc Lucas
  • iOS SDK
    19 Best iOS App Templates of 2020
    Daniel Strongin
  • Mobile App
    19 Best React Native App Templates of 2020 (Including 5 Free)
    Franc Lucas
  • Ionic
    15 Stunning Ionic App Templates and Ionic Themes
    Franc Lucas

Leave a Comment