Skip to content
troyji edited this page Aug 16, 2011 · 4 revisions

Overview

@NotBlank (or its alias @NotEmpty) enforces the constraint that an input element cannot have an empty value. An empty value is defined as an empty string, or a string that only consists of spaces or tabs.

Syntax

Syntax for @NotBlank is:

@NotBlank([label=label-text] , [message=message-text] , [groups=array-of-group-names])

Parameters

Name Type Required Description
label String no An optional parameter that specifies the label for this input element. Labels are a way to provide friendly names to input elements. If the constraint fails to validate, the value in this field will be used in the default error message. If the constraint has a custom error message which contains {labe}, the value of this parameter will be substituted in the place of {label}.
message String no An optional parameter that specifies the error message to use when this constraint fails. The value for this field can contain interpolations of parameters used by the constraint . For example: {label} needs to be {param1}.
groups Array no An array of group names that specifies the validation groups that this constraint belongs to.

Examples

Basic usage:

<input id = "name"
       name = "name"
       type = "text"
       data-constraints = '@NotBlank' />

Usage with optional parameters:

<input id = "name"
       name = "name"
       type = "text"
       data-constraints = '@NotEmpty(label="Your name", 
                                     message="{label} cannot be blank"
                                     groups=[FirstGroup, SecondGroup, ThirdGroup]' />
Clone this wiki locally