Skip to content

Commit

Permalink
move the tips about :allow_(nil|blank) near their explanations, also …
Browse files Browse the repository at this point in the history
…no need to say these are options for all validators if they are not
  • Loading branch information
fxn committed Mar 14, 2011
1 parent 9b64399 commit de5e41f
Showing 1 changed file with 5 additions and 3 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -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+

Expand All @@ -476,6 +474,8 @@ class Coffee < ActiveRecord::Base
end
</ruby>

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.
Expand All @@ -489,6 +489,8 @@ Topic.create("title" => "").valid? # => true
Topic.create("title" => nil).valid? # => true
</ruby>

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.
Expand Down

0 comments on commit de5e41f

Please sign in to comment.