Text box

Note. To display values or KPIs you should always use the Text Control!

The text box, unlike the Text control, also allows you to make text entries. To add the text box drag and drop it onto the workspace.

Add text box

Text box properties

In addition to the [Appearance] area in the attributes, where you can adjust properties such as font (1), alignment (2) background (3) and border properties (4), you will find text box-specific properties in the [Data] area for the text box. You can link the text field to a data source by clicking on the link icon (5). You can also select an input type (6) from the drop-down menu. Choose [Text] for normal text input. You can specify if multiline (7) should be possible and you can activate the data validation (8) by clicking on the corresponding checkbox.

Text box attributes

Data validation

To validate the data entered into the text box you can use regular expressions (1). By clicking on the […] button (2) you will get to some sample expressions (3) that you can use, for example, if you want to enter a valid e-mail address in the field. You can find many sources for further and arbitrarily complex regular expressions on the Internet. To let the user of the text field see if his input is correct, you can specify a color for invalid input (4).

Text box attributes

Other input types you can choose are [Password] and [Numeric]. If you choose the input type [Password], the entered text will be replaced by [*] in the visualization. You can also use the data validation here. If you select the [Numeric] input type, data validation is automatically activated and the input is limited to natural numbers by a regex.

Processing input

You can process the input in different ways. In the [Logic] section of the attributes, you will find two different script options for this:

  • [Text changed event] (1) - here you can define a script that will be executed when a new input is made.
  • [Tapped event] (2) - here you can specify a script that will be executed when the text field is tapped or clicked with the mouse.

More information on how to create scripts or how the Script editor works can be found in the scripting section. If the control is used in scripts you can activate the corresponding checkbox and give the control a name (3) to be used in the scripts.

Available script options

We are learning from you!

Did you find this article helpful?

Be enlightened!

Do you need more support?

Peakboard Youtube icon Visit our YouTube channel

Our numerous videos for beginners and advanced users explain exactly how to design your dashboard.

Peakboard Templates icon Visit the Peakboard Templates

Download our templates for various use cases for free.

Peakboard icon Visit

Find out all about Peakboard and browse our different use cases and success stories.