Louche は、ActiveModel/ActiveRecord クラスに共通のバリデーターを追加します。
次の行をアプリケーションの Gemfile に追加します。
gem 'louche'
Louche は、ActiveModel/ActiveRecord クラスで使用するためのバリデーターをいくつか提供します。すべてのバリデーターは、プレフィックスの小文字のシンボルバージョンをキーとして、 true
を値として使用できます。たとえば、 EmailValidator
の場合:
class User < ApplicationRecord
validates :email , email : true
end
オプションで、デフォルトのオプションをカスタマイズしたい場合は、値としてハッシュを渡すことができます。
class User < ApplicationRecord
validates :email , email : { regex : /^.*@.*$/ , message : :blank }
end
Louche が提供するバリデーターとそれぞれのオプションは次のとおりです。
EmailValidator
class User < ApplicationRecord
validates :email , email : true
end
User . new ( email : '[email protected]' ) . valid? # => true
User . new ( email : 'foo@example' ) . valid? # => false
オプション | 説明 |
---|---|
:regex | 電子メールの検証に使用される正規表現 (デフォルト: /A([^@s]+)@((?:[-a-z0-9]+.)+[az]{2,})z/i ) |
:message | レコードエラーに追加された ActiveRecord メッセージ (デフォルト: :invalid_email ) |
URLValidator
class User < ApplicationRecord
validates :website , url : true
end
User . new ( website : 'http://example.com' ) . valid? # => true
User . new ( website : 'example.$$$' ) . valid? # => false
オプション | 説明 |
---|---|
:schemes | 許可する URI スキーム (デフォルト: %w(http https) ) |
:message | レコードエラーに追加された ActiveRecord メッセージ (デフォルト: :invalid_url ) |
PhoneNumberValidator
class User < ApplicationRecord
validates :phone_number , phone_number : true
end
user = User . new ( phone_number : '514 555-2525' )
user . valid? # => true
user . phone_number # => '5145552525'
user = User . new ( phone_number : '555-2525' )
user . valid? # => false
user . phone_number # '5552525'
オプション | 説明 |
---|---|
:regex | 数値の検証に使用される正規表現 (デフォルト: /Ad{10,}z/ ) |
:cleanup_regex | 入力を検証/保存する前に検証および消去するために使用される正規表現 (デフォルト: /[^d]/ ) |
:message | レコードエラーに追加された ActiveRecord メッセージ (デフォルト: :invalid_phone_number ) |
PostalCodeValidator
class User < ApplicationRecord
validates :postal_code , postal_code : true
end
user = User . new ( postal_code : 'G0R 2T0' )
user . valid? # => true
user . postal_code # => 'G0R2T0'
user = User . new ( postal_code : 'L -0- L' )
user . valid? # => false
user . postal_code # => 'L0L'
オプション | 説明 |
---|---|
:regex | コードの検証に使用される正規表現 (デフォルト: /A[az]d[az]d[az]dz/i ) |
:cleanup_regex | 入力を検証/保存する前に検証およびクリーンアップするために使用される正規表現 (デフォルト: /[^a-z0-9]/i ) |
:message | レコードエラーに追加された ActiveRecord メッセージ (デフォルト: :invalid_postal_code ) |
ArrayValidator
class Tag < Struct . new ( :name )
def valid?
name . present?
end
end
class User < ApplicationRecord
validates :tags , array : true
def tags = ( tags )
super tags . map { | tag | Tag . new ( tag ) }
end
end
User . new ( tags : [ 'food' , 'beer' , 'code' ] ) . valid? # => true
User . new ( tags : [ 'food' , '' , 'code' ] ) . valid? # => false
オプション | 説明 |
---|---|
:message | レコードエラーに追加された ActiveRecord メッセージ (デフォルト: :invalid_array ) |
:validity_method | 各配列項目に送信されるメソッド (デフォルト: :valid? ) |
RgbHexValidator
class Flag < ApplicationRecord
validates :color , rgb_hex : true
end
flag = Flag . new ( color : '#ff0000' )
flag . valid? # => true
flag . color # => '#ff0000'
flag = Flag . new ( color : '#zzzzzz' )
flag . valid? # => false
flag . color # => '#'
オプション | 説明 |
---|---|
:regex | コードの検証に使用される正規表現 (デフォルト: `/A#([a-f0-9]{6}) |
:cleanup_regex | 入力を検証/保存する前に検証およびクリーンアップするために使用される正規表現 (デフォルト: /[^#a-f0-9]/i ) |
:message | レコードエラーに追加された ActiveRecord メッセージ (デフォルト: :invalid_rgb_hex ) |
Louche は標準の ActiveRecord メッセージを使用します。 config/locales/activerecord.en.yml
ファイルは次のようになります。
en :
errors :
messages :
invalid_email : is not a valid email address
invalid_url : is not a valid URL
invalid_phone_number : is not a valid phone number
invalid_postal_code : is not a valid postal code
invalid_array : contains invalid items
invalid_rgb_hex : is not a valid color
Louche
は © 2014-2015 Mirego であり、New BSD ライセンスに基づいて自由に配布できます。 LICENSE.md
ファイルを参照してください。
Mirego は、仕事は革新をもたらし、楽しむことができる場所であると信じている情熱的な人々のチームです。私たちは、美しい Web アプリケーションやモバイル アプリケーションを想像し、構築する才能ある人々のチームです。私たちはアイデアを共有し、世界を変えるために団結します。
私たちはオープンソース ソフトウェアも大好きで、できる限りコミュニティに還元しようと努めています。