diff options
| author | Justin Weiss <justin@uberweiss.org> | 2014-08-05 13:13:40 -0700 |
|---|---|---|
| committer | Justin Weiss <justin@uberweiss.org> | 2014-08-05 13:13:40 -0700 |
| commit | 2bb0abbec0e4abe843131f188129a1189b1bf714 (patch) | |
| tree | 936e517733580f5b2839d88680eaa701b2519d6d /activemodel/lib/active_model/validations/with.rb | |
| parent | b89c5a043e81298527f369fdb5fc83eb1f290dfe (diff) | |
| download | rails-2bb0abbec0e4abe843131f188129a1189b1bf714.tar.gz rails-2bb0abbec0e4abe843131f188129a1189b1bf714.tar.bz2 rails-2bb0abbec0e4abe843131f188129a1189b1bf714.zip | |
Add a note on custom validation contexts.
The documentation on `:on` for validations was inconsistent, and most
only referenced the `:create` and `:update` contexts. I fixed those to
be consistent with the documentation on `AM::Validations.validates`,
which seemed to have the best docs.
[ci skip]
Diffstat (limited to 'activemodel/lib/active_model/validations/with.rb')
| -rw-r--r-- | activemodel/lib/active_model/validations/with.rb | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/activemodel/lib/active_model/validations/with.rb b/activemodel/lib/active_model/validations/with.rb index ff41572105..a2531327bf 100644 --- a/activemodel/lib/active_model/validations/with.rb +++ b/activemodel/lib/active_model/validations/with.rb @@ -52,8 +52,11 @@ module ActiveModel # end # # Configuration options: - # * <tt>:on</tt> - Specifies when this validation is active - # (<tt>:create</tt> or <tt>:update</tt>). + # * <tt>:on</tt> - Specifies the contexts where this validation is active. + # Runs in all validation contexts by default (nil). You can pass a symbol + # or an array of symbols. (e.g. <tt>on: :create</tt> or + # <tt>on: :custom_validation_context</tt> or + # <tt>on: [:create, :custom_validation_context]</tt>) # * <tt>:if</tt> - Specifies a method, proc or string to call to determine # if the validation should occur (e.g. <tt>if: :allow_validation</tt>, # or <tt>if: Proc.new { |user| user.signup_step > 2 }</tt>). |