Nivel inicial9 min de lectura · Publicado el

Edición de vistas en Ruby on Rails: ERB y parciales

Vistas parciales en Rails: la pieza _form.html.erb encaja en new.html.erb y en edit.html.erb, y render la coloca. Una parcial, dos vistasrubentejera.com _form.html.erbnew.html.erb_formedit.html.erb_form<%= render "form", course: @course %>
La parcial _form.html.erb es una pieza de un juego de construcción que encaja en dos montajes: new.html.erb, para crear, y edit.html.erb, para editar. render la coloca; si cambias la pieza, cambian las dos vistas.

Has añadido una columna nueva a la base de datos, por ejemplo description en la tabla de cursos, pero no aparece en ninguna pantalla. Rails no cambia las vistas solo: hay que tocar tres sitios.

  1. La vista que muestra el dato.
  2. El formulario parcial que lo crea y lo edita.
  3. La lista de parámetros permitidos del controlador.

1. Averigua qué vista se está mostrando

Haz la petición en el navegador y mira el log del servidor. La línea Rendering te dice qué fichero ha usado:

Started GET "/courses" for 127.0.0.1 at 2018-07-30 10:52:40 +0100
   (0.1ms)  SELECT "schema_migrations"."version" FROM "schema_migrations" ORDER BY "schema_migrations"."version" ASC
  ↳ ~/.rbenv/versions/2.5.1/lib/ruby/gems/2.5.0/gems/activerecord-5.2.0/lib/active_record/log_subscriber.rb:98
Processing by CoursesController#index as HTML
  Rendering courses/index.html.erb within layouts/application
  Course Load (0.2ms)  SELECT "courses".* FROM "courses"
  ↳ app/views/courses/index.html.erb:14
  Rendered courses/index.html.erb within layouts/application (8.8ms)
Completed 200 OK in 186ms (Views: 178.0ms | ActiveRecord: 0.9ms)

En la vista index.html.erb todavía no aparece el campo description:

<p id="notice"><%= notice %></p>

<h1>Courses</h1>

<table>
  <thead>
    <tr>
      <th>Title</th>
      <th colspan="3"></th>
    </tr>
  </thead>

  <tbody>
    <% @courses.each do |course| %>
      <tr>
        <td><%= course.title %></td>
        <td><%= link_to 'Show', course %></td>
        <td><%= link_to 'Edit', edit_course_path(course) %></td>
        <td><%= link_to 'Destroy', course, method: :delete, data: { confirm: 'Are you sure?' } %></td>
      </tr>
    <% end %>
  </tbody>
</table>

<br>

<%= link_to 'New Course', new_course_path %>

2. Añade el campo a la vista

Añade una cabecera y una celda para la descripción (las líneas con Description y course.description):

<p id="notice"><%= notice %></p>

<h1>Courses</h1>

<table>
  <thead>
    <tr>
      <th>Title</th>
      <th>Description</th>
      <th colspan="3"></th>
    </tr>
  </thead>

  <tbody>
    <% @courses.each do |course| %>
      <tr>
        <td><%= course.title %></td>
        <td><%= course.description %></td>
        <td><%= link_to 'Show', course %></td>
        <td><%= link_to 'Edit', edit_course_path(course) %></td>
        <td><%= link_to 'Destroy', course, method: :delete, data: { confirm: 'Are you sure?' } %></td>
      </tr>
    <% end %>
  </tbody>
</table>

<br>

<%= link_to 'New Course', new_course_path %>

3. Edita la vista parcial del formulario

Al abrir la página de editar (o la de crear), el log muestra dos ficheros en vez de uno:

Started GET "/courses/2/edit" for 127.0.0.1 at 2018-07-30 12:01:38 +0100
Processing by CoursesController#edit as HTML
  Parameters: {"id"=>"2"}
  Course Load (0.2ms)  SELECT  "courses".* FROM "courses" WHERE "courses"."id" = ? LIMIT ?  [["id", 2], ["LIMIT", 1]]
  ↳ app/controllers/courses_controller.rb:69
  Rendering courses/edit.html.erb within layouts/application
  Rendered courses/_form.html.erb (20.0ms)
  Rendered courses/edit.html.erb within layouts/application (22.2ms)

Es porque crear y editar comparten el mismo formulario. Las vistas parciales son trozos de vista que se reutilizan en varias páginas, como una pieza de un juego de construcción que encaja en varios montajes. Se reconocen porque su nombre empieza por guion bajo: _form.html.erb.

Añade el campo description al formulario, con un bloque div nuevo debajo del de title:

<%= form_with(model: course, local: true) do |form| %>
  <% if course.errors.any? %>
    <div id="error_explanation">
      <h2><%= pluralize(course.errors.count, "error") %> prohibited this course from being saved:</h2>

      <ul>
      <% course.errors.full_messages.each do |message| %>
        <li><%= message %></li>
      <% end %>
      </ul>
    </div>
  <% end %>

  <div class="field">
    <%= form.label :title %>
    <%= form.text_field :title %>
  </div>

  <div class="field">
    <%= form.label :description %>
    <%= form.text_area :description %>
  </div>

  <div class="actions">
    <%= form.submit %>
  </div>
<% end %>

Desde una vista, una parcial se carga con render:

<%= render "form", course: @course %>

4. Permite el campo en el controlador

Rails no acepta cualquier dato que llegue en una petición. En el controlador hay una lista de los parámetros permitidos (una lista blanca), y lo que no esté en ella se descarta. Si no añades description, el formulario se envía, pero el campo no se guarda.

Antes:

    # Use callbacks to share common setup or constraints between actions.
    def set_course
      @course = Course.find(params[:id])
    end

    # Never trust parameters from the scary internet, only allow the white list through.
    def course_params
      params.require(:course).permit(:title)
    end
end

Después:

    # Use callbacks to share common setup or constraints between actions.
    def set_course
      @course = Course.find(params[:id])
    end

    # Never trust parameters from the scary internet, only allow the white list through.
    def course_params
      params.require(:course).permit(:title, :description)
    end
end

En Rails 8 el scaffold usa params.expect, que hace lo mismo con una sintaxis más corta y, además, rechaza los parámetros que no tienen la forma esperada:

def course_params
  params.expect(course: [ :title, :description ])
end

Lo tienes explicado con más detalle en Strong params: seguridad de parámetros en Rails.

Código Ruby en las vistas: etiquetas ERB

Las vistas .html.erb son HTML con trozos de Ruby dentro. Si es la primera vez que ves código Ruby, empieza por qué es Ruby. Cada etiqueta hace una cosa distinta:

Etiqueta Qué hace Ejemplo
<% %> Ejecuta el código, pero no muestra nada Bucles y condiciones
<%= %> Ejecuta el código y muestra el resultado en la página <%= course.title %>
<%# %> Comentario: no se ejecuta ni se muestra <%# pendiente %>

Por ejemplo, este bucle usa <% %> para recorrer la lista y <%= %> para mostrar cada número:

<% [1, 2, 3, 4].each do |numero| %>
  <p>Número: <%= numero %></p>
<% end %>

Y este es el HTML que genera, con Erubi, el motor de plantillas que usa Rails. Las líneas con <% %> desaparecen y solo quedan los párrafos:

  <p>Número: 1</p>
  <p>Número: 2</p>
  <p>Número: 3</p>
  <p>Número: 4</p>

Lo mismo en Rails 8.1

El proceso es el mismo, pero el scaffold genera otros ficheros. Si lo creas hoy con bin/rails generate scaffold Course title:string y después añades la columna con bin/rails generate migration AddDescriptionToCourses description:text, el log del listado ya no apunta solo a index.html.erb:

Processing by CoursesController#index as HTML
  Rendering layout layouts/application.html.erb
  Rendering courses/index.html.erb within layouts/application
  Course Load (1.0ms)  SELECT "courses".* FROM "courses" /*action='index',application='Demo',controller='courses'*/
  ↳ app/views/courses/index.html.erb:9
  Rendered courses/_course.html.erb (Duration: 0.3ms | GC: 0.0ms)
  Rendered courses/index.html.erb within layouts/application (Duration: 9.2ms | GC: 0.0ms)
  Rendered layout layouts/application.html.erb (Duration: 19.6ms | GC: 0.0ms)
Completed 200 OK in 39ms (Views: 22.6ms | ActiveRecord: 1.8ms (1 query, 0 cached) | GC: 1.6ms)

La línea que importa es Rendered courses/_course.html.erb: el listado ya no es una tabla, sino que index.html.erb llama a render course para cada curso, y esa parcial pinta cada uno. La misma parcial se usa en la página de detalle (show.html.erb), así que con un solo cambio el campo aparece en los dos sitios.

1. La parcial de cada curso, app/views/courses/_course.html.erb, con el bloque nuevo de Description:

<div id="<%= dom_id course %>">
  <div>
    <strong>Title:</strong>
    <%= course.title %>
  </div>

  <div>
    <strong>Description:</strong>
    <%= course.description %>
  </div>

</div>

2. El formulario, app/views/courses/_form.html.erb, con un campo de texto largo debajo del título. En Rails 8 el método se llama form.textarea (antes, form.text_area, que sigue funcionando):

  <div>
    <%= form.label :title, style: "display: block" %>
    <%= form.text_field :title %>
  </div>

  <div>
    <%= form.label :description, style: "display: block" %>
    <%= form.textarea :description %>
  </div>

3. Los parámetros permitidos, en el controlador, con params.expect:

def course_params
  params.expect(course: [ :title, :description ])
end

Compruébalo con un test

Para saber que los tres cambios encajan, no hace falta abrir el navegador. Este test de integración envía el formulario y mira si la descripción sale en el listado:

require "test_helper"

class CourseDescriptionTest < ActionDispatch::IntegrationTest
  test "la descripción se guarda desde el formulario y se ve en el listado" do
    post courses_url, params: { course: { title: "Rails", description: "Curso de iniciación" } }
    get courses_url

    assert_response :success
    assert_dom "#courses", text: /Curso de iniciación/
  end
end
bin/rails test test/controllers/course_description_test.rb
Running 1 tests in a single process (parallelization threshold is 50)
Run options: --seed 37443

# Running:

.

Finished in 0.096305s, 10.3837 runs/s, 31.1512 assertions/s.
1 runs, 3 assertions, 0 failures, 0 errors, 0 skips

Lo útil es escribirlo antes de tocar nada: no pasará hasta que estén la migración, la vista y los parámetros permitidos, y por el camino te encontrarás los dos primeros errores de la lista siguiente. Ten en cuenta que el test envía los datos directamente, sin pasar por el formulario; para probar el formulario tal y como lo usa una persona, en un navegador, están los tests de sistema de Rails.

Errores frecuentes

1. Mostrar un campo que aún no existe en la base de datos. Si añades course.description a la vista antes de crear y ejecutar la migración, la página da un error:

ActionView::Template::Error: undefined method 'description' for an instance of Course
    app/views/courses/_course.html.erb:9

2. Olvidar el campo en los parámetros permitidos. Con la migración hecha, el formulario se envía sin error, pero la descripción no se guarda. Con params.expect el campo se descarta en silencio, sin ningún aviso en el log, así que solo lo ves porque el test falla:

--- expected
+++ actual
@@ -1 +1 @@
-/Curso de iniciación/
+"Title: MyString Description: Show this course Title: MyString Description: Show this course Title: Rails Description: Show this course"

El curso «Rails» se ha creado, pero con la descripción vacía. Añade :description a la lista de course_params.

3. Usar <%= en un bucle. El bucle va con <% %>. Si le pones el =, después de los párrafos aparece la lista entera, porque each devuelve el array y <%= lo muestra:

<%= [1, 2].each do |numero| %>
  <p><%= numero %></p>
<% end %>
  <p>1</p>

  <p>2</p>
[1, 2]

4. Olvidar el = al mostrar un valor. Lo contrario: <p><% course.title %></p> ejecuta el código, pero no muestra nada, y el resultado es <p></p>.

5. Llamar a una parcial con un nombre que no existe. render "courses/formulario" busca el fichero courses/_formulario.html.erb, con guion bajo, y si no lo encuentra:

ActionView::Template::Error: Missing partial courses/_formulario with {locale: [:en], formats: [:html, …], variants: [], handlers: [:raw, :erb, :html, :builder, :ruby, :jbuilder]}.

En render el nombre va sin el guion bajo y sin la extensión: render "form".

Qué código no va en una vista

Que una vista pueda ejecutar cualquier Ruby no significa que deba. Una vista con cálculos, consultas a la base de datos o muchos if anidados es difícil de leer y de probar.

  • Consultas: se hacen en el controlador (@courses = Course.all), no en la vista.
  • Reglas del negocio («¿está el curso completo?»): van en el modelo, como un método course.completo?.
  • Formato repetido (una fecha, un precio): va en un helper, en app/helpers, que se prueba aparte.

La vista se queda con lo suyo: decidir qué se muestra y dónde.

Ejercicio de cinco minutos

  1. En una aplicación de prueba, genera bin/rails generate scaffold Course title:string y copia el test de arriba. Ejecútalo y anota el error.
  2. Haz los cambios en este orden: la migración, la parcial _course.html.erb, el formulario y course_params. Ejecuta el test después de cada paso y fíjate en cuál lo pone en verde.
  3. Añade un segundo campo, level:integer, siguiendo el mismo camino. Para el formulario, usa form.number_field.

Para entender cuándo usar render y cuándo redirigir, sigue con Diferencias entre link_to, redirect_to y render. Y si dudas entre <% %> y <%= %>, tienes más ejemplos en diferencia entre <% %> y <%= %> en Rails.

Fuentes

Comprobado en noviembre de 2026 en las guías oficiales de Rails 8.1.4.1: Layouts and Rendering (parciales y su nombre con guion bajo), Action View Overview (etiquetas ERB), Action Controller Overview (params.expect) y Securing Rails Applications: Cross-Site Scripting (por qué hay que escapar lo que muestra la vista). El escape automático de <%= %> y las cadenas seguras (html_safe) se explican en Active Support Core Extensions: Output Safety.

Los logs y el código de los pasos 1 a 4 son de Rubén, con Rails 5.2. Todo lo de Rails 8.1 se ha ejecutado el 11 de noviembre de 2026 en Docker (imagen oficial ruby:3.4, Ruby 3.4.12, Rails 8.1.4.1 y SQLite): el scaffold, el log del listado, los tres cambios, el test y los errores, incluido el campo descartado en silencio por params.expect. El ejemplo de las etiquetas se ha ejecutado con Erubi 1.13.1, el motor de plantillas de Rails, en Ruby 3.4.12.