Updated on 2025-08-21 GMT+08:00

Setting the Properties of the Multi-Line Text Widget

This widget records long and complex text, such as description, remarks, and feedback.

Figure 1 Multi-line text widget

Name

Set the field name shown to users. Click to set Chinese and English names. Click Reference Field to copy another field's value to this field name.

Figure 2 Setting the field name (Chinese and English)
Figure 3 Field reference

Rows

Set the number of rows for text (default is 4). Choose Auto fit row height to adjust rows based on content.

For example, if set to 3, only three rows show on the form. If you type more, scroll to see the rest.

Figure 4 Text with more than three rows

Verification

Limit the field's length and format to keep data accurate and valid.
  • Mandatory: If checked, the field is required and shows a * next to it.
  • Format: If checked, choose input format (Letter, Letter and digit, Digit). Each format has a preset regular expression for testing. Enter a value in the Test box to check the format; if invalid, an error message appears.
    Figure 5 Restricting the input format

Conditions

Set field properties like Read-only, Disable, and Hide.
  • Read-only: If checked, the field is read-only.
  • Disable: If checked, the field shows but cannot be edited.
  • Hide: If checked, the field is hidden on the page.

Default Value

Set a default value for the widget (defaults to "Please enter" if not set). This reduces user input, speeds up processes, and prevents invalid entries.

Figure 6 Setting the default value of a widget
  • Other field: Fields from other widgets.
  • Relate data: Link to existing data. The latest record is used as the default.
    Figure 7 Setting the default value
  • Formula editing: After you add a formula to a field, its value is calculated automatically when you fill in or change the form.
    Figure 8 Formula editing

Width

Width: Widget width as a ratio of the page width. Set the widget width to make the page look better and more professional.

Figure 9 Setting the widget width
  • 1/4: Widget is 1/4 of the page width.
  • 1/3: Widget is 1/3 of the page width.
  • 1/2: Widget is 1/2 of the page width.
  • 2/3: Widget is 2/3 of the page width.
  • 3/4: Widget is 3/4 of the page width.
  • 1: Widget is full page width (default).

Mobile QR Code

If enabled, you can scan barcodes or QR codes to input text. For example, scanned text can fill the widget.

Guide Prompt

If a user does not set this parameter, the text displayed on the GUI guides the user to perform correct operations.

Figure 10 Setting the guide prompt

Pop-up Message

If a field is unclear, add a Pop-up Message to explain it. This helps users and makes things easier.

After setting, a question mark icon appears next to the field. When filling in the form, click the question mark icon to see the message.

Figure 11 Effect

Description

Set the widget description. Include its functions, use cases, and tips. This helps users understand it better and makes the form clearer.

Figure 12 Effect