Skip to main content
Version: 2.1.0

Control component

Control component action invokes the component specific actions. Component specific actions are the actions that are exclusive actions for a particular widget. Component specific actions can be triggered either through the event handlers or from the Run JavaScript code query.

info

Check out the live demo of Component specific actions demonstrated in one of our community call.

Available Component Specific Actions

WidgetComponent Specific Actions
ButtonClick, Set label, Disable, Visibility, Loading
TextSet text, Set Visibility
Text InputSet text, Clear, Set Focus, Set Blur, Disable, Visibility
Text AreaSet text, Clear
ModalShow, Close
TableSet page, Select row, Deselect Row, Discard changes
DropdownSelect option
MultiselectSelect option, Deselect option, Clear selection
MapSet location
CheckboxSet checked
Radio buttonSelect option
TabsSet tab
Color pickerSet color
File pickerClear files
info

Currently, Component specific actions are supported only by the above listed widgets. We are working on bringing component specific actions for the remaining widgets.

Using Component Specific Actions

Set a value for text input widget using button's event handler

  • Drag a Text Input and a Button widget onto the canvas.

  • Go to the Inspector on the left sidebar to check the exposed variables available for the textinput1 widget under the components. You'll see that the variable value is an empty string because the field value of the text input widget is empty right now.

ToolJet - Action reference - Control Component

  • Now enter some value in the text input widget and you'll see that the value in inspector has been updated.

ToolJet - Action reference - Control Component

  • Now, click on the button's widget handler to open up its properties in the right sidebar and then add a event handler for On Click event to trigger Control Component action. Select textinput1 in component dropdown, Set text as Action, and in Text field enter the text that you want to update in the field value.

ToolJet - Action reference - Control Component

  • Now when you'll click on the button you'll see that the field value of the text input widget has been updated with value that you set.

ToolJet - Action reference - Control Component

Clear value of text input widget using JavaScript query

  • Let's clear the value that we set in the previous section, using Run JavaScript code. Create a new Run JavaScript Code query and call the component and the CSA that component provides.

Syntax:

await components.textinput1.clear()

ToolJet - Action reference - Control Component

ToolJet - Action reference - Control Component

  • Finally, hit the save and run query button to fire up the query, and you'll see that the field value of the text input widget has been cleared.