kotovalexarian-likes-github/rails--rails
1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00
Code Releases Activity

Minor doc changes to active_model/validations/confirmation.rb

Browse source
This commit is contained in:
Rizwan Reza 2010-06-15 22:17:06 +04:30
parent 6907bfe1ab
commit d896d8fa20
1 changed files with 27 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

40
activemodel/lib/active_model/validations/confirmation.rb
View file

@ -1,4 +1,6 @@
module ActiveModel module ActiveModel
# == Active Model Confirmation Validator
module Validations module Validations
class ConfirmationValidator < EachValidator class ConfirmationValidator < EachValidator
def validate_each(record, attribute, value) def validate_each(record, attribute, value)
@ -13,33 +15,45 @@ module ActiveModel
end end
module HelperMethods module HelperMethods
# Encapsulates the pattern of wanting to validate a password or email address field with a confirmation. Example: # Encapsulates the pattern of wanting to validate a password or email
# address field with a confirmation. For example:
# #
# Model: # Model:
# class Person < ActiveRecord::Base # class Person < ActiveRecord::Base
# validates_confirmation_of :user_name, :password # validates_confirmation_of :user_name, :password
# validates_confirmation_of :email_address, :message => "should match confirmation" # validates_confirmation_of :email_address,
# :message => "should match confirmation"
# end # end
# #
# View: # View:
# <%= password_field "person", "password" %> # <%= password_field "person", "password" %>
# <%= password_field "person", "password_confirmation" %> # <%= password_field "person", "password_confirmation" %>
# #
# The added +password_confirmation+ attribute is virtual; it exists only as an in-memory attribute for validating the password. # The added +password_confirmation+ attribute is virtual; it exists only
# To achieve this, the validation adds accessors to the model for the confirmation attribute. NOTE: This check is performed # as an in-memory attribute for validating the password. To achieve this,
# only if +password_confirmation+ is not +nil+, and by default only on save. To require confirmation, make sure to add a presence # the validation adds accessors to the model for the confirmation
# check for the confirmation attribute: # attribute.
#
# NOTE: This check is performed only if +password_confirmation+ is not
# +nil+, and by default only on save. To require confirmation, make sure
# to add a presence check for the confirmation attribute:
# #
# validates_presence_of :password_confirmation, :if => :password_changed? # validates_presence_of :password_confirmation, :if => :password_changed?
# #
# Configuration options: # Configuration options:
# * <tt>:message</tt> - A custom error message (default is: "doesn't match confirmation"). # * <tt>:message</tt> - A custom error message (default is: "doesn't match
# * <tt>:on</tt> - Specifies when this validation is active (default is <tt>:save</tt>, other options <tt>:create</tt>, <tt>:update</tt>). # confirmation").
# * <tt>:if</tt> - Specifies a method, proc or string to call to determine if the validation should # * <tt>:on</tt> - Specifies when this validation is active (default is
# occur (e.g. <tt>:if => :allow_validation</tt>, or <tt>:if => Proc.new { |user| user.signup_step > 2 }</tt>). The # <tt>:save</tt>, other options <tt>:create</tt>, <tt>:update</tt>).
# method, proc or string should return or evaluate to a true or false value. # * <tt>:if</tt> - Specifies a method, proc or string to call to determine
# * <tt>:unless</tt> - Specifies a method, proc or string to call to determine if the validation should # if the validation should occur (e.g. <tt>:if => :allow_validation</tt>,
# not occur (e.g. <tt>:unless => :skip_validation</tt>, or <tt>:unless => Proc.new { |user| user.signup_step <= 2 }</tt>). The # or <tt>:if => Proc.new { |user| user.signup_step > 2 }</tt>). The
# method, proc or string should return or evaluate to a true or false
# value.
# * <tt>:unless</tt> - Specifies a method, proc or string to call to
# determine if the validation should not occur (e.g.
# <tt>:unless => :skip_validation</tt>, or
# <tt>:unless => Proc.new { |user| user.signup_step <= 2 }</tt>). The
# method, proc or string should return or evaluate to a true or false value. # method, proc or string should return or evaluate to a true or false value.
def validates_confirmation_of(*attr_names) def validates_confirmation_of(*attr_names)
validates_with ConfirmationValidator, _merge_attributes(attr_names) validates_with ConfirmationValidator, _merge_attributes(attr_names)