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

The single-line text control is a basic control for adding a single line of text to a form.

Use cases

Use the single-line text control to add brief, single-line text, such as names, job titles, or company names.
Use the single-line text control to add fixed-format data, such as mobile phone numbers or national ID numbers.

Example

In the following example, the single-line text controls for Associated Opportunity and Person in Charge contain "xxx" and "John Smith," respectively.

Control configuration

Basic settings

Parameter	Description
	① Display title: Sets whether to display the control's title. You can customize this name, which is used as the field's label.
	② Control type: Lets you change the control to another type. Use the drop-down list to select other `basic control` or `advanced control` types.
	③ Table field name: The name of the corresponding field in the database table created 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: Sets a custom `description` for the control.
	⑥ Description position: Sets the position of the `description`. Options include Below control, Right of title, and Below title. For example, the following image shows a `description` set below the control:
	⑦ Default state: Sets the `default state` of the control. Options include Normal, `read-only`, and `hidden`.
	⑧ Default value: Sets a `default value` to display in the control. If you select Use login username, the control is automatically filled with the username of the current user.
	⑨ Enable code scanning for input: If selected, users on a `mobile client` can scan a barcode or `QR code` to fill the field.

Validation

Parameter	Description
	① Required: Makes this 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: Select a `format type` for input `validation`. Options include Email, ID Card Number, and Mobile Phone Number.
	⑤ Prompt for invalid data: Lets you customize the error message shown for invalid input.

Style

Parameter

Description

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

Note

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