i18n Integration

Internationalization
If you are using i18n (Internationalization and Localization) in your ColdBox applications you can also localize your validation error messages from the ColdBox validators.
 Info You do not need to install the cbi18n module. This module is already a dependency of the cbvalidation module.
 You will do this by our lovely conventions for you resource bundle keys:
 Objects:
1
{ObjectName}.{Field}.{ConstraintType}}=Message
Copied!
 Forms with Shared Constraints Name
1
{SharedConstraintName}.{Field}.{ConstraintType}=Message
Copied!
 Forms with No Shared Constraints
1
GenericForm.{Field}.{ConstraintType}=Message
Copied!
Key Replacements
We also setup lots of global {Key} replacements for your messages and also several that the core constraint validators offer as well:
Global Replacements
{rejectedValue} - The rejected value
{field} or property - The property or field that was validated
{validationType} - The name of the constraint validator
{validationData} - The value of the constraint definition, e.g size=5..10, then this value is 5..10
{targetName} - The name of the user, shared constraint or form
i18n Validator Replacements
{DiscreteValidator} - operation, operationValue
{InListValidator} - inList
{MaxValidator} - max
{MinValidator} - min
{RangeValidator} - range, min, max
{RegexValidator} - regex
{SameAsValidator}, {SameAsNoCaseValidator} - SameAs
{SizeValidator} - size, min, max
{TypeValidator} - type
Examples
1
blank=The field {property} must contain a value.
2
email=The field {property} is not a valid email address.
3
unique=The field {property} is not a unique value.
4
size=The field {property} was not in the size range of {size}.
5
inlist=The field {property} was not in the list of possible values.
6
validator=There was a problem with {property}.
7
min=The minimum value {min} was not met for the field {property}.
8
max=The maximum value {max} was exceeded for the field {property}.
9
range=The range was not met for the field {property}.
10
matches=The field {property} does not match {regex}.
11
numeric=The field {property} is not a valid number.
Copied!
Please note that since version 3.x of cbvalidation you can use json resource bundles thanks to cbi18n v2.x

Advanced - Previous

Unique ORM Validator

Next - Advanced

Custom Validation Managers

Last modified 1yr ago

Copy link

Edit on GitHub

Contents

Internationalization

Objects:

Forms with Shared Constraints Name

Forms with No Shared Constraints

Key Replacements