Repeater
Platforms | Mobile apps |
Operating Systems |
The Repeater component is a container component that allows you to build layouts in an efficient and effective manner while using dynamic data through an array. It consists of two components, the Repeater and the Repeater Item (its main child component), which represents the structure that is repeated a specific number of times.
The number of times the item is repeated depends on the information configured in the array it invokes - that is to say, depending on the array data and the app user, the repeater may show different information in the published app. As opposed to other components used to create layouts, the repeater allows you to list elements using the same structure in a repetitive way and use arrays.
The dinamic feature of the repeater refers to the fact that it allows you to configure only one structure and show different information for each user of the app. This results from the use of an array, that contains configured information that allows you to customize the information shown to each user according to their profile. The customized information may refer to differences in the logic or the appearance of the data. In addition, if you need to make changes to the information shown in the app, the changes must be applied to the array and you won't need to modify the configuration of the repeater in the screens editor.
Depending on the project requirements, you can use one of the three structures that the repeater can have: grid, horizontal or vertical. For example, you can use the grid structure to create a main menu with the transactions that can be performed by the app user, the vertical structure to display the list of last transactions, or horizontal structure to display payment options with different means (for example, credit card or debit card).
Tip
You should only use a Repeater component if you need to trigger information from an array.
The main benefit of this component is that it makes building efficient where you need to repeat a structure and agile since it uses an array to dinamically add information to the structure. In addition, it simplifies the treeview, given that the main structure is configured once, and makes it easier to update the components whenever required, since you need to make the changes to only one structure.
To use the repeater in the screens editor, you have to add the Repeater component to the canvas and then add the Repeater Item component within the repeater. You only have to add and configure one Repeater Item component and, based on the configuration of both the Repeater and the Repeater Item, the rest of the grid will be drawn in the app.
Important
The Repeater component can only be added within a Panel or a Flex Container. As a best practice, add the repeater within a flex container to start building the screen.
The Repeater component contains characteristics similar than those of the data grid and the flex container components but has several differences related to their purpose and how they are build. First of all, the repeater is the only container component that can trigger information from an array. In addition, there are other differences identified:
Differences between flex container and repeater:
Flex Container
Repeater
Allows the building of a grid but does not allow the use of arrays.
Alows the building of a grid and can trigger information from an array.
Allows you to build flexible layouts to position different visual structures.
Repeats the same visual structure a specific number of times.
Differences between data grid and repeater:
Data Grid
Repeater
In the app screen, renders all the information without exception at the same time. In terms of efficiency, it takes more time for the information to appear on screen.
In the app screen, renders the information once the user scrolls to makes them visible. If compared to the data grid in terms of efficiency, it takes less time for the information to appear on screen.
Can only be configured vertically.
Can be configured vertically, horizontally and as a grid with a specific number of columns.
Enables the configuration of dynamic layouts using an array but cannot be displayed in grid format.
Enables the configuration of dynamic layouts using an array in grid format.
Since it does not allow the building of a grid, screen accessibility attributes do not work properly for screen readers.
Accessibility attributes work properly and the screen reader can read the information of each component within the grid in an organized manner (from top to bottom, from left to right).
As it is a container component, the repeater structure can only contain specific components as children components. First of all, the Repeater component can only contain a Repeater Item as child within it. Then, the Repeater Item can only contain certain components - some components can't be added to a repeater item and, if added, the app won't render them. Refer to the chart below to learn more.
Repeater Item can contain | Repeater Item cannot contain |
---|---|
Flex Container | Animated |
Text Label, | Barcode Scanner |
Image | Calendar Period |
Icon | Card Container |
ButtonDS | Data Grid |
CheckBoxDS | Data Table |
Switch DS Radio | DS Progress Indicator |
Map | |
Panel | |
Photo, | |
Text Input | |
Vertical Bar Chart | |
Video | |
Configured components |
How to use a repeater component in your app
This section includes a use case that explains how you should use and configure a repeater component to fulfill a request made by Goldbank, your client.
GoldBank asks you to redesign the services main menu within the app homepage. This request involves adding a new screen, with a grid menu that contains all the transactions (Pay with QR, Withdrawal, Transfer) that can be performed by the app users. In addition, GoldBank specified that the services that appear in the app will depend on the app user profile - the profile definition is made by the client. The background of the screen must be the same accross the entire app, a specific shade of grey (#eeeeee). but each transaction available must be shown on a white background and have rounded corners. Each transaction must contain an icon and a text representing the action that the user can execute.
For this example purposes, the use case will only give you instructions on how to build and configure the main menu of the screen, which contains the repeater component. Refer to the instructions below to learn more about how to configure the screen according to the client's requirements.
In this case, you should use the repeater component for two main reasons:
The repeater will allow you to set a grid menu with an organized and repetitive structure within it, and will allow screen readers to read the information set in the component in a proper manner (from top to bottom, from left to right).
The repeater will allow you to configure only one structure and trigger information from an array; the array will have dinamic information set, and based on that configuration, each user will see different information in the app based on their category. As a result, you won't need to configure one repeater structure per user category.
Once you get the information about the project requirements and the design of the screen, you must set the array that will contain the information to be consumed by the repeater component.
In the Overview, go to Branch Edition > Processes.
In the Lambda processes tab that opens, Click + New lambda process.
Configure the settings of the process:
In the Name field enter Enter Array_mainmenu .
In the Description field enter Array that contains the data that will appear in the main menu of the homepage.
In the On start block, start configuring the process:
Go to the blocks list and click Arrays.
Click Table and drag and drop the Save array with table block.
In the blank field, enter 1001, which represents the number that will identify the array when invoked from the screens editor.
In the save array block, enter the block array of and then add 7 more array of blocks, where you will add the information that represents the icons and text labels that will appear in the main menu of the app homepage.
Considering the information provided by the client, configure the fields of each row in the array. Information in the array is represented in columns. In this case, the first column represents the order of the data, the second represents the names of the transactions available for users, and the third represents the names that identify the icons that appear for each transaction. Enter the information as shown in the image below.
Important
Icons must be uploaded in the Assets section (Global Design > Assets) when the project begins. Then, they can be invoked by their name.
To learn more about lambda processes and how to configure them, read Lambda Processes .
Note
The array data invoked from the screens editor will appear on screen when the app is published. The information and icons won't be displayed in the screens editor.
Once you have defined the array, you can start working on the screen building process.
Go to the GoldBank app. In the Overview, click Screens.
Click + New screen to open the screens editor.
In the screens editor, go to the left panel and then go to the Info tab. Add a name to identify the screen, for example: Homepage_mainmenu, and a description including information about the purpose of the screen, for example: Screen that includes the transactions that users can perform in the app. In addition, add the sequence. You can also add tags to easily find the screen in the screens list in the future, for example: repeater and transactions main menu .
Click Save (diskette icon) to save the Info changes before editing the screen. The Commit message modal opens, where you have to enter a description informing why the screen was created or edited for the branch previously selected. You can also add the Jira ticket where the request was defined, if applicable. Then, click Save and continue.
As the best practice, you must add the parent flex container to the canvas and configure it. Within this flex container, you will add secondary flex containers that will represent the sections within the screen. In this case, you will add only one secondary flex container, where you will include the repeater component.
Go to the left panel and go to the Components tab. Type Flex Container in the search bar or find it in the list. Then, drag and drop it into the canvas to use it as a main flex to contain any other flex containers within it.
Go to the right panel and change the Name attribute to FlxParent.
Go to the position and alignment section. Delete the values in the X and Y attributes. In the W and H attributes, enter 100 and select % (percentage) as unit of measurement, so that the flex container covers the entire screen (both in length and width).
As required under the project's design, go to the Background section and enter a color for the flex container's background. In this case, enter #eeeeee, which is the hexadecimal code that represents the shade of grey defined for the app according to the client's requirements.
Tip
As a best practice, enter the hexadecimal code for the color required instead of selecting a color from the color picker.
Go to the Layout section. In the Children section, select Wrap so that, if the components within the flex container exceed its maximum width, they are placed below the rest of the components. Then, from the wrapping options that appear, select Start.
In the Direction subsection, select Column, so that the components within the flex run from the top to the bottom of the container.
In the Align subsection, select stretch, so that the components inside the flex container are aligned and stretch across the entire space of the container.
In the Justify subsection, select start, so that the components within the flex are placed at the top part of the container.
In the Children section, select Wrap so that, if the components within the flex container exceed its maximum width, they are placed below the rest of the components. Then, from the wrapping options that appear, select Start.
Go to the Size & Position section. In the Position type field, select Relative.
Tip
As a best practice, the parent flex container, secondary flex containers, and children components must have the Position Type defined in Relative. With the Relative positioning, children components are aligned one after the other according to the parent flex container layout (either in columns or rows). In addition, if the size of a child component is modified, relative positioning will allow all the children components to reorganize automatically, to avoid overlapping between them.
Configure the two first secondary first containers that will appear in the top section of the screen. The first flex container will contain a Hello! message for the app user and two icons, that, when clicked, allow the user to switch accounts or go to the homepage, respectively. For purposes of this example, the instructions below only explain how to add the first flex container but not its content. The second secondary flex container will then include the repeater component.
Go to the left panel and add a second flex container, that will include the welcome message and icons. Change the name to FlxTop.
Go to the position and alignment section. Enter 100 in the width (W) attribute and enter 17 in the height (H) attribute. For both attributes, select % as unit of measurement.
Go to the Spacing section. Enter 13 in the top paddingand 12 in the bottom padding. Then, enter 18 in the left and right padding.
Go to the left panel and add a third flex container, that will include the main menu. Change the name to FlxMenu.
Go to the position and alignment section. Enter 100 in the width (W) attribute and enter 65 in the height (H) attribute. For both attributes, select % as unit of measurement.
Go to the Spacing section. Enter 5 in the top margin and 8 in the bottom margin. Then, enter 10 in the bottom padding.
Go to the Border section and delete the number 1 that appears by default.
Go to the Layout section. In the Direction subsection, click Row. In the In the Align subsection, select center, In the Justify subsection, select Space Between. In the Children section, select Wrap and then Start.
Go to the Size & Position section. In the Position Type attribute, select Relative.
Configure the repeater that will set the structure of the grid that represents the main menu in the homepage.
Go to the left panel and go to the Components tab. Type Repeater in the search bar or find it in the list. Then, drag and drop it into the canvas to use it as the container and then add the repeater item within it.
Go to the right panel and change the name to RptrMain.
Go to the position and alignment section. Enter 100 in the width (W) attribute and enter 100 in the height (H) attribute. For both attributes, select % as unit of measurement.
Important
In the case of the Repeater component, configuring the height (H) is mandatory. Since the content in the repeater structure is dinamic, if the information in the repeater item occupies more space than the height defined, the component will automatically allow the user to scroll down without configuring other attributes. As a result, the app user will be able to scroll down to see all the data it contains.
Go to the Spacing section. Enter 10 in the top padding and 18 in the bottom padding, and 30 in the left and right paddings.
Note
The definition of margins and paddings depends on the design of the app and the specifications given by the app designers from the beginning of the project.
Go to the Layout section.
In the direction section, select Grid, so that the structure of the repeater is displayed as a grid menu.
In the Columns field, enter 3 so that the grid contains three columns.
In the Column Gap field, enter 8px, so that the gap between the three columns is 8px.
In the Row Gap field, enter 8px, so that the gap between the rows of the grid menu is 8px.
Note
Based on the configuration of the Spacing section, and the values entered in the Layout section, the repeater will display the number of items that fit in it, considering the space it has with regard to the flex container in which it is included.
Go to the Border section. In the Color field, enter the hexa code #192a60. In the Width field, enter 2 and leave the px unit of measurement selected.
Go to the Basic section. In the Array field, enter 1001, which is the id of the array that contains the information related to the transactions that will appear available in the grid menu of the app.
Go to the Size & Position section. In the Position type field, select Relative.
Configure the item that represents each of the items that will be included in the grid menu. This component must only be configured once, and, based on its configuration, the app will trigger the dynamic data as defined in the array invoked.
Go to the left panel and go to the Components tab. Type Repeater Item in the search bar or find it in the list. Then, drag and drop it into the repeater component.
Go to the right panel and change the name to RptrItem.
Go to the position and alignment section. Enter 29 in the height (H) attribute and select % as unit of measurement.
Now, you have to configure the two components that represent the transactions available in the grid menu: an icon and a text label. These components will invoke the array previously configured and display the data when the app is published. Additionally, given the purpose of the repeater, the rest of the elements within the repeater will also use the dynamic information specified in the array.
Important
You only need to configure one repeater item per repeater structure.
Configure the icon that will appear within the repeater item. In the app, the icon will include the image related to the transaction that the user can execute. The label will use the information obtained from the array defined.
Go to the left panel. Type Icon and drag and drop it inside the repeater item into the canvas.
Tip
Go to the Treeview tab to make sure that children components are correctly placed within each flex container.
Go to the position section. Delete the values in the X and Y fields. Enter 5 in the Y field and leave % as unit of measurement selected. Then, enter 25 in the width (W) attribute and enter 25 in the height (H) attribute and select px as unit of measurement.
Go to the Basic section. In the Icon field, enter #F{3}. This number represents the column in the array where the data must be obtained. Since the repeater item is placed in the first element of the repeater structure, the system will use the first value defined in the array in the third column (from top to bottom of the list). Then, the rest of the of the elements will show the information of the array according to their location within the repeater structure and the column specified. For example, the third element in the repeater structure will show the values set in the third row and third column of the array.
Go to the Size & Position section. In the Position Type attribute, select Relative.
Configure the label that will appear within the repeater item. In the app, the label will include the name of the transaction that the user can execute. The label will use the information obtained from the array defined. For example, Pay with QR.
Go to the left panel. Type Text label and drag and drop it inside the repeater item into the canvas.
Tip
Go to the Treeview tab to make sure that children components are correctly placed within each flex container.
Go to the right panel and change the name to TxtLabel.
Go to the position section. Delete the values in the X and Y fields. Enter 20 in the Y field and leave % as unit of measurement selected. Enter 100 in the width (W) attribute and select % as unit of measurement.
Go to the Basic section. In the Value field, enter #F{2}. This number represents the column in the array where the data must be obtained. The system will use the first value defined in the array in the third column (from top to bottom of the list).
Go to the Size & Position section. In the Position Type attribute, select Relative.
In the Margins & Alignment section, select center.
Go to the Text section. In the Font Size field, enter 10px. In the Font Family field select InterBlack. Then, go to the Color field, click the color picker and enter #4C4C4C in the Hexa field.
Attributes Specifications
Refer to the section below to learn more about all the right panel attributes that appear for configuration when you drag and drop the two components that must be used to configure a repeater into the canvas.
Important
This section is for information purposes only. Configure the attributes for the component according to your project's requirements.
Repeater
The sections below describe the sections available for confirmation for the Repeater component.
Important
For the repeater component, the only units of measurement that must be used in the right panel are % and px.
Design tab
Note
Alignment attributes cannot be configured.
First of all, you must change the name of the repeater to represent its position within the screen layout. For example, if it is the main repeater, the name can be Rptr_main.
Then, you can configure the position attributes, which affect the position of all the children components within it, as specified in the table below.
X | Position of the repeater in the canvas with regard to the x axis. Enter a number in the field and then select the % or px unit of measurement. |
Y | Position of the repeater in the canvas with regard to the x axis. Enter a number in the field and then select the % or px unit of measurement. |
R | Angle with the vertical axis in which the repeater is positioned. This attribute should not be configured for the repeater component. |
W | Width of the component with regard to the screen size. |
H | Height of the component with regard to the screen size. |
In the case of the repeater component, the Spacing section allows you to define the margin and padding properties.
Padding properties | Space between the component's border and the component's content (value). To configure the paddings, click the number field of each margin (left, right, top, bottom) and enter the desired value. Then, click the unit of measurement located to the right and select the px or % option from the list. |
Margin properties | Space around a component's border. To configure the margins, click the number field of each margin (left, right, top, bottom) and enter the desired value. Then, click the unit of measurement located to the right and select the px or % option from the list. |
Direction | Alignment of the structure of the repeater. The alignment will be represented by the repeater item included within it.
| ||||||
Columns | Number of columns in the repeater. The number depends on the type of direction selected. If you selected Grid direction, the number must be between 2 and 6. In the case of Horizontal or Vertical direction, this attribute appears grayed out: Horizontal does not have columns and Veritcal has 1 defined by default. | ||||||
Column Gap | Space between columns in the repeater. To configure it enter a number followed by the px or % unit of measurement. For example, 2px. This atribute is only avaialble if you selected Grid or Horizontal direction. | ||||||
Row Gap | Space between rows in the repeater. To configure it enter a number followed by the px or % unit of measurement. For example, 2px. This atribute is only avaialble if you selected Grid or Vertical direction. |
Flat | Click the Flat radio button to set a single color for the component's background. To set the color, click the field and type a hexa code or click the rounded-edges square icon to open the color picker. In the color picker, enter the hexa color code. You can also set the opacity percentage outside the color picker in the Opacity field. If you previously selected a color in the color picker, the opacity is set in 100 by default. If no color was selected, this field is empty. To modify it, click the field and enter the desired percentage. TipAs a best practice, if a color is already defined, the opacity field should not be modified. |
Gradient | Click the Gradient radio button to set a color gradient for the component's background. Click each of the rounded-edges square icons to open the color picker. In the color picker, enter the hexa color code in the Hexa field. Click to invert the order of the colors selected for the gradient. Click or to define the gradient's direction in horizontal or vertical position, respectively. |
Background Image | This atribute should not be used for the repeater component. |
Note
If you select the Flat background, you cannot choose the Gradient background and vice versa. The Background Image option is available in both cases.
To set all the borders of the component, click the chain link icon in the middle of the square. The chain appears unbroken and all the inner borders of the square turn blue.
To configure the attributes of borders individually, click the desired border of the square icon; the border selected turns blue and the chain link icon appears broken. Remember to configure attributes for each border you want to customize.
Then, you must set the color and width of the border or borders you want to configure. Refer to the table below to learn more.
Color | Border color. To set the color, click the field and type a hexa code or click the rounded-edges square icon to open the color picker. In the color picker, enter the hexa color code. |
Width | Border width. Type a number to set the width. To change the unit of measurement, click the ellipsis (three dots) and select an option from the drop-down menu. |
By default, all the component's corners appear selected. The chain appears unbroken and the dots representing each corner of the square turn blue. If you use this option, the same attributes will be applied to all corners.
To configure the attributes of corners individually, click the desired corner of the square icon; the dot in the selected corner turns blue. Remember to configure attributes for each corner you want to customize.
To increase or decrease the radius size of the borders or a specific border, type the value in the Radius field. To change the unit of measurement, click the unit of measurement selected (blue-colored text) and choose an option from the drop-down menu.
Array | Number that identifies the array that includes the data that will be included in the repeater structure. Enter the respective array number, that you defined when you created the lambda process. |
Selected Item Index | Attribute that defines where the selected item will be stored. Enter a register number. Then, when you invoke the register in any other attribute, the app user will be taken to the item selected. |
Visible | Attribute that defines whether the component is visible in the app. Click the arrow and choose an option from the drop-down menu. Select true so that the component is visible in the app or false so that it is not visible. This attribute is only applicable for mobile apps. |
Visibility | Attribute that defines whether the component is visible in the app. Click the arrow and choose an option from the drop-down menu. Select visible so that the component is visible in the app or none so that it is not visible. This attribute is only applicable for web apps. |
Important For Accessibility | Attribute that defines whether the screen reader reads or ignores the value defined in the Accessibility Text attribute of the component. Click the arrow and select an option from the drop-down menu. Choose true so that the screen reader reads the component or false so that the screen reader does not read the component. The default value is false. |
Accessibility Text | Alternative text. Add a short text to describe the component to users who may not be able to see it. The text will be read by iOS Voice Over or Android Talk Back. You can also add the accessibility text to the translations dictionary or select an existing translation if there are languages selected in your branch settings. |
Accessibility Order | Attribute that tells the screen reader the order in which it must read the components. To configure it, click the field and enter a number to define the order. For example, if this component should be read in third place, enter the value 3. If you don't configure a custom order, components are read from top to bottom and left to right of the screen. |
Tab Index | Order in which the cursor moves from one component to another and focuses on each component by pressing the TAB key on a keyboard. This attribute is only available for web apps. Click the field and enter a value. | ||||||
Position Type | Click the arrow and select a type from the drop-down menu. As a best practice, select Relative. Refer to the table below to learn more about the options available.
|
Z-Index | Property that defines the components' position order. If several components overlap, components with a higher Z-index will be placed over those with a lower index. This field is filled in automatically. |
Actions tab
In this section, you can set events or actions on the component that will be triggered by other certain actions. For example, if the action configured is "On Click", an event or action will be triggered when the app user clicks the component. Refer to the table below to learn more about each action.
On Click | Action involving clicking or tapping the component. |
On end reached | Action to be executed when the user scrolls down. This event enables infinite scroll. |
In all cases, to set the event or action, type the action to be triggered in the corresponding field or click the vertical three-dot icon. The Create new link window opens. Click the down arrow and select one of the link types available in the drop-down menu: View, SW States, Process, Lambda, Pop Up, Toggle, Event, Link, Mail, Module Screen or Interface Message. A new drop-down menu appears. Click the down arrow and select the action or event within the selected type. Then, complete the parameters applicable to the option selected. Once you configure the required parameters, click Accept.
Repeater Item
Design
Note
Alignment attributes cannot be configured.
First of all, you must change the name of the repeater to represent its position within the screen layout. For example, if it is the main repeater, the name can be Rptr_main.
Then, you can configure the position attributes, which affect the position of all the children components within it, as specified in the table below.
X | Position of the repeater in the canvas with regard to the x axis. Enter a number in the field and then select the % or px unit of measurement. |
Y | Position of the repeater in the canvas with regard to the x axis. Enter a number in the field and then select the % or px unit of measurement. |
R | Angle with the vertical axis in which the repeater is positioned. This attribute should not be configured for the repeater component. |
W | Width of the component with regard to the screen size. ImportantIf you build a repeater component with a grid structure, you must not configure the width since the component width is defined by the width of the Repeater and if configured, the value won't be considered. |
H | Height of the component with regard to the screen size. ImportantThe height defined in this attribute will depend on the height defined in the Repeater (parent component). For example, if you configure the repeater item height in 20%, and you previously configured the parent repeater height in 50px, the height of the item will be 20% over the 50px of the repeater. |
In the case of the Repeater Item component, the Spacing section only allows you to define the padding properties, since margins are defined by the Column Gap attribute defined in the Repeater (parent component).
Padding properties | Space between the component's border and the component's content (value). To configure the paddings, click the number field of each margin (left, right, top, bottom) and enter the desired value. Then, click the unit of measurement located to the right and select the px or % option from the list. |
Flat | Click the Flat radio button to set a single color for the component's background. To set the color, click the field and type a hexa code or click the rounded-edges square icon to open the color picker. In the color picker, enter the hexa color code. You can also set the opacity percentage outside the color picker in the Opacity field. If you previously selected a color in the color picker, the opacity is set in 100 by default. If no color was selected, this field is empty. To modify it, click the field and enter the desired percentage. TipAs a best practice, if a color is already defined, the opacity field should not be modified. |
Gradient | Click the Gradient radio button to set a color gradient for the component's background. Click each of the rounded-edges square icons to open the color picker. In the color picker, enter the hexa color code in the Hexa field. Click to invert the order of the colors selected for the gradient. Click or to define the gradient's direction in horizontal or vertical position, respectively. |
Background Image | This atribute should not be used for the repeater item component. |
Note
If you select the Flat background, you cannot choose the Gradient background and vice versa. The Background Image option is available in both cases.
To set all the borders of the component, click the chain link icon in the middle of the square. The chain appears unbroken and all the inner borders of the square turn blue.
To configure the attributes of borders individually, click the desired border of the square icon; the border selected turns blue and the chain link icon appears broken. Remember to configure attributes for each border you want to customize.
Then, you must set the color and width of the border or borders you want to configure. Refer to the table below to learn more.
Color | Border color. To set the color, click the field and type a hexa code or click the rounded-edges square icon to open the color picker. In the color picker, enter the hexa color code. |
Width | Border width. Type a number to set the width. To change the unit of measurement, click the ellipsis (three dots) and select an option from the drop-down menu. |
By default, all the component's corners appear selected. The chain appears unbroken and the dots representing each corner of the square turn blue. If you use this option, the same attributes will be applied to all corners.
To configure the attributes of corners individually, click the desired corner of the square icon; the dot in the selected corner turns blue. Remember to configure attributes for each corner you want to customize.
To increase or decrease the radius size of the borders or a specific border, type the value in the Radius field. To change the unit of measurement, click the unit of measurement selected (blue-colored text) and choose an option from the drop-down menu.
Direction | Direction of the item within the repeater. Click Row so that repeated items are organized in rows or click Column so that repeated items are organized in columns. You can also click the two-way arrows icon () to invert the order of the items. NoteThe Alignment and Justify options change depending on the Direction selected. |
Align | Alignment of the item within the repeater with regard to the container's space. If you selected Row in the Direction section, click an option to define the alignment of the items considering them as in a row. If you selected Column in the Direction section, click an option to define the alignment of the items considering them as in a column. The options available are: Start, center, End, stretch, baseline. |
Justify | Justification of the item within the repeater with regard to the container's space. The options available are: Start, center, End, Space Between, Space Around. |
Children | Organization of item when the maximum width of the repeater is reached. Click Don't Wrap so that items exceeding the maximum width of the repeater are not placed below the rest of the items, or click Wrap so that items exceeding the maximum width of the repeater are placed below the rest of the items. Then, select one of the wrapping options so that the items are organized according to a specific area of the repeater. The options available are: Start, center, End, stretch, Space Between or Space Around. You can also click the two-way arrows icon () to invert the order of the items. |
CSS Class | This atribute should not be used for the repeater item component. |
Important For Accessibility | Attribute that defines whether the screen reader reads or ignores the value defined in the Accessibility Text attribute of the component. Click the arrow and select an option from the drop-down menu. Choose true so that the screen reader reads the component or false so that the screen reader does not read the component. The default value is false. |
Exclusive Accessibility | Attribute that defines which components must be read by the screen reader. Click the arrow and select an option from the drop-down menu. Choose true to tell the screen reader to prioritize this component and its child components and ignore all other components within the screen. Choose false to tell the screen reader to read all the components within the screen. If not configured, the attribute's behavior defaults to false. |
Accessibility Role | Attribute that tells the screen reader to read the component's function. Click the arrow and select an option from the drop-down menu. The options available are button, checkbox, image, imageButton, link, none, radioButton, search and switch. Choose the option that best suits the role that you want to give to the component in the screen. |
Do Not Ready My Children | Attribute that defines whether the screen reader must read the child components within the container component. Click the arrow and select an option from the drop-down menu. Choose true so that the screen reader reads the child components or false so that it doesn't read them. For mobile apps, if the attribute is not configured, the behavior defaults to false. |
Accessibility Text | Alternative text. Add a short text to describe the component to users who may not be able to see it. The text will be read by iOS Voice Over or Android Talk Back. You can also add the accessibility text to the translations dictionary or select an existing translation if there are languages selected in your branch settings. |
Accessibility Order | Attribute that tells the screen reader the order in which it must read the components. To configure it, click the field and enter a number to define the order. For example, if this component should be read in third place, enter the value 3. If you don't configure a custom order, components are read from top to bottom and left to right of the screen. |
Shadow offset-x | Enter a value for the shadow with regard to the X (horizontal) axis, which considers the center of the component as a starting point. If the value is a negative number, the shadow will point to the left. You can click the arrow located to the right of the shadow field and select a unit of measurement from the drop-down menu. |
Shadow offset-y | Enter a value for the shadow with regard to the Y (vertical) axis, which considers the center of the component as a starting point. You can click the arrow located to the right of the shadow field and select a unit of measurement from the drop-down menu. |
Shadow Blur Radius | Enter a value for the width of the shadow radius. You can click the arrow located to the right of the shadow field and select a unit of measurement from the drop-down menu. |
Shadow Color | To set the shadow color, click the field and type a hexa code or click the rounded-edges square icon to open the color picker. In the color picker, click the Hexa field and type a HEXA color code. |
Caution
Shadow attributes are not implemented for mobile apps.
Actions tab
In this section, you can set events or actions on the component that will be triggered by other certain actions. For example, if the action configured is "On Click", an event or action will be triggered when the app user clicks the component. Refer to the table below to learn more about each action.
On Double Click | Action involving double clicking or tapping the component. |
On Hold | Action involving clicking the component and maintaining it clicked for more than one second. |
On Click | Action involving clicking or tapping the component. |
In all cases, to set the event or action, type the action to be triggered in the corresponding field or click the vertical three-dot icon. The Create new link window opens. Click the down arrow and select one of the link types available in the drop-down menu: View, SW States, Process, Lambda, Pop Up, Toggle, Event, Link, Mail, Module Screen or Interface Message. A new drop-down menu appears. Click the down arrow and select the action or event within the selected type. Then, complete the parameters applicable to the option selected. Once you configure the required parameters, click Accept.
Advanced tab
There are no attributes for configuration in the Advanced tab for the Repeater Item component.