Nivel inicial13 min de lectura · Publicado el

BEM CSS: convención de nombres para clases, con ejemplos

BEM en CSS: un monigote con flechas a sus clases: .stick-man es el bloque, .stick-man__head el elemento y .stick-man--blue el modificador. BEM: la clase dice qué esrubentejera.com .stick-manbloque.stick-man__headelemento.stick-man--bluemodificador
El monigote entero es el bloque; su cabeza, un elemento, con dos guiones bajos; y el color azul, un modificador, con dos guiones, que se añade a la clase base. Todas son selectores de una sola clase.

BEM en CSS es una convención de nombres para las clases: cada clase dice a qué componente pertenece, qué parte es y qué variante tiene. En un proyecto pequeño da igual cómo llames a las clases. Cuando crece, aparecen .title, .title2, .header .title y nadie sabe qué toca qué. Cambias un estilo y se rompe otra página.

BEM nombra las clases como las piezas de un monigote: el monigote entero es el bloque (.stick-man), su cabeza es un elemento (.stick-man__head) y el monigote azul, un modificador (.stick-man--blue). Con solo leer la clase sabes de qué pieza se trata.

Qué es BEM en CSS: bloque, elemento y modificador

La documentación oficial, en bem.info, define las tres piezas así (traducción nuestra):

  • Bloque: «un componente de la página funcionalmente independiente que se puede reutilizar». Una tarjeta, un menú, un formulario de búsqueda.
  • Elemento: «una parte compuesta de un bloque que no se puede usar por separado de él». El título de la tarjeta o un enlace del menú.
  • Modificador: «una entidad BEM que define la apariencia, el estado o el comportamiento de un bloque o de un elemento». La tarjeta destacada o el botón desactivado.
Pieza Cómo se escribe Ejemplo con el monigote Ejemplo con una tarjeta
Bloque Minúsculas, palabras separadas por guion .stick-man .card
Elemento bloque__elemento .stick-man__head .card__title
Modificador de bloque bloque--modificador .stick-man--blue .card--featured
Modificador de elemento bloque__elemento--modificador .stick-man__head--small .card__button--primary
Anatomía de card__button--primary: card es el bloque; dos guiones bajos separan el elemento, button, y dos guiones, el modificador, primary.
Un nombre BEM se lee de izquierda a derecha: primero el bloque, tras los dos guiones bajos el elemento y tras los dos guiones el modificador.

Un ejemplo de BEM en HTML y CSS

Una tarjeta de curso con título, texto y botón. La primera tarjeta es la destacada y su botón, el principal:

<article class="card card--featured">
  <h2 class="card__title">Curso de CSS</h2>
  <p class="card__text">Aprende a maquetar desde cero.</p>
  <button class="card__button card__button--primary">Apuntarme</button>
</article>

<article class="card">
  <h2 class="card__title">Curso de Git</h2>
  <p class="card__text">Control de versiones sin miedo.</p>
  <button class="card__button">Más información</button>
</article>
/* Bloque */
.card {
  padding: 1rem;
  border: 1px solid #ccc;
  border-radius: 8px;
}

/* Elementos */
.card__title {
  margin: 0 0 0.5rem;
  font-size: 1.25rem;
}

.card__button {
  background: #eee;
  color: #222;
}

/* Modificadores */
.card--featured {
  border-color: #f68b1f;
}

.card__button--primary {
  background: #f68b1f;
  color: #fff;
}

Al abrir la página en Google Chrome 157 y leer los estilos calculados de cada tarjeta, solo la primera recibe los cambios:

card 1: border rgb(246, 139, 31), botón rgb(246, 139, 31)
card 2: border rgb(204, 204, 204), botón rgb(238, 238, 238)

Fíjate en tres cosas:

  • El modificador se añade a la clase base, no la sustituye: card card--featured.
  • Todos los selectores son de una sola clase. No hace falta escribir .card .title, así que todos tienen la misma especificidad (el peso que decide qué regla gana) y es fácil sobrescribirlos.
  • El orden del HTML no importa. Si mañana metes el título dentro de un <header>, la clase card__title sigue valiendo.
Un buen nombre de clase te dice dónde vive y qué es.

Modificadores: booleanos y con valor

Según la convención de nombres de bem.info, hay dos tipos de modificador:

  • Booleanos: están o no están. card--featured, button--disabled.
  • Clave-valor: tienen un nombre y un valor. En el estilo de dos guiones, el valor va tras un guion bajo: button--size_s, button--size_l, card--theme_dark.

Un elemento puede tener varios modificadores a la vez, y cada uno va en su propia clase: class="card__button card__button--primary card__button--size_l".

Mezclas: un nodo, dos bloques

BEM llama mix (mezcla) a poner varias entidades BEM en el mismo nodo del HTML. Sirve, sobre todo, para colocar un bloque dentro de otro sin atarlos.

La documentación lo explica con una regla: un bloque no debe influir en su entorno, así que no se le pone margen exterior ni posición. Si el botón genérico de tu web tiene que ir con un margen dentro de la tarjeta, ese margen lo pone la tarjeta, con su propio elemento:

<article class="card">
  <h2 class="card__title">Curso de CSS</h2>
  <button class="button button--primary card__button">Apuntarme</button>
</article>

<button class="button">Suelto</button>
.button { padding: 0.5rem 1rem; border-radius: 4px; }  /* el botón, igual en toda la web */
.card__button { margin-top: 1rem; }                    /* dónde va dentro de la tarjeta */

En Chrome, el mismo bloque button lleva margen dentro de la tarjeta y ninguno fuera:

botón en la tarjeta: padding 8px, margin-top 16px
botón suelto: padding 8px, margin-top 0px

El botón se puede llevar a cualquier sitio, y la tarjeta decide dónde lo coloca.

BEM con CSS anidado nativo

Desde diciembre de 2023, los navegadores principales entienden CSS anidado sin herramientas: MDN lo marca como Baseline ampliamente disponible. El símbolo & representa el selector padre. Quien viene de Sass suele intentar esto:

.card {
  border: 1px solid #ccc;

  &--featured {
    border-color: #f68b1f;
  }

  &__button {
    color: #222;

    &--primary {
      color: #fff;
    }
  }
}

En Sass funciona: el compilador une los textos. Con Sass 1.108.1, la salida es:

.card {
  border: 1px solid #ccc;
}
.card--featured {
  border-color: #f68b1f;
}
.card__button {
  color: #222;
}
.card__button--primary {
  color: #fff;
}

En CSS nativo, no. La guía de MDN sobre el anidado lo dice expresamente: la concatenación no es posible, porque un selector anidado sin combinador se trata como un selector de tipo. Este CSS, sin compilar, se ha probado en Chrome 157:

.card {
  border: 1px solid #ccc;

  &:hover { border-color: #888; }

  /* Modificador del bloque: & seguido de otra clase */
  &.card--featured { border-color: rgb(246, 139, 31); }

  /* Elemento con un selector completo dentro del bloque */
  .card__title { color: rgb(0, 0, 255); }

  /* Concatenación al estilo Sass: NO funciona en CSS nativo */
  &__button { color: rgb(255, 0, 0); }
}

Al leer los estilos calculados y las reglas que el navegador ha aceptado:

card--featured, borde: rgb(246, 139, 31)
card__title, color: rgb(0, 0, 255)
card__button, color: rgb(0, 0, 0)
reglas anidadas que entiende el navegador: &:hover | &.card--featured | & .card__title

La regla &__button desaparece sin avisar y el botón se queda con su color por defecto. Con CSS nativo, entonces:

  • Estados y modificadores: &:hover, &.card--featured. Bien.
  • Elementos: escribe el nombre completo, .card__title, o mejor déjalo fuera del bloque. Anidado, el navegador lo convierte en .card .card__title: dos clases, más especificidad y justo el problema que BEM quería evitar (lo ves en el siguiente apartado).

Errores frecuentes con BEM

Nietos: bloque__elemento__elemento

Si el título está dentro del cuerpo de la tarjeta, es tentador escribir card__body__title. La documentación oficial es clara: «los elementos de elementos no existen en la metodología BEM» (traducción nuestra). Su ejemplo marca search-form__content__input como incorrecto y propone search-form__input o search-form__content-input.

El motivo, según sus preguntas frecuentes, es que los elementos de elementos dificultan cambiar la estructura interna del bloque: no se pueden mover, quitar ni añadir elementos sin tocar el código existente. Con card__body__title, el título no se puede sacar del cuerpo sin renombrar la clase. Si de verdad el cuerpo tiene tantas piezas que pide nombre propio, quizá es un bloque nuevo.

El modificador sin la clase base

<article class="card--featured">…</article>

bem.info lo dice así: «un modificador no se puede usar aislado del bloque o del elemento que modifica» (traducción nuestra). Al probarlo, la tarjeta pierde todos los estilos de .card; en este caso, el relleno:

solo modificador, padding: 0px

Selectores anidados que ganan al modificador

.card .card__title { color: rgb(34, 34, 34); }
.card__title--muted { color: rgb(136, 136, 136); }
<h2 class="card__title card__title--muted">Curso de CSS</h2>

El título debería verse gris claro, pero sale oscuro:

título con --muted, color: rgb(34, 34, 34)

.card .card__title tiene dos clases y .card__title--muted, una. Gana la de más peso, aunque esté antes. Las preguntas frecuentes de BEM permiten los selectores anidados, pero recomiendan usarlos lo mínimo. Tampoco recomiendan mezclar etiqueta y clase (h2.card__title), por el mismo motivo.

Margen o posición en el bloque

Un .button { margin-top: 1rem; } obliga a deshacer ese margen en cada sitio donde el botón no lo necesite. Va en el elemento del bloque que lo contiene, con una mezcla, como en card__button.

Clases solo para JavaScript: el prefijo js-

Si tu JavaScript busca .card__button y alguien renombra la clase al rehacer los estilos, el script deja de funcionar sin avisar. Una solución habitual es añadir una clase solo para JavaScript, con el prefijo js-, que nadie usa en el CSS:

<button class="card__button js-subscribe">Apuntarme</button>
const button = document.querySelector(".js-subscribe");

El artículo de referencia de freeCodeCamp

La versión original de esta entrada (2018) enlazaba a «CSS Naming Conventions that Will Save You Hours of Debugging», de Emmanuel Ohans, publicado en freeCodeCamp en enero de 2018. Es gratuito, está en inglés y sigue disponible. Recorre los nombres con guiones (.main-nav), BEM explicado con el monigote, por qué usar una convención, tres formas de enganchar JavaScript (las clases js-, que presenta primero; el atributo rel, que el autor dice no usar; y los atributos data-*, que desaconseja, aunque una nota posterior lo matiza) y un consejo final: comentar más el CSS.

Es útil para entender BEM en una lectura. No trata las mezclas, los errores frecuentes ni el CSS anidado nativo, que no existía cuando se escribió.

Cómo empezar a usar BEM

  1. Haz una lista de los componentes de tu página: cabecera, tarjeta, botón, formulario. Cada uno es un bloque.
  2. Dentro de cada bloque, nombra las piezas con __ y un solo nivel: .card__title, .card__image.
  3. Las variantes van con -- y siempre junto a la clase base: class="card card--featured".
  4. Una clase por regla: nada de .card .card__title ni de h2.card__title.
  5. Los márgenes y la posición de un bloque, en el elemento del bloque que lo contiene.
  6. Las clases que lee JavaScript, con js- y sin estilos.

Cuándo BEM se queda corto y qué alternativas hay

Los nombres se alargan, y en HTML con muchas variantes la lista de clases crece. Además, algunas herramientas ya resuelven el problema de fondo, que las clases de un componente choquen con las de otro:

Opción Qué hace Encaja si…
CSS Modules o estilos scoped de Vue y Svelte La herramienta renombra las clases de cada componente para que no choquen Trabajas con un bundler y componentes
@scope CSS nativo: limita unas reglas a un trozo del HTML Quieres aislar estilos sin herramientas; MDN lo marca como Baseline 2026, así que conviene revisar qué navegadores tienes que soportar
CSS de utilidades Clases pequeñas de una sola propiedad que se combinan en el HTML Prefieres no inventar nombres de clase

Con ellas, BEM deja de ser imprescindible, pero sigue ayudando a que los nombres se entiendan. Ninguna sustituye la idea de fondo: que el nombre explique qué es cada cosa.

Si generas CSS con IA

Un asistente de IA escribe CSS muy rápido, y sin una convención cada respuesta puede nombrar las clases a su manera. Dentro del enfoque IA Limpia, el criterio es el mismo que con el código: deja la convención escrita en las instrucciones del proyecto (por ejemplo, «BEM con __ y --, un nivel de elemento, sin selectores anidados, js- para JavaScript») y revisa que el resultado la cumpla, igual que harías en una revisión de código. Los errores de este artículo, como los nietos o &__elemento en CSS nativo, son fáciles de detectar en esa revisión.

Elegir buenos nombres es la misma idea que en el código: lo cuenta el capítulo de nombres con sentido de Código limpio. Si heredas un CSS sin convención, la charla Refactoring Legacy CSS de Carmen Ansio explica cómo ordenarlo. Y para practicar selectores, tienes el juego de selectores CSS.

Fuentes

Comprobado el 9 de noviembre de 2026:

  • Documentación oficial de BEM: Quick start (definiciones, mezclas, el bloque y su entorno, el modificador nunca solo, search-form__content__input), Naming convention (esquema clásico, «Two Dashes style», «React style», modificadores booleanos y clave-valor, «Elements of elements do not exist») y FAQ (selectores anidados, etiquetas con clases y por qué no hay elementos de elementos). La antigua dirección en.bem.info redirige a bem.info. La web divulgativa getbem.com ya no publica BEM: su dominio redirige a un servicio de venta de dominios.
  • MDN: Using CSS nesting (apartado «Concatenation (is not possible)», modificada el 21 de octubre de 2026), selector de anidado & (Baseline desde diciembre de 2023), especificidad y @scope (Baseline 2026, desde marzo de 2026).
  • Sass: Parent selector, apartado sobre añadir sufijos, que menciona BEM.
  • Emmanuel Ohans, «CSS Naming Conventions that Will Save You Hours of Debugging», freeCodeCamp, 16 de enero de 2018. El artículo original enlazaba su dirección antigua en medium.freecodecamp.org, que ahora redirige ahí. El segundo enlace del original (ombushop.com) ya no responde y se ha quitado.

Todos los ejemplos de HTML y CSS se han abierto en Google Chrome 157 sin interfaz, leyendo los estilos calculados con getComputedStyle; las salidas son las que dio. El de Sass se ha compilado con Sass 1.108.1.