Field and Table Column Display Types
See also: Field Types
The following table shows which field types can be used with which display types:
Field Type: -> |
Boolean |
Char |
Currency |
Date |
DateTime |
Integer |
Numeric |
Object |
Time |
|
|
|
|
|
|
|
|
|
|
Display Type |
|
|
|
|
|
|
|
|
|
Basic Types: |
|
|
|
|
|
|
|
|
|
Checkbox |
|||||||||
Label |
|||||||||
Password |
|||||||||
Radio |
|||||||||
Dropdown |
|||||||||
Text |
|||||||||
Textarea |
|||||||||
HTML5 Types: |
|
|
|
|
|
|
|
|
|
Color |
|||||||||
Date |
|||||||||
Datetime-local |
|||||||||
Email |
|||||||||
Month |
|||||||||
Number |
|||||||||
Range |
|||||||||
Search |
|||||||||
Tel |
|||||||||
Time |
|||||||||
Url |
|||||||||
Week |
|||||||||
|
|
|
|
|
|
|
|
|
|
These types are supported by all browsers.
HTML input type: checkbox
Display type checkbox is best used in conjunction with field type Boolean to indicate a single checkable option. It can also be used to display lists where only a single option can be selected, but radio buttons or dropdowns are better suited to this purpose.
Display type label is a legacy feature. It displays only the label portion of a field.
HTML input type: password
Used to display passwords or similar.
HTML input type: radio
Displays a list as a number of radio buttons where only a single option can be selected. The field being displayed must have a list associated with it.
HTML input type: select
Displays a list as a dropdown list where only a single option can be selected. The field being displayed must have a list associated with it.
HTML input type: text
Displays a single row text box. This is the default type. Use the Display Length property to specify the size of the text box, use the Max Length validator to specify the maximum length of text that can be entered.
HTML input type: textarea
Displays a multi-row text box. Use the Display Length and Number of rows properties to specify the size of the text box.
These types are not guaranteed to be supported by all browsers. However, it is generally safe to use these types even when not supported – the browser will normally just convert them to type text. This may lead to some loss of functionality by the user but will not break the application.
HTML input type: color
Data format: #rrggbb e.g. #3e72c1
When clicked the browser will display a color chooser.
Use this in conjunction with a field of type Char.
HTML input type: date
Data format: yyyy-MM-dd e.g. 2019-07-21
When clicked the browser will display a date picker.
Use this in conjunction with a field of type Date.
HTML input type: datetime-local
Data format: yyyy-mm-dd’T’HH:mm e.g. 2019-07-21T14:31
When clicked the browser will display a date time picker.
Use this in conjunction with a field of type Datetime.
HTML input type: email
The browser will validate any entered email and devices with popup keyboards will include the @ sign in a popup keyboard.
Use this in conjunction with a field of type Char.
HTML input type: month
Data format: yyyy-MM e.g. 2019-07
The browser will display a month selector.
Use this in conjunction with a field of type Date or Char.
HTML input type: number
The browser will provide a mechanism to allow the user to increase or decrease the number. The step, min and max attributes can be entered using Custom Attributes within HTML Element Properties of the corresponding Field or Table Column Control. Caution: be sure to add these attributes on the Editor Input tab.
Use this in conjunction with any numeric field type.
HTML input type: range
The browser will usually provide some sort of slider control to allow the user to increase or decrease the number. The step, min and max attributes should be entered using Custom Attributes within HTML Element Properties of the corresponding Field or Table Column Control. Caution: be sure to add these attributes on the Editor Input tab.
Use this in conjunction with any numeric field type.
HTML input type: search
These are functionally equivalent to regular text boxes but may be styled differently by the browser.
Use this in conjunction with a field of type Char.
HTML input type: tel
Allows a mobile browser to display a custom keyboard optimized to entering telephone numbers.
HTML input type: time
Data format: HH:mm e.g. 23:12
When clicked the browser will allow the user to easily enter hours and minutes.
Use this in conjunction with a field of type Time.
HTML input type: url
These are functionally equivalent to regular text boxes but the browser may provide validation of the URL format.
Use this in conjunction with a field of type Char.
HTML input type: week
Data format: yyyy-Www e.g. 2019-W17
The browser will display a week of year selector.
Use this in conjunction with a field of type Date or Char.