Account selector - AccountSelector

Availability of functionality depends on the license and may not be available in all deployments.

The account selector component allows selecting an account from a dropdown list. Each item can have separate descriptions, displayed in two rows. Additionally, the component supports grouping of items displayed in the list.

✅ When to use:

• Selecting an account from a dropdown list, where items have an additional description, account number, balance, or grouping.

❌ When not to use:

• A single option selection without additional data is sufficient. Use: Radio / Tile / Combobox.

Component properties

Eximee Designer property	Attribute name in the Source	Description
Field placeholder (section Data quality)	placeholderText	Text visible in the field before any value is selected.
Empty option	emptyOption	Property added directly to the source. The value true displays the first item from the list; the value false displays the placeholder (e.g. "Select...").

More information about component properties: Common component properties

Component input parameters

Parameter name	Description
iconUrl	URL to the icon/photo displayed next to the list item (Eximee server resources).
text	Main label (description) of the list item.
description	Additional description of the item, e.g. account number or detailed information (supports text or boolean values).
suffix	Short additional description displayed at the end of the item, e.g. amount or currency.
groupId	Group identifier. Items with the same ID are grouped and sorted alphabetically within a section.
group	Flag determining whether the version with grouping should be presented (true/false).
ellipsis	Determines whether description should be truncated to one line (true/false).
ellipsisText	Determines whether text should be truncated to one line. By default true. Setting suffix forces the value true.
singleAccountList	Information whether to present a single account list view (true/false).
shortAccountList	Information whether to present a shortened version of the account list (true/false).

Component variants

Illustration 1. Component with account names only

Illustration 2. Component with additional description

Illustration 3. Component with additional description and sections

Component state information

Unlike most selection components, AccountSelector stores the value as a JSON object containing all data of the selected item.

After selecting a specific option, the component takes the value in the following format:

[{
    "suffix":"(14 731,21 PLN)",
    "description":"83 1123 1023 0000 2613 9510 0000",
    "groupId":"Accounts",
    "text":"Zero account",
    "value":"4"
}]

Referring to the selected value

It is possible to search for specific text fragments using the method indexOf().

For the example component value presented above, the condition:

getValue("GesAccountSelector1").indexOf('"value":"4"') != -1

returns:

• true - if the account with value 4,
• false - if another item is selected.

The method indexOf() returns the position of the found text or -1, if the specified fragment does not occur in the component's value.

This may be useful in situations where the visibility of another component should depend on the selected account.

Visibility condition example hiding the component for the account with value 4:

getValue("GesAccountSelector1").indexOf('"value":"4"') == -1

Similarly, you can refer to the other properties of the object, e.g. text, description, suffix or groupId.

Filling the component with values

To populate the component with data in the low-code model, configure an External Data Source (EDS). Below is an example returning a list of accounts:

function callService(context) {
    // Retrieve context parameters (optional)
    const showSuffix = context.getFirstParameter("showSuffix") === "true";

    return [
        {
            "value": "1",
            "text": "Zero account",
            "description": "83 1123 1023 0000 2613 9510 0000",
            "suffix": showSuffix ? "(14 731,21 PLN)" : null,
            "groupId": "Personal accounts",
            "iconUrl": "/assets/icons/account_active.png",
            "ellipsis": true
        },
        {
            "value": "2",
            "text": "Credit Card MC",
            "description": "45 1010 1023 0123 2618 9510 1111",
            "suffix": showSuffix ? "(5 000,00 PLN)" : null,
            "groupId": "Cards",
            "iconUrl": "/assets/icons/card_gold.png",
            "ellipsis": true
        }
    ];
}

Note! If the component domain contains only one account, it is automatically selected and the component becomes disabled.

After the selection is made, the component stores the data in the following object array format:

[{
    "value": "1",
    "text": "Zero account",
    "description": "83 1123 1023 0000 2613 9510 0000",
    "suffix": "(14 731,21 PLN)",
    "groupId": "Personal accounts"
}]

Demo request:

Demo request: demoAccountSelector