Rails: ajax-валидация в стиле DRY

Постановка задачи

1. при валидации атрибутов использовать одну логику: как для бэка, так и для фронта
2. быстро «вешать» проверки на разные формы и гибко их настраивать (как логику, так и визуал)

Инструменты

Переходим к сути

• email — электронный адрес
• frequency — периодичность, с которой рассылка будет уходить на данный адрес

• наличие email обязательно
• email должен быть уникален
• email должен быть email (с собакой и прочими рюшечками)
• frequency не обязателен, но если есть, то должен быть в диапазоне от 1 до 7

class Email < ActiveRecord::Base

  before_save { self.email = email.downcase }

  VALID_EMAIL_REGEX = /\A[\w+\-.]+@[a-z\d\-.]+\.[a-z]+\z/i
  validates :email, presence: true,
            uniqueness: { case_sensitive: false },
            format: { with: VALID_EMAIL_REGEX }
  validates_inclusion_of :frequency, in: 1..7, allow_blank: true

end

class EmailsController < ApplicationController

  def new
    @email = Email.new
  end

  def create
    @email = Email.new(email_params)
    if @email.save
      flash[:success] = 'Email добавлен!'
      redirect_to emails_url
    else
      render :new
    end
  end

  private

    def email_params
      params.require(:email).permit(:email, :frequency)
    end

end

%h1 Новая почта
= form_for @email do |f|

  = render partial: 'shared/error_messages', locals: { object: f.object }

  %p= f.text_field :email, placeholder: 'Почта'
  %p= f.text_field :frequency, placeholder: 'Периодичность рассылки'
  %p= f.submit 'Добавить!'

Повторю ссылку на документацию к плагину, чтобы к ней больше не возвращаться. Там со структурированностью контента небольшая проблема, но информация вся есть.

jQuery ->
  validate_url = '/emails/validate'

  $('#new_email, [id^=edit_email_]').validate(
    debug: true
    rules:
      'email[email]':
        required: true
        remote:
          url: validate_url
          type: 'post'
      'email[frequency]':
        remote:
          url: validate_url
          type: 'post'
  )

• validate_url = '/emails/validate'
  адрес, на который будем отправлять ajax-запрос для проверки значений полей
• $('#new_email, [id^=edit_email_]').validate
  вешаем валидатор как на форму нового email, так и на форму редактирования уже существующих адресов
• debug: true
  метод отключает отправку формы, чтобы можно было развлекаться с настройками
• rules:
  в методе прописываются правила проверки для полей, у плагина их много из коробки (см. доки), но нас интересуют пока только 2
• 'email[email]':
  name–атрибут поля формы (простые имена указываются без кавычек, со специальными символами — берём в кавычки)

remote

remote:
  url: validate_url
  type: 'post'

• ответ true — означает, что с полем всё ок
• ответы false, undefined или null, а также любая другая string'а — расцениваются методом как сигнал провальной валидации

required

required: true

Продолжаем

• нужно создать метод в контроллере, который будет обрабатывать запрос
• прописать роут к этому методу

  def validate
    # пока пустой
  end

resources :emails
post 'emails/validate', to: 'emails#validate', as: :emails_validation

Started POST "/emails/validate" for 127.0.0.1 at 2014-02-17 22:10:31 +0000
Processing by EmailsController#validate as JSON
  Parameters: {"email"=>{"frequency"=>"что-нибудь"}}

• из прилетевшего в контроллер json, мы создадим в памяти новый объект Email
• и дёрнем его валидацию через ActiveModel
• в памяти нарисуется объект класса ActiveModel::Errors (доступный через метод errors), в котором будет хэш @messages — либо с ошибками (если атрибуты не прошли валидацию), либо пустой (если с объектом всё хорошо)
• мы разберём этот хэш и, если он пустой — ответим браузеру true, а если в нём есть ошибки для проверяемого атрибута — ответим текстом этих ошибок, что будет расценено принимающим методом плагина как провальная валидация. И, более того, плагин использует полученную стрингу как текст сообщения об ошибке.

ru:
  activerecord:
    attributes:
      email:
        email: "Почта"
        frequency: "Периодичность"
    errors:
      models:
        email:
          attributes:
            email:
              blank: "обязательна"
              taken: "уже добавлена в список рассылки"
              invalid: "имеет странный формат"
            frequency:
              inclusion: "должна быть в диапазоне от 1 до 7 включительно"

О I18n читаем в гайдах Rails: http://guides.rubyonrails.org/i18n.html

def validate
  email = Email.new(email_params)
  email.valid?

  field = params[:email].first[0]
  @errors = email.errors[field]

  if @errors.empty?
    @errors = true
  else
    name = t("activerecord.attributes.email.#{field}")
    @errors.map! { |e| "#{name} #{e}<br />" }
  end

  respond_to do |format|
    format.json { render json: @errors }
  end
end

email = Email.new(email_params)
email.valid?

(rdb:938) email.errors
#=> #<ActiveModel::Errors:0x007fbbe378dfb0 @base=#<Email id: nil, email: nil, frequency: "что-нибудь", created_at: nil, updated_at: nil>, @messages={:email=>["обязательна", "имеет странный формат"], :frequency=>["должна быть в диапазоне от 1 до 7 включительно"]}>

(rdb:938) email.errors['frequency']
#=> ["должна быть в диапазоне от 1 до 7 включительно"]

# так выглядит хэш
(rdb:938) params
#=> {"email"=>{"frequency"=>"что-нибудь"}, "controller"=>"emails", "action"=>"validate"}

# нам известно название модели, поэтому достаём атрибуты
(rdb:938) params[:email]
#=> {"frequency"=>"что-нибудь"}

# поскольку за запрос улетает всегда один атрибут, то забираем первый
(rdb:938) params[:email].first
#=> ["frequency", "что-нибудь"]

# на первом месте всегда будет ключ, то есть имя атрибута -> забираем
(rdb:938) params[:email].first[0]
#=> "frequency"

field = params[:email].first[0]
@errors = email.errors[field]

if @errors.empty?
  @errors = true
else
  name = t("activerecord.attributes.email.#{field}")
  @errors.map! { |e| "#{name} #{e}<br />" }
end

• если мы отдадим его как просто @errors, то получим сообщение «должна быть в диапазоне от 1 до 7 включительно» (а если их будет несколько, то они вобще «слипнутся» при выводе)

• вытаскиваем имя атрибута модели из файла локализации рельс:
  name = t("activerecord.attributes.email.#{field}")
• и в каждый элемент массива с ошибками добавляем это имя в начало с пробелом:
  @errors.map! { |e| "#{name} #{e}
" }
• можно ещё и br в конце каждой ошибки прилепить, зависит от вёрстки, короче добавлять по вкусу

respond_to do |format|
  format.json { render json: @errors }
end

Рефакторим

Роутинг

# было
post 'emails/validate', to: 'emails#validate', as: :emails_validation

# чтобы не переписывать маршрут для каждого контроллера
post ':controller/validate', action: 'validate', as: :validate_form

Метод валидации

def validator(object)
  object.valid?
  model = object.class.name.underscore.to_sym
  field = params[model].first[0]
  @errors = object.errors[field]

  if @errors.empty?
    @errors = true
  else
    name = t("activerecord.attributes.#{model}.#{field}")
    @errors.map! { |e| "#{name} #{e}<br />" }
  end
end

def validate
  email = Email.new(email_params)
  validator(email)
  respond_to do |format|
    format.json { render json: @errors }
  end
end