Nivel inicial4 min de lectura · Publicado el

Diferencia entre <% %> y <%= %> en Rails (ERB)

Diferencia entre <% %> y <%= %> en ERB: lo que se hace en la cocina no se ve; el plato que sale a la mesa se pinta en el HTML. ERB: si se ve, lleva =rubentejera.com <% %>se ejecuta, no se ve<%= %>sale en el HTML
<% %> es lo que se hace en la cocina, como pelar o cortar: ejecuta Ruby (un bucle, un if) y no muestra nada. <%= %> es el plato que sale a la mesa: pinta el resultado en el HTML. Si quieres que se vea, lleva =.

Las vistas de Rails (los ficheros .html.erb) mezclan HTML con trozos de Ruby. ERB (Embedded Ruby, Ruby incrustado) es el sistema que lo permite, y usa dos etiquetas casi iguales que hacen cosas distintas.

Piensa en un cocinero que sigue una receta. Hay pasos que haces en la cocina y nadie ve (pelar, cortar, mezclar): eso es <% %>. Y está el plato que sale a la mesa: eso es <%= %>.

Las dos etiquetas

Etiqueta Qué hace Se usa para
<% %> Ejecuta código Ruby Bucles (each), condiciones (if), asignar variables
<%= %> Ejecuta código Ruby y pinta el valor que devuelve en el HTML Mostrar datos: el título de un artículo, el nombre de un usuario, un enlace

Un ejemplo con las dos

<% @articles.each do |article| %>
  <h2><%= article.title %></h2>
<% end %>
  • El each y el end van con <% %>: organizan el bucle, pero no tienen nada que enseñar.
  • article.title va con <%= %>: es el dato que el usuario tiene que ver.

Si hay dos artículos, el HTML resultante queda así:

<h2>Uno</h2>
<h2>Dos</h2>

Los dos errores típicos

Usar <% %> cuando querías mostrar algo. El código se ejecuta, pero no aparece nada en la página y no hay ningún error que te avise:

<p><% article.title %></p>   <%# sale <p></p>, vacío %>

Usar <%= %> en un bucle o una condición. Rails pinta también el valor que devuelve el each, y puede aparecer en la página la lista entera de objetos.

Otras etiquetas ERB que te encontrarás

Etiqueta Qué hace
<%# %> Comentario: no se ejecuta ni se muestra
<%== %> Pinta el valor sin escapar el HTML (igual que <%= raw(...) %>)
<%- -%> Igual que <% %>, pero quita los espacios y saltos de línea de alrededor

Por qué importa el escapado

En Rails, <%= %> escapa el HTML: convierte < en &lt;, de modo que si un usuario escribe <script> en un comentario, se muestra como texto y no se ejecuta. Es una protección contra ataques XSS (inyección de código en tu página).

<%= "<b>hola</b>" %>    <%# sale &lt;b&gt;hola&lt;/b&gt;: se ve el texto con las etiquetas %>
<%== "<b>hola</b>" %>   <%# sale <b>hola</b>: se ve hola en negrita %>

Usa <%== o raw solo con HTML que hayas generado tú o que sea de confianza, nunca con lo que escribe un usuario.

Si sigues con las vistas, te servirán Edición de vistas en Ruby on Rails y Diferencias entre link_to, redirect_to y render.

Fuentes

  • Guía oficial de Rails: Action View Overview, sección ERB (Rails 8.1): <% %>, <%= %>, <%# %>, <%- -%> y que puts no pinta en la vista.
  • Ejecutado en Docker con ruby:3.4 (Ruby 3.4.12) y Action View 8.1.4.1: <% %> deja la etiqueta vacía, <%= %> escapa <b>hola</b> y <%== %> y raw lo pintan sin escapar, <%= %> en un each añade al final la lista entera (["Uno", "Dos"]), puts escribe en la consola y no en la página, y <%- -%> funciona como se describe.