Search Forms — Ruby: Реальный Rails

Программа урока

• Создание поисковых форм с Ransack
• Предикаты Ransack
• Сортирующие ссылки
• Интеграция Ransack с SimpleForm
• Интеграция Ransack с I18n

require_relative 'boot'

# В config/application.rb добавляем работу с SimpleForm
ENV['RANSACK_FORM_BUILDER'] = '::SimpleForm::FormBuilder'

require 'rails/all'

class PeopleController < ApplicationController
  def index
    @q = Person.ransack(params[:q])
    @people = @q.result
  end
end

# Можем использовать хелпер формы. Однако этот хелпер не может подтягивать стили Bootstrap, поэтому классы и лейблы нужно писать самим
# Если в конфиге подключен Simpleform для ransack, используем его
= search_form_for @q do |f|
  .row.my-2
    .col-5
    # Можем отключить показ лейблов
    # Ransack ищет по полям в БД
    # Для фильтров необходимо использовать определенные имена. Например, Если поле "содержит" текст, то имя инпута формы - column_cont
      https://github.com/activerecord-hackery/ransack#search-matchers
      = f.input :name_cont, label: false
    .col-4
      # Для вывода списка состояний можно выполнить map() на списке состояний.
      = f.input :aasm_state_eq, as: :select, collection: Post.aasm.states.map(&:name), label: false
    .col-3
      = f.submit 'Search', class: 'btn btn-primary me-2'
      = link_to 'Reset', url_for, class: 'btn btn-outline-primary'

class User < ApplicationRecord
  include AASM

  validates :name, presence: true

  def self.ransackable_attributes(_auth_object = nil)
    %w[name]
  end
end

Самостоятельная работа

Создайте Rails-проект, если его еще у вас нет.

• Подключите в Gemfile гем ransack:

  gem 'ransack'
  

• Добавьте обработчик SimpleForm для Ransack:

  ENV['RANSACK_FORM_BUILDER'] = '::SimpleForm::FormBuilder'
  

• Добавьте модель Пользователя, еще ее еще нет. У пользователя должны быть с поля имя, почта и признак администратора (булево значение)

• Добавьте раздел для управления пользователями. На страницу списка пользователей добавьте поиск по полям.

Дополнительные материалы

1. Гем Ransack
2. Ransack — Search Matchers
3. hexlet-cv - пример проекта с поисковыми формами