Image control in Power Apps
A control that shows an image from, for example, a local file or a data source.
Description
If you add one or more Image controls to your app, you can show individual images that aren't part of a data set, or you can incorporate images from records in data sources.
Key properties
Image – The name or the URL of the image that appears in an image, audio, or microphone control.
Note
- Use HTTPS for all external images to ensure compatibility with modern browsers.
- External images must be accessible anonymously (without any authentication).
Additional properties
AccessibleLabel – Label for screen readers.
ApplyEXIFOrientation – Whether to automatically apply the orientation specified in the EXIF data embedded with the image.
AutoDisableOnSelect – Automatically disables the control while the OnSelect behavior is executing.
BorderColor – The color of a control's border.
BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.
BorderThickness – The thickness of a control's border.
CalculateOriginalDimensions – Enables the OriginalHeight and OriginalWidth properties.
DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).
DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.
DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.
Fill – The background color of a control.
FlipHorizontal – Whether to flip the image horizontally before displaying it.
FlipVertical – Whether to flip the image vertically before displaying it.
FocusedBorderColor – The color of a control's border when the control is focused.
FocusedBorderThickness – The thickness of a control's border when the control is focused.
Height – The distance between a control's top and bottom edges.
HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.
HoverFill – The background color of a control when the user keeps the mouse pointer on it.
ImagePosition – The position (Fill, Fit, Stretch, Tile, or Center) of an image in a screen or a control if it isn't the same size as the image.
ImageRotation – How to rotate the image before displaying it. Values can be none, clockwise (CW) 90 degrees, counter-clockwise (CCW) 90 degrees and clockwise 180 degrees.
OnSelect – Actions to perform when the user taps or clicks a control.
OriginalHeight – Original height of an image, enabled with the CalculateOriginalDimensions property.
OriginalWidth – Original width of an image, enabled with the CalculateOriginalDimensions property.
PaddingBottom – The distance between text in a control and the bottom edge of that control.
PaddingLeft – The distance between text in a control and the left edge of that control.
PaddingRight – The distance between text in a control and the right edge of that control.
PaddingTop – The distance between text in a control and the top edge of that control.
PressedBorderColor – The color of a control's border when the user taps or clicks that control.
PressedFill – The background color of a control when the user taps or clicks that control.
RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.
RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.
RadiusTopLeft – The degree to which the top-left corner of a control is rounded.
RadiusTopRight – The degree to which the top-right corner of a control is rounded.
TabIndex – Keyboard navigation order in relation to other controls.
Tooltip – Explanatory text that appears when the user hovers over a control.
Transparency – The degree to which controls behind an image remain visible. Decimal values range from 0 to 1. Where 0 is opaque, 0.5 is semi-transparent and 1 is transparent.
Visible – Whether a control appears or is hidden.
Width – The distance between a control's left and right edges.
X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).
Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).
Related functions
Remove( DataSource, ThisItem )
Examples
Show an image from a local file
On the File menu, click or tap Media, and then click or tap Browse.
Click or tap the image file that you want to add, click or tap Open, and then press Esc to return to the default workspace.
Add an Image control, and set its Image property to the name of the file that you added.
Don't know how to add and configure a control?
The Image control shows the image that you specified.
Show a set of images from a data source
Download this Excel file, and save it on your local device.
In Power Apps Studio, create or open an app, and then click or tap Add data source in the right-hand pane.
If Add data source doesn't appear in the right-hand pane, click or tap a screen in the left navigation bar.
Click or tap Add static data to your app, click or tap the Excel file that you downloaded, and then click or tap Open.
Select the Flooring Estimates check box, and then click or tap Connect.
Add a Gallery control with images, and set its Items property to FlooringEstimates.
Don't know how to add and configure a control?
The Gallery control shows images of carpet, hardwood, and tile products based on links in the Excel file that you downloaded.
Accessibility guidelines
Color contrast
- Standard color contrast requirements apply, if the graphic is used as a button.
- Consider checking for contrast issues within the image, if it is not purely decorative.
Screen reader support
AccessibleLabel must be set for important graphics.
If the graphic is for decoration or provides redundant information, leave AccessibleLabel empty or set it to the empty string "" . Screen readers will ignore these graphics.
For example, you might place an Image of a padlock next to a Label that says This form cannot be modified. You don't need an AccessibleLabel for the image because the Label already explains its meaning.
Important
When TabIndex is zero or greater, the Image becomes a button. Its appearance doesn't change, but screen readers will treat it as a button. They will not ignore the control, even if AccessibleLabel is empty.
Keyboard support
TabIndex must be zero or greater, if the graphic is used as a button. Keyboard users can then navigate to it.
Focus indicators must be clearly visible, if the graphic is used as a button. Use FocusedBorderColor and FocusedBorderThickness to achieve this result.