Date
Validate over a date range. Uses MomentJS for date mathematics and calculations.
-Note*: MomentJS must be installed to be able to use this validator. The easiest way to do this is to install ember-moment
Options
allowBlank(Boolean): If true, skips validation if the value is emptybefore(String): The specified date must be before this dateonOrBefore(String): The specified date must be on or before this dateafter(String): The specified date must be after this dateonOrAfter(String): The specified date must be on or after this dateprecision(String): Limit the comparison check to a specific granularity. Options: year, month, week, day, hour, minute, second.format(String): Input value date formaterrorFormat(String): Error output date format. Defaults toMMM Do, YYYY
// Example
validator('date', {
after: 'now',
before: '1/1/2020',
precision: 'day',
format: 'M/D/YYY',
errorFormat: 'M/D/YYY'
})
// If before, onOrBefore, after, or onOrAfter is set to 'now', the value given to the validator will be tested against the current date and time.
Properties
Methods
buildOptions
-
options -
defaultOptions -
globalOptions
Build options hook. Merges default options into options object. This method gets called on init and is the ideal place to normalize your options. The presence validator is a good example to checkout
Returns:
createErrorMessage
-
type -
value -
options
Used by all pre-defined validators to build an error message that is present
in validators/message or declared in your i18n solution.
If we extended our default messages to include uniqueUsername: '{username} already exists',
we can use this method to generate our error message.
validate(value, options) {
var exists = false;
options.description = 'Username';
options.username = value;
// check with server if username exists...
if(exists) {
return this.createErrorMessage('uniqueUsername', value, options);
}
return true;
}
If we input johndoe and that username already exists, the returned message would be 'johndoe already exists'.
Parameters:
Returns:
The generated message
getValue
()
Unknown
private
Wrapper method to value that passes the necessary parameters
Returns:
value
processOptions
()
Object
Creates a new object and calls any option property that is a function with the validator context.
This method is called right before validate and the returned object gets passed into the validate method as its options
Returns:
validate
-
value -
options -
model -
attribute
The validate method is where all of your logic should go. It will get passed in the current value of the attribute this validator is attached to. Within the validator object, you will have access to the following properties:
Parameters:
Returns:
One of the following types:
Boolean:trueif the current value passed the validationString: The error messagePromise: A promise that will either resolve or reject, and will finally return eithertrueor the final error message string.
Properties
model
Model
Model instance