How to use the single-line text component-Quick BI(Quick BI)-阿里云帮助中心

A basic control for capturing short, single-line entries such as names, mobile phone numbers, or ID numbers in a form.

Use cases

Add brief, single-line text such as names, job titles, or company names.
Add fixed-format data such as mobile phone numbers or national ID numbers.

Example

In this example, the single-line text controls Associated Opportunity and Person in Charge are filled with "xxx" and "John Smith," respectively.

Control configuration

Basic settings

Parameter	Description
	① Display title: Specifies whether to show the control title. You can customize the display name, which serves as the field label.
	② Control type: Changes the control to another type. Select a `basic control` or `advanced control` type from the drop-down list.
	③ Table field name: The corresponding field name in the database table generated from this `form`. Note The `table field name` must start with a letter and can contain only letters, numbers, and underscores (_). The maximum length is 40 characters.
	④ Input prompt: Sets the `input prompt` text that appears in the control before a user enters a value. For example: "Enter the name of the person in charge."
	⑤ Description: Adds a custom `description` to the control.
	⑥ Description position: Controls where the `description` appears. Options: Below control, Right of title, and Below title. The following image shows a `description` placed below the control:
	⑦ Default state: The initial state of the control. Options: Normal, `read-only`, and `hidden`.
	⑧ Default value: Pre-fills the control with a `default value`. If you select Use login username, the field is automatically populated with the current user's username.
	⑨ Enable code scanning for input: When enabled, users on a `mobile client` can scan a barcode or `QR code` to populate the field.

Validation

Parameter	Description
	① Required: Marks this as a `required` field.
	② Minimum character count: Sets the `minimum character count` for the input.
	③ Maximum character count: Sets the `maximum character count` for the input.
	④ Format type: Validates input against a specific format. Options: Email, ID Card Number, and Mobile Phone Number.
	⑤ Prompt for invalid data: Customizes the error message displayed when input fails validation.

Style

Parameter

Description

Control width: Sets the control width. Options: Default and Full row.

Note

On the form page, you can also drag the control border to adjust its width.