Page Actions

Page Flow Blocks reference.

Blocks

• Close Popup (Modal)
• Data Table Load Next Page
• Data Table Load Prev Page
• Get Content
• Get Content in Data Design
• Navigate Page
• Set Content
• Set Content in Data Design
• Show Confirmation Popup

Close Popup (Modal)

Block name: close_modal

Closes the currently open modal popup.

Output

This block does not produce an output value.

Behavior

Generates client-side code that closes the active modal popup.

Calls: $io.ui.closeModal

Related Blocks

• showmodalform
• informmodal
• confirmmodal

Data Table Load Next Page

Block name: datatablenextpage

Loads the next page of records in a Data Table widget.

Inputs

Input	Type	Description	Accepts
data table	element	The id of the Data Table widget whose next page should be loaded. Use the element's HTML id attribute value. Do not use AI IDs such as ai:... or data-tvwa-ai-id; those IDs are only for modification commands. You can type the element id directly or click the lookup button to select from valid elements available in the current context.

Output

This block does not produce an output value.

Behavior

Generates client-side code that resolves the Data Table widget element and sends a next-page command.

Calls: $io.dom.elementIdSel, $io.ui.widgetCommand

Related Blocks

• datatableprevpage
• datatablerefresh
• datatablequery

Data Table Load Prev Page

Block name: datatableprevpage

Loads the previous page of records in a Data Table widget.

Inputs

Input	Type	Description	Accepts
data table	element	The id of the Data Table widget whose previous page should be loaded. Use the element's HTML id attribute value. Do not use AI IDs such as ai:... or data-tvwa-ai-id; those IDs are only for modification commands. You can type the element id directly or click the lookup button to select from valid elements available in the current context.

Output

This block does not produce an output value.

Behavior

Generates client-side code that resolves the Data Table widget element and sends a prev-page command.

Calls: $io.dom.elementIdSel, $io.ui.widgetCommand

Related Blocks

• datatablenextpage
• datatablerefresh
• datatablequery

Get Content

Block name: getpagecontent2

Gets the current HTML content of a selected page element.

Inputs

Input	Type	Description	Accepts
element	element	The id of the page element whose content should be read. This is typically provided by an Element block or a DOM Selector block. Use the Element block for a target element HTML id attribute value, or the DOM Selector block for a DOM selector string. Do not use AI IDs such as ai:... or data-tvwa-ai-id.	elementidasstring, domselasstring

Output

This block produces an output value of type String.

Behavior

Generates client-side code that resolves the target element from the connected element or DOM Selector block and reads its current HTML content.

Calls: $io.dom.elementIdSel, $io.dom.domSel, $io.dom.getHtml

Related Blocks

• pagecontent2
• elementidasstring
• domselasstring

Get Content in Data Design

Block name: template_getpagecontent

Gets the current content of an element generated from a Data Design template.

Inputs

Input	Type	Description	Accepts
data design	template	The Data Design template that produced the target element. You can type the template name directly or click the lookup button to select from valid Data Design templates available in the current context.
element	element	The element inside the selected Data Design template whose content should be read. You can type the element name directly or click the lookup button to select from valid template elements available in the current context.
ID	string	The primary identifier for the generated template instance. This is typically provided by a text block.	text
ID2	string	An optional secondary identifier for the generated template instance. This is typically provided by a text block.	text

Output

This block produces an output value of type String.

Behavior

Generates client-side code that resolves the target Data Design element and reads its current HTML content.

Calls: $io.dom.dataDesignElementSel, $io.dom.getHtml

Related Blocks

• template_pagecontent
• content_from_template_with_object

Navigate Page

Block name: pagenavigate2

Navigates the browser from the current page to the specified destination URL. Do not use this block to open ioLoop form pages unless the author explicitly asks for a standalone form URL; forms should normally be opened from the current page as modal/sidebar forms with the Show Popup Form block or $io.ui.showFormModal(...).

Inputs

Input	Type	Description	Accepts
destination URL	string	The page URL to navigate to. This is typically provided by a text block. Do not provide a form page URL here unless the author explicitly asked for direct standalone form navigation.	text

Output

This block does not produce an output value.

Behavior

Generates client-side code that reads the destination URL and assigns it to window.location.href if a value is provided. Use Show Popup Form or $io.ui.showFormModal(...) instead when a user action should open an ioLoop form.

Related Blocks

• url_param_by_name

Set Content

Block name: pagecontent2

Sets, appends, or prepends HTML content for a selected page element.

Inputs

Input	Type	Description	Accepts
behavior	choice	How the content should be applied to the target element.
element	element	The id of the page element whose content should be updated. This is typically provided by an Element block or a DOM Selector block. Use the Element block for a target element HTML id attribute value, or the DOM Selector block for a DOM selector string. Do not use AI IDs such as ai:... or data-tvwa-ai-id.	elementidasstring, domselasstring
content	string	The content to place in the target element. This is typically provided by a text block, but blocks such as badge, alert, spinner, or content_from_template_with_object can also be used when you want formatted HTML content.	text

Output

This block does not produce an output value.

Behavior

Generates client-side code that resolves the target element from the connected element or DOM Selector block and updates its HTML content using the selected operation mode.

Calls: $io.dom.elementIdSel, $io.dom.domSel, $io.dom.setHtml

Related Blocks

• getpagecontent2
• elementidasstring
• domselasstring
• badge
• alert
• spinner
• content_from_template_with_object

Set Content in Data Design

Block name: template_pagecontent

Sets, appends, or prepends content for an element generated from a Data Design template.

Inputs

Input	Type	Description	Accepts
behavior	choice	How the content should be applied to the target element.
data design	template	The Data Design template that produced the target element. You can type the template name directly or click the lookup button to select from valid Data Design templates available in the current context.
element	element	The element inside the selected Data Design template whose content should be updated. You can type the element name directly or click the lookup button to select from valid template elements available in the current context.
ID	string	The primary identifier for the generated template instance. This is typically provided by a text block.	text
ID2	string	An optional secondary identifier for the generated template instance. This is typically provided by a text block.	text
content	string	The content to place in the target element. This is typically provided by a text block, but blocks such as badge, alert, or spinner can also be used when you want formatted content.	text

Output

This block does not produce an output value.

Behavior

Generates client-side code that resolves the target Data Design element and updates its HTML content using the selected operation mode.

Calls: $io.dom.dataDesignElementSel, $io.dom.setHtml

Related Blocks

• template_getpagecontent
• content_from_template_with_object

Show Confirmation Popup

Block name: confirmmodal

Shows a confirmation modal popup and lets you run different nested logic for OK and Cancel.

Inputs

Input	Type	Description	Accepts
title	string	The popup title. This is typically provided by a text block.	text
message	string	The message shown in the popup. This is typically provided by a text block.	text
customization	object	Optional modal customization settings.
on OK	statements	The blocks to run when the user confirms. Nested blocks run inside the generated callback for this block. customcode and customcodeexpr blocks inside this area can directly access the documented callback-scope variables.
on Cancel	statements	The blocks to run when the user cancels. Nested blocks run inside the generated callback for this block. customcode and customcodeexpr blocks inside this area can directly access the documented callback-scope variables.

Output

This block does not produce an output value.

Behavior

Generates client-side code that shows a confirmation modal popup and routes the nested statement blocks based on the boolean result returned by the modal promise. The nested blocks are emitted inside function(result) { ... }, so customcode and customcodeexpr blocks inside the OK and Cancel branches can access result directly.

Calls: $io.ui.showConfirmModal

Related Blocks

• informmodal
• close_modal