A common feature request from developers familiar with the web is background-image. To handle this use case, you can use the <ImageBackground> component, which has the same props as <Image>, and add whatever children to it you would like to layer on top of it.

You might not want to use <ImageBackground> in some cases, since the implementation is basic. Refer to <ImageBackground>'s source code for more insight, and create your own custom component when needed.

Note that you must specify some width and height style attributes.

Example

import React from "react"; import { ImageBackground, StyleSheet, Text, View } from "react-native"; const image = { uri: "https://reactjs.org/logo-og.png" }; const App = () => ( <View style={styles.container}> <ImageBackground source={image} style={styles.image}> <Text style={styles.text}>Inside</Text> </ImageBackground> </View> ); const styles = StyleSheet.create({ container: { flex: 1, flexDirection: "column" }, image: { flex: 1, resizeMode: "cover", justifyContent: "center" }, text: { color: "grey", fontSize: 30, fontWeight: "bold" } }); export default App;

---

Reference

Props

Inherits Image Props.

style

Type	Required
view styles	No

imageStyle

Type	Required
image styles	No

imageRef

Allows to set a reference to the inner Image component

Type	Required
Ref	No