Character counter
Last updated
Last updated
[SINCE Orbeon Forms 4.10]
The fr:character-counter
component encapsulates an existing text control and adds a character counter next to it.
It supports the following controls:
xf:input
xf:textarea
xf:secret
fr:tinymce
The component is generally activated using the appearance
attribute:
The component automatically encapsulates the specified control, here xf:input
.
The component displays its counter in different ways:
if no max-length
validation is present on the bound node
the counter value is the current number of characters
a CSS class fr-charcounter-current
is present on the counter
if a max-length
validation is present on the bound node
if the current length is smaller than max-length
the counter value is the number of remaining characters allowed
a CSS class fr-charcounter-remaining
is present on the counter
if the current length is larger than max-length
the counter value is the number of extra characters allowed
a CSS class fr-charcounter-over
is present on the counter
By default, fr-charcounter-over
places a minus sign in front of the number of characters over the limit.
The CSS bindings allow Form Builder to propose the "Character Counter" appearance to the user automatically. See How the new Form Builder Appearance Selector Works for details.