instance method
validates_exclusion_of
Ruby on Rails 8.1.2
Since v3.0.20Signature
validates_exclusion_of(*attr_names)
Validates that the value of the specified attribute is not in a particular enumerable object.
class Person < ActiveRecord::Base validates_exclusion_of :username, in: %w( admin superuser ), message: "You don't belong here" validates_exclusion_of :age, in: 30..60, message: 'This site is only for under 30 and over 60' validates_exclusion_of :format, in: %w( mov avi ), message: "extension %{value} is not allowed" validates_exclusion_of :password, in: ->(person) { [person.username, person.first_name] }, message: 'should not be the same as your username or first name' validates_exclusion_of :karma, in: :reserved_karmas end
Configuration options:
-
:in- An enumerable object of items that the value shouldn’t be part of. This can be supplied as a proc, lambda, or symbol which returns an enumerable. If the enumerable is a numerical, time, or datetime range the test is performed withRange#cover?, otherwise withinclude?. When using a proc or lambda the instance under validation is passed as an argument. -
:within- A synonym(or alias) for:inRange#cover?, otherwise withinclude?. -
:message- Specifies a custom error message (default is: “is reserved”).
There is also a list of default options supported by every validator: :if, :unless, :on, :allow_nil, :allow_blank, and :strict. See ActiveModel::Validations::ClassMethods#validates for more information.
Parameters
-
attr_namesrest
Source
# File activemodel/lib/active_model/validations/exclusion.rb, line 44
def validates_exclusion_of(*attr_names)
validates_with ExclusionValidator, _merge_attributes(attr_names)
end
Defined in activemodel/lib/active_model/validations/exclusion.rb line 44
· View on GitHub
· Improve this page
· Find usages on GitHub
Defined in ActiveModel::Validations::HelperMethods