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

Setting the Properties of the Single-Line Text Widget

This widget records short text or numbers like names, license plate numbers, postal code, addresses, or ID numbers.

Figure 1 Single-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

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.
  • Unique: If checked, the field value cannot be repeated.
  • Characters: Set the max. number of characters (up to 85).
  • 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 4 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.

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 5 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.

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

Guide Prompt

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

Figure 9 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 10 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 11 Effect