About this article
This article explains what a TextBox form field is and how it can be created through the dynamics designer. Sections in this article:
Prerequisites
|
What is a TextBox form field?
A textbox form field is a type of form field that allows the user to enter free text. Textboxes have a number of configurable options that determine the size, prepopulated text, mandatory filling requirement etc. Often, a textbox is used to populate a text binding or a document property. Below is an example of a setup with 4 textboxes for an end-user creating a letter.
Creating a textbox form field
In it's simplest form, a textbox is a Name
and a Label
with a single line. The Name
being used in the binding syntax and the Label
being placed above the textbox for user guidance. Therefore the simplest textbox creation consists of the following steps:
- Go to the Dynamics Designer
- Click the
Form
tab. - Click
Add form field
- Select
TextBox
- Fill out the
Name
andLabel
and any additional options - Click
Save
Below is an example of the above.
Additional options
- Required: Check this box if you'd like to mandate the user fills out the textbox, an asterisk will indicate to them that it's required.
- Placeholder: Prepopulate text that is deleted when the textbox is clicked.
- Default Value: Prepopulate text that stays when clicked and is editable. The default value can be your own text, or you can use a binding as default value, for example {{UserProfile.Location}} or {{HostSystem.Subject}}.
- Lines: Sets the height of the textbox in lines of text.
- Spacing before: Adds space above the form field.
- Space after: Adds space below the form field.
- Helptext prefix: Adds help text above the dropdown, this can be useful for guiding the user on filling out the form field.
- Helptext postfix: Adds help text below the dropdown, this can be useful for guiding the user on filling out the form field.
- Share value: Allows the form field to be recognizable as shared by dynamic documents.
TextBox form field examples
Example 1
A textbox form field where Lines
is set to 5.
Example 2
A single line textbox where Default Value
is set to a commonly used city "Chicago".
Comments
0 comments
Article is closed for comments.