Hi Michal,
That is the current documentation on aui:validator. I'll be happy to give a better explanation of it for you though. aui:validator is a tag used in aui:input fields to validate the fields for the form. For example:
--------------
<aui:input name="Name" value=''" label="Name">
<aui:validator name="required" />
<aui:validator name="alpha" />
</aui:input>
--------------
In the example above the value of the name attribute of the aui:validator tag marks the field as required and says that only alpha characters are allowed. If you were to try to validate the field with other characters then alpha you would receive a default error message that says "please enter only alpha characters." If you want to
replace the default error message, you have to add a "errorMessage" attribute to the aui:validator tag. For example:
---------------
<aui:validator name="alpha" errorMessage"Enter characters that exist in the alphabet next time please" />
---------------
There are several values for you to choose from for the name attribute of the aui:validator tag:
**acceptFiles:** List of filetypes accepted. (Default:empty)
**alpha:** Evaluates whether or not a field contains only alpha characters.
(Default:none)
**alphanum:** A boolean value that determines whether a field is suppose to
contain only alphanumeric characters and evaluates it accordingly.
(Default:false)
**date:** A boolean value that determines whether a field is a Date and
evaluates it accordingly. (Default:false)
**digits:** A boolean value that determines whether a field is suppose to
contain only digits and evaluates it accordingly. (Default:false)
**email:** A boolean value that determines whether a field is a date and
evaluates it accordingly. (Default:false)
**equalTo:** Evaluates whether a field is equal to the field written.
(Default:empty)
**iri:** A boolean value that determines whether a field is a IRI and evaluates
it accordingly (Default:false)
**max:** Evaluates whether the integer value is less than or equal to the value
written. (Default:none)
**maxLength:** Evaluates whether a field is over the maximum length of
characters specified. (Default:empty)
**min:** Evaluates whether the integer value is greater than or equal to the
value written. (Default:none)
**minLength:** Evaluates whether a field is under the minimum length of
characters specified. (Default:empty)
**number:** A Boolean value that determines whether a field is suppose to
contain only numeric values and evaluates it accordingly. (Default:false)
**range:** Evaluates whether the integer value lies within the range given.
(Default:none)
**rangeLength:** Evaluates whether a field lies within the range of characters
written. (Default:empty)
**required:** Evaluates whether the field is required before submission.
(Default:false)
**url:** A boolean value that determines whether a field is a URL and evaluates
it accordingly. (Default:false)
For attributes that have a max or min and require a value, you will need to specify it in the tag. For example:
---------------
<aui:validator name="max">20</aui:validator>
---------------
Note that the aui:validator tag will need to be placed within a larger aui:form tag of your JSP and that you will need to reference the proper taglibs. Here is an example JSP for a portlet:
---------------
<%@ taglib uri="http://java.sun.com/portlet_2_0" prefix="portlet" %>
<%@ taglib uri="http://liferay.com/tld/aui" prefix="aui" %>
<portlet:defineObjects />
<aui:form name="myForm" action="" method="post">
<aui:input name="Name" value='' label="Name">
<aui:validator name="required" />
<aui:validator name="alpha" errorMessage"Enter characters that exist in the alphabet next time please" />
</aui:input>
<aui:button type="submit" name="submit" value="submit" />
</aui:form>
---------------
Hope this helps.
