Diferencia entre <% %> y <%= %> en Rails (ERB)
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
eachy elendvan con<% %>: organizan el bucle, pero no tienen nada que enseñar. article.titleva 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 <, 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 <b>hola</b>: 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 queputsno 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<%== %>yrawlo pintan sin escapar,<%= %>en uneachañade al final la lista entera (["Uno", "Dos"]),putsescribe en la consola y no en la página, y<%- -%>funciona como se describe.