|
Wt
4.10.4
|
A validator for date input. More...
#include <Wt/WDateValidator.h>
Public Member Functions | |
| WDateValidator () | |
| Creates a date validator. | |
| WDateValidator (const WDate &bottom, const WDate &top) | |
| Creates a date validator. | |
| WDateValidator (const WString &format) | |
| Creates a date validator. | |
| WDateValidator (const WString &format, const WDate &bottom, const WDate &top) | |
| Creates a date validator. | |
| void | setBottom (const WDate &bottom) |
| Sets the bottom of the valid date range. | |
| const WDate & | bottom () const |
| Returns the bottom date of the valid range. | |
| void | setTop (const WDate &top) |
| Sets the top of the valid date range. | |
| const WDate & | top () const |
| Returns the top date of the valid range. | |
| void | setFormat (const WString &format) |
| Sets the date format used to parse date strings. | |
| virtual WString | format () const override |
| Returns the format string used to parse date strings. | |
| void | setFormats (const std::vector< WString > &formats) |
| Sets the date formats used to parse date strings. | |
| const std::vector< WString > & | formats () const |
| Returns the date formats used to parse date strings. | |
| virtual Result | validate (const WString &input) const override |
| Validates the given input. | |
| void | setInvalidNotADateText (const WString &text) |
| Sets the message to display when the input is not a date. | |
| WString | invalidNotADateText () const |
| Returns the message displayed when the input is not a date. | |
| void | setInvalidTooEarlyText (const WString &text) |
| Sets the message to display when the date is earlier than bottom. | |
| WString | invalidTooEarlyText () const |
| Returns the message displayed when date is too early. | |
| void | setInvalidTooLateText (const WString &text) |
| Sets the message to display when the date is later than top. | |
| WString | invalidTooLateText () const |
| Returns the message displayed when the date is too late. | |
| virtual std::string | javaScriptValidate () const override |
| Creates a Javascript object that validates the input. | |
Public Member Functions inherited from Wt::WValidator | |
| WValidator (bool mandatory=false) | |
| Creates a new validator. | |
| virtual | ~WValidator () |
| Destructor. | |
| void | setMandatory (bool how) |
| Sets if input is mandatory. | |
| bool | isMandatory () const |
| Returns if input is mandatory. | |
| void | setInvalidBlankText (const WString &text) |
| Sets the message to display when a mandatory field is left blank. | |
| WString | invalidBlankText () const |
| Returns the message displayed when a mandatory field is left blank. | |
| virtual std::string | inputFilter () const |
| Returns a regular expression that filters input. | |
Additional Inherited Members | |
Public Types inherited from Wt::WValidator | |
| typedef ValidationState | State |
| Typedef for enum Wt::ValidationState. | |
A validator for date input.
This validator accepts input in the given date format, and optionally checks if the date is within a given range.
The format string used for validating user input are the same as those used by WDate::fromString().
Usage example:
The strings used in the WDateValidator can be translated by overriding the default values for the following localization keys:
| Wt::WDateValidator::WDateValidator | ( | ) |
Creates a date validator.
The validator will accept dates using the current locale's format.
Creates a date validator.
The validator will accept dates in the indicated range using the current locale's format.
Creates a date validator.
The validator will accept dates in the date format format.
The syntax for format is as in WDate::fromString()
| Wt::WDateValidator::WDateValidator | ( | const WString & | format, |
| const WDate & | bottom, | ||
| const WDate & | top ) |
Creates a date validator.
The validator will accept only dates within the indicated range bottom to top, in the date format format.
The syntax for format is as in WDate::fromString()
Returns the format string used to parse date strings.
Reimplemented from Wt::WValidator.
| WString Wt::WDateValidator::invalidNotADateText | ( | ) | const |
Returns the message displayed when the input is not a date.
| WString Wt::WDateValidator::invalidTooEarlyText | ( | ) | const |
Returns the message displayed when date is too early.
| WString Wt::WDateValidator::invalidTooLateText | ( | ) | const |
Returns the message displayed when the date is too late.
|
overridevirtual |
Creates a Javascript object that validates the input.
The JavaScript expression should evaluate to an object which contains a validate(text) function, which returns an object that contains the following two fields:
message that indicates the problem if not valid.Returns an empty string if the validator does not provide a client-side validation implementationq.
Reimplemented from Wt::WValidator.
Sets the bottom of the valid date range.
The default is a null date constructed using WDate().
Sets the date format used to parse date strings.
Sets the message to display when the input is not a date.
The default message is "The date must be of the format {1}", with as first argument the format string.
Sets the message to display when the date is earlier than bottom.
Depending on whether bottom() and top() are defined (see WDate::isNull()), the default message is "The date must be between {1} and {2}" or "The date must be after {1}".
Sets the top of the valid date range.
The default is a null date constructed using WDate().
Validates the given input.
The input is considered valid only when it is blank for a non-mandatory field, or represents a date in the given format, and within the valid range.
Reimplemented from Wt::WValidator.