See All Options

If true validates that the given value is not empty, if false, validates that the given value is empty.

Examples

validator('presence', true)
validator('presence', false)
validator('presence', {
  presence: true,
  message: 'should not be empty'
})

validator('presence', {
  presence: true,
  ignoreBlank: true,
  message: 'should not be empty or consist only of spaces'
})
Show:
buildOptions
(
  • options
  • defaultOptions
  • globalOptions
)
Object

Inherited from Base but overwritten in addon/validators/presence.js:37

Normalized options passed in.

validator('presence', true)
  // Becomes
  validator('presence', {
    presence: true
  })
  

Parameters:

Returns:

createErrorMessage
(
  • type
  • value
  • options
)
String

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;
  
    get(options, 'description') = 'Username';
    get(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:

  • type String

    The type of message template to use

  • value Mixed

    Current value being evaluated

  • options Object

    Validator built and processed options (used as the message string context)

Returns:

String:

The generated message

getValue () Mixed private

Wrapper method to value that passes the necessary parameters

Returns:

Mixed:

value

validate
(
  • value
  • options
  • model
  • attribute
)

Inherited from Base but overwritten in ember-validators/addon/presence.js:22

Parameters:

  • value Any
  • options Object
    • presence Boolean

      If true validates that the given value is not empty, if false, validates that the given value is empty.

    • ignoreBlank Boolean

      If true, treats an empty or whitespace string as not present

  • model Object
  • attribute String
value
(
  • model
  • attribute
)

Used to retrieve the value to validate. This method gets called right before validate and the returned value gets passed into the validate method.

Parameters:

Returns:

The current value of model[attribute]

_type

String private

Validator type

attribute

String

Attributed name of the model this validator is attached to

defaultOptions

Object

Default validation options for this specific attribute

errorMessages

Object

Error message object. Populated by validators/messages

globalOptions

Object

Global validation options for this model

isWarning

Boolean

model

Model

Model instance

options

Object

Options passed in to the validator when defined in the model