Skip to main content

Single line

Configure a one-line text field, validate its input, and choose when text changes trigger a form action.

Use Single line for short text on one line, such as an order reference, asset tag, or name. It suits text identifiers with leading zeros, such as 000417. For notes that need line breaks, use Multiple line. Multiple line


Add Single line to the form

In the approval form designer, open Controls → Basic Fields and drag Single line into a section or container. In a list form, add the existing field from Custom List Fields to write the text to its column. Approval form designer · List form designer


Basic of the Single line

Select the control and open Content → Basic. Set the Title, such as Order reference. In an approval form, Yeeflow creates an associated variable. Use Edit to change its ID or name, or Reset to bind a compatible text variable. Bind later task forms to the same variable when they need to show the same reference. Form controls and associated variables and fields


Appearance of the Single line

In Content → Appearance, set Placeholder to show an input hint while the field is empty, such as “Example: PO-2026-001.” To prefill actual text, use Default Value under Validation.

Use Display Title to show the label and Allow Comment to let users comment. Use dynamic display rules to show the field when specified conditions are met. Dynamic Display Rules


Validation of the Single line

In Content → Validation, use Readonly for review and Required when the form needs an entry. Set Max Length to the number of characters users can enter. Use Default Value to prefill the field and Custom Validation to set business rules, such as a required order reference format. Custom Validation

To fill the field by scanning, turn on Allow users to scan barcodes & QR codes. The scan button opens the device camera with the user’s permission and fills the field with the detected value.

Preview a blank input and text at and above the length limit. If scanning is enabled, scan a sample code on the intended device and verify the captured value.


Action call of the Single line

Create and save a form action. In the Single line control’s Content → Action settings, choose when the action should run.

  • Value changed runs after the value changes and the input loses focus. Use it for work that should happen after the user has finished editing.

  • Input changed runs during entry. After you select an action, Min number of letters sets the minimum input length. The documented default is three characters. For example, query matching records once enough characters have been entered.

Yeeflow Single line action settings showing Value changed, Input changed, and a three-character minimum for Query data.

Test Input changed below and at the threshold. For Value changed, edit the text, move focus away, and check what the selected action changes. Form Actions


Style the Single line

Field - Editable

Under Style → Field - Editable, adjust typography, padding, alignment, placeholder color, and width. Use Normal and Focus to set text, background, border, radius, and shadow. Field Alignment applies when the control is narrower than its container. Style the error message independently.


Field - Read Only

Under Style → Field - Read Only, adjust typography, text and background colors, alignment, padding, border, and radius. Check that a saved reference is readable in the review form.

Style of title

Set the label typography and layout, then check it beside the field value at desktop and phone widths. Title of field controls


Advanced Settings

Use Advanced for shared control settings. Save the design and check a test record in the intended form and list or workflow. Advanced Settings Tab


​

Did this answer your question?