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 +)@((?:[-a-z0-9]+.)+[az]{2,})z /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,可以在新 BSD 许可证下自由分发。请参阅LICENSE.md
文件。
Mirego 是一个充满激情的团队,他们相信工作是一个可以创新和享受乐趣的地方。我们是一个由才华横溢的团队组成的团队,他们致力于想象并构建精美的 Web 和移动应用程序。我们聚集在一起分享想法并改变世界。
我们也热爱开源软件,并尽力回馈社区。