Vega Simple Select Component
Overview
The Simple Select component is a Vega (v2.0) The Vega (v 2.0.0) runtime is the next-generation engine of the UDesigner platform. Vega uses cutting-edge technologies to improve the Creator and end-user experience. Primary Fields component that lets end-users End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. select one or more options from a drop-down list. The drop-down list uses a values table, or a data reference key, to display a list of options.
By default, the Simple Select component stays collapsed until the end-user opens it. After making a selection, the list closes again.
You'll find the Simple Select component in the Primary Fields group to the left of the Module Builder.
About the Configuration Window
To learn more about general component settings, view our General Component Settings article.
Display Settings
Field Text
|
Setting |
Description |
|---|---|
|
Label Text |
Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. User-friendly labels make your module more accessible. Keep labels short and descriptive (a word or two) using title case. For longer entries, use sentence case. |
|
Placeholder Text |
A short prompt telling end-users the expected value of an input field. For example, Enter your Social Security Number. Placeholder Text displays inside the input field until the end-user begins an entry. |
Formatting
|
Setting |
Description |
|---|---|
|
Allow Multiple Selections |
When set to (ON), end-users can select multiple options from the drop-down. Each time the end-user clicks an option, its added to the field. |
|
Render Select Menu as Portal |
When set to (ON), in Express View Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View., the search select field is rendered in the HTML body of the DOM The Document Object Model (DOM) is the data representation of objects that form the structure and content of a document on the web. The DOM represents the page.. When set to (OFF), the Search Select field nests in its parent container. By default this setting is (ON). |
Data Settings
Data Source Type
There are two methods that you can use to populate a Simple Select component: Values and Data Reference Key.
Values
Selecting Values displays a table where you can enter each option and its value.
|
Setting |
Description |
|---|---|
|
Key |
Create a key value for targeting the option. For example, if you have three options in your menu, you could assign the following keys: menu1, menu2, menu3. |
|
Option Label |
Enter the text that displays to the end-user. When an end-user clicks the text, the Action setting fires. |
Data Reference Key
Using the Data Reference Key option, data from another component populates the Simple Select component. You'll most often use this option with a Data Table component. After adding you data to the Data Table component, reference the component in your Simple Select component's configuration window.
Think of this as a hybrid option of using Values and Data Collections to populate the Simple Select component. You still use data stored in Unqork, but it's data from your module instead of a Data Collection.
|
Setting |
Description |
|---|---|
|
Data Reference Key |
Enter the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. of the component whose data you're referencing. |
|
Key Property |
Specify the property in the data source to use as the select value. If no value is specified, the item value is used. By default, this setting's value is empty. |
|
Label Property |
This field refers to the option labels to retrieve. If you're retrieving data from a Data Table component, enter the column header in this field. |
|
Adornments Property |
Specify the property that contains the adornments. This setting is optional. |
Actions Settings
Events & Operations
| Setting | Description |
|---|---|
| Edit |
Opens the Operations Builder tool. Discover how to use events and operations in our Operations Builder article. |
Validation Panel
User Input
|
Setting |
Description |
|---|---|
|
Required |
When set to (ON), the end-user must enter a value in the component's visible fields. When set to (OFF), the input is optional. By default, Required is set to (OFF). |
|
Required Error Message |
A custom error message that displays below a required field. The error message displays when the end-user tries to save or submit the module without completing the required field. |
Adding a Simple Select Component
Configure a Simple Select component to collect an end-user's End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. education history. You'll configure six options for end-users to select.
These instructions assume that you have an open module saved with a title.
| 1. | In the Module Builder, drag and drop a Simple Select component onto the canvas. |
| 2. | In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. field, enter educationHistory. |
| 3. | In the Label Text Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. field, enter What is the highest level of education you've completed?. |
| 4. | Navigate to the Data settings. |
| 5. | In the Values table, enter the following: |
|
Label |
Value |
|
|---|---|---|
|
1 |
lessThanHighSchool |
Less than High School |
|
2 |
highSchoolGED |
High School/GED |
|
3 |
associatesDegree |
Associate's Degree |
|
4 |
bachelorsDegree |
Bachelor's Degree |
|
5 |
mastersDegree |
Master's Degree |
|
6 |
higherEd |
Higher Education |
| 6. | Navigate to the Validation settings. |
| 7. | Set Required to (ON). |
| 8. | Click Save Component. |
| 9. | Save your module. |
Overview
The Simple Select component is a Vega (v2.0) The Vega (v 2.0.0) runtime is the next-generation engine of the UDesigner platform. Vega uses cutting-edge technologies to improve the Creator and end-user experience. Primary Fields component that lets end-users End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. select one or more options from a drop-down list. The drop-down list uses a values table, or a data reference key, to display a list of options.
By default, the Simple Select component stays collapsed until the end-user opens it. After making a selection, the list closes again.
You'll find the Simple Select component in the Primary Fields group to the left of the Module Builder.
About the Configuration Window
To learn more about general component settings, view our General Component Settings article.
Display Panel
Field Text
|
Setting |
Description |
|---|---|
|
Label Text |
Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. User-friendly labels make your module more accessible. Keep labels short and descriptive (a word or two) using title case. For longer entries, use sentence case. |
|
Placeholder Text |
A short prompt telling end-users the expected value of an input field. For example, Enter your Social Security Number. Placeholder Text displays inside the input field until the end-user begins an entry. |
Formatting
|
Setting |
Description |
|---|---|
|
Allow Multiple Selections |
When set to (ON), end-users can select multiple options from the drop-down. Each time the end-user clicks an option, its added to the field. |
|
Render Select Menu as Portal |
When set to (ON), in Express View Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View., the search select field is rendered in the HTML body of the DOM The Document Object Model (DOM) is the data representation of objects that form the structure and content of a document on the web. The DOM represents the page.. When set to (OFF), the Search Select field nests in its parent container. By default this setting is (ON). |
Data Panel
Data Source Type
There are two methods that you can use to populate a Simple Select component: Values and Data Reference Key.
Values
Selecting Values displays a table where you can enter each option and its value.
|
Setting |
Description |
|---|---|
|
Key |
Create a key value for targeting the option. For example, if you have three options in your menu, you could assign the following keys: menu1, menu2, menu3. |
|
Option Label |
Enter the text that displays to the end-user. When an end-user clicks the text, the Action setting fires. |
Data Reference Key
Using the Data Reference Key option, data from another component populates the Simple Select component. You'll most often use this option with a Data Table component. After adding you data to the Data Table component, reference the component in your Simple Select component's configuration window.
Think of this as a hybrid option of using Values and Data Collections to populate the Simple Select component. You still use data stored in Unqork, but it's data from your module instead of a Data Collection.
|
Setting |
Description |
|---|---|
|
Data Reference Key |
Enter the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. of the component whose data you're referencing. |
|
Key Property |
Specify the property in the data source to use as the select value. If no value is specified, the item value is used. By default, this setting's value is empty. |
|
Label Property |
This field refers to the option labels to retrieve. If you're retrieving data from a Data Table component, enter the column header in this field. |
|
Adornments Property |
Specify the property that contains the adornments. This setting is optional. |
Validation Panel
User Input
|
Setting |
Description |
|---|---|
|
Required |
When set to (ON), the end-user must enter a value in the component's visible fields. When set to (OFF), the input is optional. By default, Required is set to (OFF). |
|
Required Error Message |
A custom error message that displays below a required field. The error message displays when the end-user tries to save or submit the module without completing the required field. |
Adding a Simple Select Component
Configure a Simple Select component to collect an end-user's End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. education history. You'll configure six options for end-users to select.
These instructions assume that you have an open module saved with a title.
| 1. | In the Module Builder, drag and drop a Simple Select component onto the canvas. |
| 2. | In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. field, enter educationHistory. |
| 3. | In the Label Text Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. field, enter What is the highest level of education you've completed?. |
| 4. | In the component's configuration menu, click Data. |
| 5. | In the Values table, enter the following: |
|
Key |
Option Label |
|
|---|---|---|
|
1 |
lessThanHighSchool |
Less than High School |
|
2 |
highSchoolGED |
High School/GED |
|
3 |
associatesDegree |
Associate's Degree |
|
4 |
bachelorsDegree |
Bachelor's Degree |
|
5 |
mastersDegree |
Master's Degree |
|
6 |
higherEd |
Higher Education |
| 6. | In the component's configuration menu, click  Validation. |
| 7. | Set Required to (ON). |
| 8. | Click Save & Close. |
| 9. | Save your module. |
Structure of a Simple Select Component's Data
Using the above example, execute the Vega Console command UNQENG.tools.getComponentState('educationHistory') in the DevTools Console The DevTools Console helps you securely store, build, test, and deploy your software. to display the component's data structure.
Here's how the above example looks after selecting an option in Express View :
Here's how the same component looks in the DevTools Console The DevTools Console helps you securely store, build, test, and deploy your software.:
