Expresiones de medios con nombre en CSS: presets @custom-media para diseño adaptableArtículo · digest del 5 de noviembre
Plano de ingeniería de maquetación adaptable con escala modular de breakpoints y expresiones de medios semánticas custom-media.
Artículo4 secciones≈ 6 min

Expresiones de medios con nombre en CSS: presets @custom-media para diseño adaptable

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:

  1. 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.
  2. 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.
  3. 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:

  1. 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.
  2. Escala modular de breakpoints con paso de 100px: Schwarz propone abandonar nombres subjetivos como --mobile, --tablet y --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);
    
  3. 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.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 3