# View properties ## Visual ### Size #### Default view size By default, the view element is sized to match a specific device's screen dimensions. You can select a device model from a dropdown to use its screen resolution as the canvas dimensions in the editor. #### Builder width Shows the width of the currently selected view size as a pixel value. #### Min height (px) Shows the minimum height of the currently selected view size. ### Layout #### Container layout Defines how the container element positions and arranges its child elements. You can choose a layout type (such as column, row, align, or fixed), control alignment behavior, and configure spacing. This includes properties for gap (space between child elements), padding (internal spacing), and margin (external spacing). Layout settings determine how the element behaves responsively and how it interacts with surrounding elements. #### Column Arranges child elements vertically, stacking them from top to bottom by default. You can change the You can control vertical order, horizontal alignment, spacing between items (gap), and whether elements stretch to fill the available width. #### Row Arranges child elements horizontally, placing them side by side from left to right. You can control horizontal order, vertical alignment, spacing between items (gap), and whether elements stretch to fill the available height. #### Fixed Positions child elements using explicit X and Y coordinates. Elements are placed at fixed pixel positions within the container. This layout does not automatically adjust based on content flow and offers the least responsive flexibility. #### Alignment

This setting applies to **column/row layouts**. Column and row layouts support different alignment modes that control how child elements are positioned along the main and cross axes. #### Top/left (start) Aligns child elements to the start of the container. * In a column layout, elements align to the top. * In a row layout, elements align to the left. #### Center Aligns child elements to the center of the container along the relevant axis. * In a column layout, elements are centered horizontally. * In a row layout, elements are centered vertically. #### Right/bottom (end) Aligns child elements to the end of the container. * In a column layout, elements align to the bottom. * In a row layout, elements align to the right. #### Space between Distributes child elements evenly, with equal space between them and no extra space at the edges of the container. #### Space around Distributes child elements evenly, with equal space around each element. This results in half-sized spacing at the container’s edges compared to the space between elements. #### Element position Moves the element to a different position in the hierarchy. The hierarchy is contained within the element's container (a container element or the page). * **Make first:** Sets the element as the first element in the hierarchy. * **Move up:** Moves the element one position higher in the hierarchy. * **Move down:** Moves the element one position lower in the hierarchy. * **Make last:** Sets the element as the first element in the hierarchy. #### Spacing #### Gap (column and row layout) Defines the space between child elements inside a container. The gap is applied between items in a column or row layout. It does not add space before the first element or after the last element — only between siblings. * In a **column layout**, the gap controls vertical spacing. * In a **row layout**, it controls horizontal spacing. {% hint style="info" %} If child elements also have margins, **the gap and margin values are cumulative**. For example, a container with a 10 px gap and a child element with a 10 px margin between items will result in 20 px of total space between those elements. {% endhint %} ### Configure #### View type The view element has four different view types:

View Type	Description
Scrollable	The default view type. Allows vertical scrolling.
Non-scrollable	A fixed-height view. Content is limited to the screen size.
Vertical list	A scrollable list of repeating content.
Section list	A grouped list (e.g., contacts grouped by first letter).

#### Page folder Defines which folder the view is stored in. {% hint style="info" %} Page folders help you organize and categorize pages, views and reusable elements in the editor. They're **purely for structure and clarity during development** and **have no effect on how the app behaves at runtime**. {% endhint %} #### Screen

Property	Description
Show safe area	When enabled, the view's content is inset to avoid the device's top and bottom safe area — the screen regions reserved for system UI elements.
Show status bar	When enabled, the device's status bar is visible while this view is active. The status bar displays system information such as the time, battery level, and network status.

Property

Description

Show safe area

When enabled, the view's content is inset to avoid the device's top and bottom safe area — the screen regions reserved for system UI elements.

Show status bar

When enabled, the device's status bar is visible while this view is active. The status bar displays system information such as the time, battery level, and network status.

#### Navigation

Property	Description
Show top app bar	When enabled, the top app bar is visible while this view is active. The top app bar displays the view's title and navigation controls.
Show tab bar	When enabled, the tab bar is visible while this view is active. The tab bar appears at the bottom of the screen and lets users navigate between the app's main views.
Include as tab item	When enabled, this view is included as an item in the tab bar.

{% hint style="info" %} **Include as tab item:** enabling *Include as tab item* automatically enables *Show tab bar*. You can't enable *Show tab bar* independently. {% endhint %} ### Properties Each view can hold custom properties that are accessible from workflows. * The properties must be set in the **element property editor**. * You can assign a **label** and a **default value** to each property. * You can **assign values** to the property using the [*Set current view's property*](/core-resources/bubble-workflows/bubble-actions/native-mobile-actions.md#set-property-of-current-view) action.

Property Type	Use
Dynamic value	Can hold any data type or thing.
Color picker	Accepts hex codes or saved color variables.
Checkbox	A yes/no value (true/false).

### Style Style sets the visual design of the element, including properties such as colors, fonts, borders, shadows and other appearance settings. Styles are shared across elements. When multiple elements use the same style, updating the style will automatically update all elements that reference it. #### Style selector

Select the style to apply to the selected element. #### Edit style

To edit the style, click the edit style icon. The changes to that style will apply to all elements using that style. #### **Detach style** Detaching the style will disconnect the element from the current style, but keep the formatting of the style until you make changes to it. This only affects the selected element.

#### **Overriden styles** You can override a style on one or more elements, using the defined style properties but allowing you to make individual changes to styling properties that apply only to the selected element(s). Overridden styles will be marked with an *Overridden labelI.*

You can reset the selected element's style by clicking the *Reset* icon.

### Appearance The appearance section lets you control the opacity, rotation and radius (corner roundness) of the selected element(s). #### Opacity Opacity sets the transparency level of the selected element(s). At 100%, the element is fully opaque. At 0%, it is fully transparent (invisible).
* **Opacity affects child elements**: If applied to a container, all child elements inherit the same opacity level. * **Opacity does not collapse the element:** Even at 0%, the element still occupies space in the layout. Unlike hiding an element (using *This element is visible on page load*, a conditional visibility rule, or a hide/show action), opacity does not reduce the element’s width or height to zero. ### Background Sets the background of the selected element(s) as a color, gradient or image. #### Color Sets the background color in a hex value. You can also set the opacity of the border. Can be a static or the result of a dynamic expression. #### Gradient Sets a gradient color, ranging from a start color and an end color, with an optional mid color.

Linear gradient

A linear gradient is a background effect where colors transition gradually along a straight line. The gradient follows a defined direction (for example, top to bottom, left to right, or at a specific angle). Instead of a single solid color, the element displays a smooth blend between two or more colors across that line.

Starting point	Description
Top	The gradient begins at the top and transitions downward.
Left	The gradient begins on the left side and transitions horizontally to the right.
Bottom	The gradient begins at the bottom and transitions upward.
Right	The gradient begins on the right side and transitions horizontally to the left.
Custom	Allows you to define a specific angle for the gradient direction.

Radial gradient

A radial gradient is a background effect where colors transition outward from a central point. Instead of following a straight line (like a linear gradient), the color spreads in a circular or elliptical shape from the center to the edges. #### Radial gradient types

Type	Description
Circle	The gradient expands evenly in all directions from the center, forming a perfect circle.
Ellipse	The gradient expands in an oval shape, stretching more in one direction based on the element’s width and height.

#### Radial gradient expansion Define how far the radial gradient extends from its center point. They control which edge or corner of the element determines the gradient’s final size, affecting how quickly the color transition spreads across the element.

| Option | Description | | --------------- | ----------------------------------------------------------------------------------------- | | Closest side | The gradient expands from the center until it reaches the nearest side of the element. | | Closest corner | The gradient expands from the center until it reaches the nearest corner of the element. | | Farthest side | The gradient expands from the center until it reaches the farthest side of the element. | | Farthest corner | The gradient expands from the center until it reaches the farthest corner of the element. | #### Stops Sets the start and end point of the radial gradient. By default, it has a *Start* and *End.* Optionally, you can add an intermediate point by clicking the + symbol next to *Stops.*

#### Image Sets an image as the element's background. The image can be a static file uploaded directly in the editor, or the result of a dynamic expression. **Upload** Upload a static image file to use as the background. **Make dynamic** Click the + icon to define a dynamic expression that returns the image to use as the background. ## Interaction ### Options #### Disable zooming When enabled, the user can't pinch-to-zoom in the current view. ### Transitions Transitions add animation when a style property changes. Instead of updating instantly, the element gradually shifts from its previous state to the new one over a defined duration. For example, if you reduce an element’s width, a transition can make it smoothly shrink rather than change size immediately.

Transition styles

Transition style	Description
ease	Starts slowly, speeds up in the middle, and slows down at the end.
ease-in	Starts slowly and accelerates toward the end.
ease-out	Starts quickly and decelerates toward the end.
ease-in-out	Starts slowly, accelerates in the middle, and slows down again at the end.
linear	Moves at a constant speed from start to finish.
step-start	Jumps immediately to the end state at the start of the transition.
step-end	Remains in the start state and jumps to the end state at the very end of the transition.

#### Transition duration Transition duration defines how long the transition animation runs, measured in milliseconds. ### Advanced #### Time zone selection {% hint style="info" %} This property requires that you check the *Enable timezone override controls* and *Page* checkboxes under *Settings – General*. {% endhint %} Overrides the default browser-based time zone for this page. All date and time elements on the page will use the selected time zone. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://manual.bubble.io/core-resources/bubble-elements/element-properties/native-mobile-element-properties/the-view-element/view-properties.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.