How to create a super basic search form in Ruby on Rails
Tags: ruby, rails, webdev, programming
Published: 2023-05-23 02:14:38

> TL; DR: Seriously, this form implementation is incredibly easy

---

### Situation

How to create a super basic search form in Ruby on Rails.

The following picture is a snapshot of an example.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/5qh1n9a9ql2e3wzso23a.png)



---

### Context

Let's consider a Product model with a title attribute.

---

### Search form

```ruby
<%= form_tag('/products', method: 'get', local: true) do %>
  <%= text_field_tag(:search) %>
  <%= submit_tag("Search") %>
<% end %>
```

`form_tag` is a helper method provided by Rails for creating HTML forms.

`'/products'` is the URL or path to which the form will be submitted. The `'/products` url is due to the index route.

`local: true` is an optional parameter that specifies whether the form should be processed locally (within the same controller) or sent to a different controller for processing. In this case, local: true indicates that the form will be processed by the same controller.

---

### Search method

Add a search method to the desired model.

```ruby
# app/models/product.rb
def self.search(search)
  if search 
      where(["title LIKE ?","%#{search}%"])
  else
      all
  end
end
```

The purpose of this code is to perform a search operation on the model's associated table based on the provided search query.

If `search` does not have a value (i.e., it is nil or false), it executes the code block inside the else statement. The keyword `all` is an ActiveRecord query method that retrieves all records from the associated table.

---

### Search class method call

Add the search method inside the controller.

```ruby
# app/controllers/products_controller.rb
  def index
    @products = Product.search(params[:search])  

    respond_to do |format|
      format.html # index.html.erb
      format.json { render json: @products }
    end
  end
```

`Product.search(params[:search])` calls the search class method on the Product model, passing `params[:search]` as an argument. It performs a search operation based on the provided search query.

`params[:search]` retrieves the value of the search parameter from the request parameters. It represents the search query entered by the user.

---

### Test it


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/zlpytl2zdjvk29tk8v0e.png)



---

### Solution notes

This solution does not adhere to solid design principles and may not be suitable for large-scale projects, as it lacks a focus on reusability.

When working with Rails forms, it is recommended to follow best practices for enterprise projects, such as utilizing form objects, query objects, and adopting filterable approaches using solid principles.

---

### Conclusion

In conclusion, this article has demonstrated how to create a super basic search form in Ruby on Rails.

By following the step-by-step guide, you have learned the essential components and techniques needed to implement a basic search functionality in your Rails application.

---

### Let's stay connected

* [Github](https://github.com/alexcalaca)    
* [LinkedIn](https://linkedin.com/in/alexandrecalacaofficial)    
* [Dev.To](https://dev.to/@alexandrecalaca)    
* [Youtube](https://www.youtube.com/@alexandrecalacaofficial)
    

---

### Final thoughts

I hope this article helped you. Let me know if you have any questions.

Your thoughts, suggestions and corrections are more than welcome.

By the way, feel free to drop your suggestions on new blog articles.

Hope to see you next time.

---