Text Question Schema Properties
A single-line or masked text input question.
Element type: text
Key properties: 17
Generation Hints
Section titled “Generation Hints”- Aliases: short answer, single-line input, email, phone, URL, number field.
- Use when: collecting one short value. Use
commentfor long free text. - Recommended properties:
type,name,title,inputType,placeholder,isRequired,validators.
{ "type": "text", "name": "email", "title": "Email", "inputType": "email", "isRequired": true }Key Properties
Section titled “Key Properties”inputType
Section titled “inputType”- Type:
string - Default:
"text" - Allowed values:
color,date,datetime-local,email,month,number,password,range,tel,text,time,url,week
A value passed on to the type attribute of the underlying element.
autocomplete
Section titled “autocomplete”- Type:
string - Default:
— - Allowed values: “,
name,honorific-prefix,given-name,additional-name,family-name,honorific-suffix,nickname,organization-title,username,new-password,current-password,organization,street-address,address-line1
A value passed on to the autocomplete attribute of the underlying element.
placeholder
Section titled “placeholder”- Type:
string - Default:
— - Localizable: Yes
A placeholder for the input field.
inputSize
Section titled “inputSize”- Type:
number - Default:
—
A value passed on to the size attribute of the underlying element.
inputTextAlignment
Section titled “inputTextAlignment”- Type:
string - Default:
"auto" - Allowed values:
left,right,auto
Specifies text alignment within the input field.
dataList
Section titled “dataList”- Type:
string[] - Default:
— - Localizable: Yes
An array of predefined options from which users can select. This property configures an HTML
maskType
Section titled “maskType”- Type:
string - Default:
"none" - Allowed values:
none,pattern,datetime,numeric,currency
Specifies the type of a mask applied to the input.
maskSettings
Section titled “maskSettings”- Type:
masksettings - Default:
—
An object with properties that configure the mask applied to the input.
- Type:
string - Default:
—
A value passed on to the min attribute of the underlying element.
- Type:
string - Default:
—
A value passed on to the max attribute of the underlying element.
- Type:
number - Default:
—
A value passed on to the step attribute of the underlying element.
minErrorText
Section titled “minErrorText”- Type:
string - Default:
— - Localizable: Yes
An error message to display when the question value is less than the minimum accepted value.
maxErrorText
Section titled “maxErrorText”- Type:
string - Default:
— - Localizable: Yes
An error message to display when the question value exceeds the maximum accepted value.
minValueExpression
Section titled “minValueExpression”- Type:
expression - Default:
—
The minimum value specified as an expression. For example, “minValueExpression”: “today(-1)” sets the minimum value to yesterday.
maxValueExpression
Section titled “maxValueExpression”- Type:
expression - Default:
—
The maximum value specified as an expression. For example, “maxValueExpression”: “today(1)” sets the maximum value to tomorrow.
maxLength
Section titled “maxLength”- Type:
number - Default:
-1
The maximum text length measured in characters. Assign 0 if the length should be unlimited.
textUpdateMode
Section titled “textUpdateMode”- Type:
string - Default:
"default" - Allowed values:
default,onBlur,onTyping
Specifies when to update the question value.
Shared Properties
Section titled “Shared Properties”This page lists only properties that are specific to this element type or especially important for generation.
- Use Shared Question Properties for common fields such as
name,title,description,isRequired,requiredIf,visibleIf,enableIf,readOnly,defaultValue,validators,width, and layout options.