Version: 0.63
ImageBackground
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 |