Browse files

move the tips about :allow_(nil|blank) near their explanations, also …

…no need to say these are options for all validators if they are not
  • Loading branch information...
1 parent 9b64399 commit de5e41f855a8d715d99eec6195f9b31cc4048b99 @fxn fxn committed Mar 14, 2011
Showing with 5 additions and 3 deletions.
  1. +5 −3 railties/guides/source/active_record_validations_callbacks.textile
8 railties/guides/source/active_record_validations_callbacks.textile
@@ -461,9 +461,7 @@ The block receives the model, the attribute's name and the attribute's value. Yo
h3. Common Validation Options
-There are some common options that all the validation helpers can use. Here they are, except for the +:if+ and +:unless+ options, which are discussed later in "Conditional Validation":#conditional-validation.
-TIP: Note that +allow_nil+ and +allow_blank+ will be ignored when using the presence validator. Please use the length validator if you want to validate if something is a specific length but allows for +nil+ values.
+These are common validation options:
h4. +:allow_nil+
@@ -476,6 +474,8 @@ class Coffee < ActiveRecord::Base
+TIP: +:allow_nil+ is ignored by the presence validator.
h4. +:allow_blank+
The +:allow_blank+ option is similar to the +:allow_nil+ option. This option will let validation pass if the attribute's value is +blank?+, like +nil+ or an empty string for example.
@@ -489,6 +489,8 @@ Topic.create("title" => "").valid? # => true
Topic.create("title" => nil).valid? # => true
+TIP: +:allow_blank+ is ignored by the presence validator.
h4. +:message+
As you've already seen, the +:message+ option lets you specify the message that will be added to the +errors+ collection when validation fails. When this option is not used, Active Record will use the respective default error message for each validation helper.

0 comments on commit de5e41f

Please sign in to comment.