Paragraph
A simple multiline text field, corresponding to an HTML <textarea>
element.
Properties
type |
"paragraph" |
rows |
(optional) The number of rows in the <textarea> . A suitable default will be chosen if this is not specified. |
validationCount |
(optional) Description of min and max word/character counts, see below. |
All the common properties are supported.
validationCount
This property describes the required word or character count to pass validation. When present, a counter is shown in the UI.
For example, to ensure that a paragraph has at least 10 words, use a definition like:
{ "type": "paragraph", "label": "At least ten", "required": true, "validationCount": { "min": 10 } }
In this example, required
specifies that a blank paragraph is not permitted, and the validationCount
specifies is must have at least 10 words.
Within the validationCount
definition, all properties are optional. To just display a word counter without any validation, set it to {}
.
property min
The minimum count for this paragraph element.
IMPORTANT If you specify min
, you probably also want to set required
to true
in the main element definition to ensure that a blank paragraph is not accepted.
property max
The maximum count for this paragraph element.
property unit
The units of counting. The default is "word"
to count words. Set to "character"
to count characters.
property minFailureMessage
The validation message to display when the count is less than the minimum.
property maxFailureMessage
The validation message to display when the count is greater than the maximum.
property limitText
The text to display in the UI to describe the limits, next to the counter. This should be very short.