react_native / 0.66 / imagebackground.html /

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.

Reference

Props

Image Props

Inherits Image Props.

imageStyle

Type
Image Style

imageRef

Allows to set a reference to the inner Image component

Type
Ref

style

Type
View Style

© 2022 Facebook Inc.
Licensed under the Creative Commons Attribution 4.0 International Public License.
https://reactnative.dev/docs/imagebackground