Operations Builder: Events Reference

Overview

The Operations Builder Events Reference contains a non-exhaustive list of events that can fire operations using the Operations Builder tool. In Unqork applications, events occur that cause operations to execute. Events can occur from actions in the runtime, in 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., or by the end-user 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.. For example, when an end-user clicks an element on the page, the element emits the onClick event. Using the Operations Builder in a Vega-compatible component, Creators Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. can assign one or more operations to execute after an event occurs.

To learn more about events and the Operations Builder tool, view our Introduction to the Operations Builder article.

Operations Builder Events

This non-exhaustive list of events details the event name, type, runtime compatabilty, and a description of what it does. Events that have an HTML Event counterpart also display external documentation for reference.

New events are added regularly to ensure a better building experience. Return to this page often to see an updated list of events.

Event Name Description Additional Documentation

On Blur

Occurs when an input component Input components can recieve a value entered by the end-user. For example, Unqork input components include the Text Field and Button components. In contrast, HTML Element and Hidden components cannot recieve inputs by the end-user. has lost focus Focus indicates the element of the graphical user interface which is currently selected to receive input. Elements with focus sometimes have an accesibility border highlighted around them..

On Change

Occurs when an input component's Input components can recieve a value entered by the end-user. For example, Unqork input components include the Text Field and Button components. In contrast, HTML Element and Hidden components cannot recieve inputs by the end-user. value changes. Fires when the end-user 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. commits a value change.

In a Search Select component, this event does not apply to end-users while they are typing. Instead, it applies when a selection is made.

On Click

Occurs on click of any input component Input components can recieve a value entered by the end-user. For example, Unqork input components include the Text Field and Button components. In contrast, HTML Element and Hidden components cannot recieve inputs by the end-user. that is not disabled.

Not recommended for non-focusable elements.

In Express View Express View is how your end-user views you 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 onClick event occurs on the parent container of the UI The UI (user interface) is a device's end-user interaction and communication point. It can include display screens, keyboards, and mouse. It is also how a user interacts with your application. component.

On Edit Submission

Occurs when the page loads with a submission ID.

Similar to the Radio Button component icon Initializer component's Edit Submission trigger function.

Initializer Component

On Execute

Occurs when executing a component  using the Operations Builder Execute operation. Also occurs when using the trigger output type in logic components.

 

On Focus

Occurs when an input component Input components can recieve a value entered by the end-user. For example, Unqork input components include the Text Field and Button components. In contrast, HTML Element and Hidden components cannot recieve inputs by the end-user. has received focus Focus indicates the element of the graphical user interface which is currently selected to receive input. Elements with focus sometimes have an accesibility border highlighted around them..

On Initialize

Occurs when a component loads from a page load or Dynamic Refresh. This includes components that have been hidden.

 

On Mouse Enter

Occurs when the mouse cursor hovers over a UI component and can be used in place of onMouseOver.

In Express View Express View is how your end-user views you 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 onMouseEnter event occurs on the parent container of the UI The UI (user interface) is a device's end-user interaction and communication point. It can include display screens, keyboards, and mouse. It is also how a user interacts with your application. component.

On Mouse Leave

Occurs when the mouse cursor moves off a UI component.

In Express View Express View is how your end-user views you 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 onMouseLeave event occurs on the parent container of the UI The UI (user interface) is a device's end-user interaction and communication point. It can include display screens, keyboards, and mouse. It is also how a user interacts with your application. component.

On New Submission

Occurs when the page or called module loads without an existing submission ID.

Similar to Radio Button component icon Initializer component's New Submission function.

Initializer Component

On Table Cell Change

Occurs when a change happens to a component in a Vega Table cell.

For input components such as  Text Field and  Number, it fires when end-users finish editing a cell.

For Single Checkbox component Icon Checkboxes and Dropdown Component Icon Dropdown components, it fires when a selection change occurs.

Vega Table Component

On Table Cell Double Click

Occurs when double-clicking a Vega Table cell. Use this event to toggle a cell's edit mode to ON.

Vega Table Component

On Table Cell Focus

Occurs when a Vega Table cell has received focus Focus indicates the element of the graphical user interface which is currently selected to receive input. Elements with focus sometimes have an accesibility border highlighted around them.. Can fire from mouse clicks, or, keyboard tab-navigation from a different cell.

Vega Table Component

On Table Cell Key Down

Occurs when a pressing a key on an active cell in the Vega Table.

Vega Table Component

On Toggle Column Filter List

Occurs when toggling column filters in a Vega Table.

Vega Table Component

On Toggle Column Visibility Menu

Occurs when toggling the Column Visibility menu on a Vega Table.

Vega Table Component

On Toggle Full Screen

Occurs when toggling the fullscreen mode on a Vega Table.

Vega Table Component

On Toggle Global Filter

Occurs when toggling a Vega Table toolbar.

Vega Table Component

On Toggle Row Density

Occurs when there is a change to a Vega Table's row density.

Vega Table Component

Event Compatability

Operations Builder events are only compatible with components that can use them. For example, you cannot use an onClick event on a iconHidden component because the component does not have a UI element in Express View.

Understanding the Events Compatibility Table

While most events are compatible with Unqork components, some might be limited or unsupported. In the table below, components that are compatible with events display an empty cell.

If an event is not compatible, it is marked with an icon from the list below:

  • Empty Cell: This event is compatible with the component.

  • Limited Usage Limited: This event might be available at a later time.

  • Unsupported Unsupported: This event is not compatible with the component.

The current list of compatible components and events include:

Components On Blur On Change On Click On Edit Submission On Execute On Focus On Initialize On Mouse Enter On Mouse Leave On New Submission

 Text Field

 

 

 

 

 

 

 

 

 

 

Icon Text Area

 

 

 

 

 

 

 

 

 

 

Single Checkbox component Icon Checkboxes

 

 

 

 

 

 

 

 

 

 

Radio Buttons icon Radio Buttons

 

 

 

 

 

 

 

 

 

 

Dropdown Component Icon Dropdown

 

 

 

 

Limited Usage

 

 

 

 

 

Text Field Component Icon Multi-Select Dropdown

This component is not available in Vega or UDesigner.

 Number

 

 

 

 

 

 

 

 

 

 

Date Input Icon Date Input

 

Limited Usage

 

 

 

 

 

 

 

 

Single Checkbox component Icon Single Checkbox

 

 

 

 

 

 

 

 

 

 

Menu

 

Unsupported

 

 

 

 

 

Limited Usage

 

 

Simple Select

 

Limited Usage

 

 

 

 

 

 

 

 

Search Select

 

Limited Usage

 

 

 

 

 

 

 

 

Button component Icon Button

 

Unsupported

 

 

 

 

 

 

 

 

 Email

 

 

 

 

 

 

 

 

 

 

Phone Number

 

 

 

 

 

 

 

 

 

 

Intl Phone Number

 

 

 

 

 

 

 

 

 

 

iconHidden

Unsupported

Unsupported

Unsupported

 

 

Unsupported

 

Unsupported

 

 

 Columns Component Icon HTML Element

Unsupported

Unsupported

 

 

 

Unsupported

 

 

 

 

Columns Component Icon Columns

 

 

 

 

 

 

 

 

 

 

Panel

 

 

 

 

 

 

 

 

 

 

Image

Unsupported

Unsupported

 

 

 

Unsupported

 

 

 

 

Iframe

Limited Usage

Limited Usage

Limited Usage

 

 

Limited Usage

 

Limited Usage

Limited Usage

 

icon Field Group

 

 

 

 

 

 

 

 

   
Vega Table

Unsupported

Unsupported

Unsupported

   

Unsupported

 

Unsupported

Unsupported

 
Plug-In

Unsupported

Unsupported

Unsupported

 

Limited Usage

Unsupported

 

Unsupported

Unsupported

 

Dropdown Component Icon Data Table

Unsupported

Unsupported

Unsupported

 

Limited Usage

Unsupported

Limited Usage

Unsupported

Unsupported

 
 Timer

Unsupported

Unsupported

     

Unsupported

       

Resources