All documentation

Docs ยท Projects

Background

View on GitHubSuggest an edit

The Background properties are used to add background effects for components.

From the properties of the component you can select:

  • Upload an image: From your computer.
  • Pick Datachip: You can pick an image as a datachip from the Datastore.
  • Colour: Sets the background colour of a component.
  • Blend mode: Sets how an element's background images should blend with each other and with the element's background color.
  • Image Repeat: Sets if/how a background image will be repeated. This property may have the following values:
SettingDescription
InitialSets this property to its default value.
No RepeatThe background image is not repeated. The image will only be shown once.
RepeatThe background image is repeated both vertically and horizontally.
Repeat XThe background image is repeated only horizontally.
Repeat YThe background image is repeated only vertically
RevertLets you 'undo' styles applied to a component, going back to the parent component.
RoundThe background image is repeated and squished or stretched to fill the space (no gaps).
SpaceThe background image is repeated as much as possible without clipping.
  • Image size: Specifies the size of the background images. This property may have the following values:
SettingDescription
AutoDefault value. The background image is displayed in its original size.
ContainResize the background image to make sure the image is fully visible.
CoverResize the background image to cover the entire container, even if it has to stretch the image or cut a little bit off one of the edges.
InheritInherits this property from its parent element.
InitialSets this property to its default value.
RevertLets you 'undo' styles applied to a component, going back to the parent component.
  • Image position: Sets the starting position of a background image.

The background of a component affects the entire area covered by that component, including any padding that may be defined. For example, If you set a background colour or image for the button component in an app, it will cover the entire button area, including the padding.