The ?Header? element, which can be referred to as ?App Bar?, is a dedicated app bar at top of the app canvas. It is used to display important app-related functions that the user is supposed to access and use frequently.
These important functions include branding, top-level navigation (For example: – home page icon, back button), interfaces to access most important functions, etc.
|When to use|
|The app bars and headers are very useful components to make the mobile app user-friendly and more interactive. Use the header component to place key controls such as in-app search box, home page icon, and other important functions that are used frequently. Also it is recommended to use static header component that remains on the same position irrespective of navigating to different pages.|
The “Header” element consists of the following properties:
- UI Configuration
For the “Header” element, you can configure the following UI properties:
|Tab||Property Name||Description||Mandatory||New Default Value||Visibility Rules|
|Basic||Reference Name||Specifies a unique name of the element. At the application level, an element is identified and managed by the reference name.||Yes||Footer 1|
|Basic||Visible||Allows you to define the default visibility of the UI element.||No||marked|
|Basic||Enable||Allows the user to enable/disable an element. You can decide whether the element needs to be clickable and usable.||No||marked|
|Basic||Scrollable||Allows you to configure the scrolling feature in the element.||No||marked|
|UI Properties||Styles||Allows you to select a specific style for the element from the list of pre-defined styles. The vDesigner module offers pre-defined styles that you can apply to the element||No||Default|
|UI Properties-Background||Type||Allows you to configure the element’s background. To configure the background, you can choose one of the following options:|
|UI Properties-Background||Color||Allows you to configure a color as the element’s background. If you click the Color tab, the Color box opens. To configure a color as the element’s background:|
–> In the Color box, click the left color box (), and a color canvas open.
–> On the canvas, on the horizontal bar, move the circle to select the color.
–> In the upper section, move the circle to select the tone of the color.
|No||#FFFFFF||when type = color|
|UI Properties-Background||Opacity||Opacity is the degree to which content behind an element is hidden, and is the opposite of transparency.||Yes||100 %|
|UI Properties-Background||Image||Allows you to configure an image as the element’s background. To configure the image as a background:|
–> In the Type area, click the Image tab, and the Image Source list appears.
–> In the Image Source list, you can choose one of the following options:
–> Assets Library
|No||None||If Type = Image|
|UI Properties-Background||Image URL||This box becomes visible after you select URL in the Image Source list. In the Image URL box, enter the image’s URL. The application will fetch the image from a URL-based location and then display it as the element’s background.||Yes||URL String||If “Image Source” = “URL”|
|UI Properties-Background||Select Assets||This box becomes visible after you select Assets Library in the Image Source list. This property allows you to configure an image as the element’s background from the Assets Manager module. To configure the image:|
–> In the Select Assets box, click the asset library icon (), and the Select Asset dialog box opens.
–> In the Select Asset dialog box, select an icon and then click Select, and you successfully configure the image as the background image.
|UI Properties-Background||Elevation||Allows you to configure the elevation of the background. The elevation is measured as the relative distance between two surfaces along the Z-axis.||No||0|
|UI Properties-Alignment & Spacing||Padding||Allows you to desirably define padding around each side of the element. It provides four different boxes to define the padding around the right, left, top, and bottom side of the element.||No||[0,0,0,0]|
|UI Properties-Alignment & Spacing||Horizontal Alignment||Allows you to horizontally align the child element in the footer. You can align the child element as follows:|
|UI Properties-Alignment & Spacing||Element Alignment||Click this list to align the element as follows:|
–> Top Right
–> Top Left
–> Bottom Right
–> Bottom Left
|UI Properties-Alignment & Spacing||Vertical Alignment||Allows you to vertically align the child element in the header element. You can align the child element as follows:|
–> Space Around
–> Space between
–> Space Evenly
|UI Properties-Shape & Decoration||Width Value||Enter the width of the element in the pixel unit or percentage unit.||No||100%|
|UI Properties-Shape & Decoration||Height Value||Enter the height of the element in the pixel unit.||No||64px|
|UI Properties-Shape & Decoration||X||Allows you to move the element along the X-axis; when the value increases, the element moves from left to right.||No||Show & Disable|
|UI Properties-Shape & Decoration||Y||Allows you to move the element along the Y-axis; when the value increases, the element moves from top to bottom.||No||Show & Disable|
|UI Properties-Shape & Decoration||Border Radius||Allows you to define the radius of any of the corners of the element. Defining the radius of the corner makes the corner of the element round.||No||Theme Variable (Border Radius)|