Abre cualquier repositorio frontend antiguo y echa un vistazo a las hojas de estilo. Con un 99% de probabilidad verás allí la clásica «lluvia de números mágicos»: decenas de condiciones dispersas @media (max-width: 768px), por algún lado se coló un @media (min-width: 1024px) y en un par de componentes el maquetador se equivocó por un píxel y escribió max-width: 767px, rompiendo la cuadrícula de tarjetas en la frontera entre resoluciones.
Este problema persigue a la industria web desde hace más de quince años. Aprendimos a extraer colores, márgenes y tipografías a CSS Custom Properties (variables como --primary-color), pero seguimos copiando y pegando a mano las propias media queries.
La especificación CSS Media Queries Level 5 cierra esta injusticia histórica con la directiva @custom-media.
Veamos cómo funciona esta directiva y cómo los presets prácticos del blog Master.dev ayudan a poner un orden perfecto en la maquetación adaptable.
La maldición de los píxeles mágicos: por qué los antiguos breakpoints quedaron obsoletos
El enfoque tradicional de adaptabilidad adolece de tres defectos fundamentales:
- Duplicación e infierno de mantenimiento: si el equipo de diseño decide mover el límite del layout móvil de 768px a 800px, los ingenieros se ven obligados a lanzar una búsqueda y reemplazo global en cientos de módulos CSS. Seguro que algo se escapa y en producción aparece un desajuste de estilos.
- Heurísticas falsas de dispositivos: históricamente nos acostumbramos a pensar: «si la pantalla es más estrecha que 768px es un móvil táctil; si es más ancha, un escritorio con ratón». Hoy esa lógica está completamente rota. Un iPad Pro moderno de 13 pulgadas con teclado externo y trackpad puede ser más ancho que un portátil de oficina, pero el usuario puede tocar la pantalla con el dedo en cualquier momento. Y un netbook compacto de 11 pulgadas se maneja con un ratón de alta precisión. Guiarse solo por el ancho de la ventana en píxeles es un callejón sin salida.
- Falta de semántica: la construcción abstracta
@media (hover: none) and (pointer: coarse)obliga al desarrollador a recordar especificaciones en lugar de entender al instante la intención del autor: «aquí ampliamos el área de toque del botón para el dedo en pantalla táctil».
Sintaxis de @custom-media: variables para expresiones lógicas de medios
La directiva @custom-media funciona como la declaración de una variable global para reglas @media. Asocia un identificador con doble guion (--name) a cualquier expresión de medios válida o combinación lógica:
/* Definiciones base de expresiones con nombre */
@custom-media --narrow-window (max-width: 600px);
@custom-media --mouse (hover: hover) and (pointer: fine);
@custom-media --touch (hover: none) and (pointer: coarse);
/* Combinación de presets creados previamente */
@custom-media --mobile-touch (--narrow-window) and (--touch);
/* Uso en componentes de interfaz */
@media (--mouse) {
.interactive-card:hover {
transform: translateY(-4px);
box-shadow: 0 12px 24px rgba(0, 0, 0, 0.15);
}
}
@media (--touch) {
.interactive-card {
min-height: 48px; /* Área de clic ampliada para el dedo */
}
}
El código se vuelve autodocumentado. Declaras una sola vez las reglas semánticas en la raíz del proyecto y las utilizas en toda la base de código.
Los presets de Daniel Schwarz: rejilla modular, tipos de entrada y True HDR
El arquitecto frontend Daniel Schwarz formuló un sistema listo de expresiones de medios con nombre, dividido en tres bloques aplicados:
- Modalidades de entrada (Input Modalities):
En lugar de adivinar el tipo de dispositivo por el ancho del cristal, los presets comprueban el método físico real de interacción:
--mouse:(hover: hover) and (pointer: fine)— ratón o trackpad con cursor;--touch:(hover: none) and (pointer: coarse)— dedo en smartphone o tableta;--stylus:(hover: none) and (pointer: fine)— lápiz óptico de alta precisión en tableta gráfica;--air:(hover: hover) and (pointer: coarse)— control gestual espacial (Apple Vision Pro, Meta Quest);--dpad:(hover: none) and (pointer: none)— mando a distancia con botones de Smart TV o gamepad.
- Escala modular de breakpoints con paso de 100px:
Schwarz propone abandonar nombres subjetivos como
--mobile,--tablety--desktop, que para cada diseñador significan cifras distintas, en favor de una rejilla numérica estricta:@custom-media --from-360 (min-width: 360px); @custom-media --from-480 (min-width: 480px); @custom-media --from-720 (min-width: 720px); @custom-media --from-1080 (min-width: 1080px); @custom-media --from-1440 (min-width: 1440px); - Rango dinámico ampliado (True HDR):
@custom-media --true-hdr (dynamic-range: high) and (color-gamut: p3);
Este preset permite activar los colores ultrabrillantes de la paleta Display P3 solo en pantallas que soportan HDR por hardware (OLED, mini-LED), evitando distorsiones en monitores de oficina económicos.
Estado en navegadores y fallbacks: PostCSS frente a container style()
Por el momento, el soporte nativo de la directiva @custom-media ya está implementado en el motor Gecko (Firefox 148+), aunque sigue oculto tras el flag experimental del sistema layout.css.custom-media.enabled.
¿Cómo usar esta sintaxis en producción ahora mismo?
El camino principal y probado es el plugin postcss-custom-media. En fase de compilación, la utilidad compila los presets con nombre a CSS estándar:
// postcss.config.js
module.exports = {
plugins: [
require('postcss-custom-media')({
importFrom: 'src/styles/custom-media.css'
})
]
};
El segundo camino moderno sin preprocesadores es utilizar consultas de estilo de contenedor @container style():
:root {
@media (dynamic-range: high) and (color-gamut: p3) {
--is-hdr: true;
}
}
@container style(--is-hdr: true) {
.hero-glow-badge {
background: color(display-p3 1 0.1 0.2);
}
}
Como señalamos en el análisis de 12 capacidades del CSS moderno, la plataforma nativa va absorbiendo paso a paso funcionalidades por las que antes había que conectar pesados preprocesadores como Sass y Less.
Adoptar presets @custom-media a nivel de sistema de diseño libra al equipo de la confusión con los píxeles y sienta una base sólida para cualquier dispositivo futuro.

