Overview
Toolbar buttons displays at the top of the Grid and Properties Card containers, and contains buttons that can be used for page navigation, to link to additional pages or to run a rule registered in an Event. These buttons can be created using the Toolbar Configuration section in the Grid and Properties Card containers.
Construct Preview eliminates the need to create toolbar views that were used in the legacy Construct.
Note
Currently, toolbar buttons execute events only for a single selected row. Support for multiple-row selection and execution will be added in a future release.
Adding a Toolbar Button
On the Construct Preview’s home page, edit the required WebApp. The WebApp configuration page is displayed.
Access Pages > Your Page > Grid or Properties Card in the Tree Navigation panel. The Details panel is updated with the Grid or Properties Card fields.
Access the Toolbar Configuration section and click Add. The toolbar button configuration fields are displayed.
Enter the fields/properties listed in the following table as required using either form-based UI or Advanced mode:
Note
Only one of Page Event Name, Link to Page Name, or Link to URL may be populated for a button. If additional actions are required, add separate buttons for each specific need.
Property (Name: Type)
Description
Supported Values/Notes
label: string
required
Enter the label that will be displayed on this button.
maxLength: 128
tooltip: string
Enter the help tooltip that will be displayed when hovering over this button.
maxLength: 2000
ordinal: integer
Specify the order in which buttons are rendered in the toolbar.
default: 0
Event Name
(page_event_name): string
Select the name of the event that will be executed when this button is clicked. The event must already exist within the same grid or properties card container.
A new event can be created using the Create New Event button. However, you must access the newly created event to complete its configuration.
Refer to Register an Event for more information.
maxLength: 128
link_to_page_name: string
Select the name of the internal page to navigate to when this button is clicked.
maxLength: 250
link_to_url: string
Enter the external URL to navigate to when this button is clicked.
maxLength: 2000
Open in New Tab
(link_to_page_new_tab): boolean
Toggle to determine whether a new browser tab is opened when navigating to the link defined for this button.
true, false.
default: true
To add multiple buttons to the toolbar, repeat Steps 3 and 4.
Click Save & Preview WebApp
to preview WebApp changes.Click Save WebApp
.