louche下載 - louche原始碼下載

louche

其他源碼

下載

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