汎用的なバリデーション
適応バージョン
- 1.0.0
- 1.1.0
- 1.1.1
- 1.1.6
- 1.2.0
- 1.2.6
- 2.0.0
- 2.0.1
- 2.0.3
- 2.1.0
- 2.2.1
- 2.3.2
- 2.3.8
- 3.0.0
- 3.0.5
- 3.0.7
- 3.0.9
- 3.1.0
- 3.2.3
- 3.2.8
- 3.2.13
- 4.0.2
- 4.1.8
- 4.2.1
- 4.2.7
- 4.2.9
- 5.0.0.1
- 5.1.7
- 5.2.3
- 6.0.2.1
- 7.0.0
説明
汎用的なバリデーション
使い方
validates(フィールド名, 種類 [, オプション])
種類
| 種類 | 説明 |
|---|---|
| :acceptance | チェックボックスがオンになっているか |
| :confirmation | テキストフィールドが完全に一致するか |
| :exclusion | 含まれていないことをバリデーション |
| :format | 正規表現と一致するか |
| :inclusion | 含まれていることをバリデーション |
| :length | 長さをバリデーション |
| :numericality | 数値のみか |
| :presence | 空で無いこと |
| :absence | 空であること |
| :uniqueness | 重複していないこと |
オプション
| オプション | 説明 |
|---|---|
| :on | 実行するタイミング |
| :if | バリデーションする条件を指定 |
| :unless | バリデーションしない条件を指定 |
| :allow_nil | nilをスキップ |
| :allow_blank | nilや空文字をスキップ |
| :strict | 例外が発生するか |
| :message | 失敗したときに表示するメッセージ |
lengthのオプション
| オプション | 説明 |
|---|---|
| :minimum | この値より小さな値か |
| :maximum: | この値より大きな値が |
| :inまたは:within | 区間以内か |
| :is | 値と等か？ |
numericalityのオプション
| オプション | 説明 |
|---|---|
| :greater_than | 指定した値よりも大きいか |
| :greater_than_or_equal_to | 指定した値と等しいか、それよりも大きいか |
| :equal_to | 指定した値と等しいか |
| :less_than | 指定した値よりも小さいか |
| :less_than_or_equal_to | 指定した値と等しいか、それよりも小さいか |
| :other_than | 指定した値以外の値か |
| :odd | 奇数か |
| :even | 偶数か |
例
acceptance
チェックボックスがオンになっているか
validates :form, acceptance: true
チェックボックスがオフになっているか
validates :form, acceptance: false
confirmation
テキストフィールドが完全に一致するか
validates :email, confirmation: true
テキストフィールドが完全に一致しないか
validates :email, confirmation: false
exclusion
含まれていないか
validates :subdomain, exclusion: {in: %w(www us ca jp)}
format
正規表現と一致するか
validates :legacy_code, format: {with: /\A[a-zA-Z]+\z/}
inclusion
含まれていることをバリデーション
validates :size, inclusion: {in: %w(small medium large)}
length
長さをバリデーション
validates :name, length: {minimum: 2}
numericality
数値のみか
validates :points, numericality: true
presence
空で無いこと
validates :name, :login, :email, presence: true
absence
空であること
validates :name, :login, :email, absence: true
uniqueness
重複していないこと
validates :email, uniqueness: true