Referencia rápida

Chuleta de helpers de formularios de Rails

Guía de referencia rápida para helpers de formularios de Rails: form_with, enlace a modelos, campos de entrada, selects y protección CSRF.

· Publicado

Rails ofrece form_with para generar formularios vinculados a modelos ActiveRecord con protección integrada contra CSRF y convenciones RESTful.

Formularios vinculados a modelos (form_with)

<%= form_with model: @user do |f| %>
  <% if @user.errors.any? %>
    <div class="errors">
      <h2><%= pluralize(@user.errors.count, "error") %> prohibited saving:</h2>
      <ul>
        <% @user.errors.full_messages.each do |msg| %>
          <li><%= msg %></li>
        <% end %>
      </ul>
    </div>
  <% end %>

  <%= f.label :name, "Full Name" %>
  <%= f.text_field :name, class: "input-field" %>

  <%= f.label :email %>
  <%= f.email_field :email %>

  <%= f.label :password %>
  <%= f.password_field :password %>

  <%= f.submit "Create Account", class: "btn-primary" %>
<% end %>

Helpers de Entrada Comunes

Helper HTML Generado
f.text_field :title <input type="text">
f.email_field :email <input type="email">
f.number_field :age <input type="number">
f.date_field :born_on <input type="date">
f.text_area :bio <textarea>
f.check_box :active <input type="checkbox">
f.radio_button :role, "admin" <input type="radio">
f.file_field :avatar <input type="file">
f.hidden_field :token <input type="hidden">

Listas Desplegables (Selects)

<!-- Select de colección desde consulta ActiveRecord -->
<%= f.collection_select :category_id, Category.all, :id, :name, prompt: "Select category" %>

<!-- Lista estática de opciones -->
<%= f.select :role, [["Admin", "admin"], ["Member", "member"]], include_blank: true %>

Atributos Anidados (fields_for)

<%= form_with model: @author do |f| %>
  <%= f.text_field :name %>

  <%= f.fields_for :profile do |profile_fields| %>
    <%= profile_fields.text_field :twitter_handle %>
    <%= profile_fields.text_area :bio %>
  <% end %>

  <%= f.submit %>
<% end %>

Referencias

Temas relacionados