Volver a las notas

Safari puede oscurecer tu web si no le dices nada

16 de noviembre de 2026·
cssdarkmodesafaricolorscheme
Demo en vivoAbrir a pantalla completa

Si tu web es clara y no dice ni una palabra sobre el modo oscuro, Safari está a punto de decidir por ti. El 3 de noviembre el equipo de WebKit presentó Adaptive Dark Mode en Safari 27.3 beta: cuando alguien con el sistema en oscuro lo activa, las páginas claras se repintan en colores oscuros. Lo que decide si tu página se toca o no es una sola línea: color-scheme.

La demo de arriba lo simula. Pon el sistema en oscuro, deja marcado «Nada» y mira cómo la página, clara y cálida, se vuelve oscura. La foto se queda como estaba, el logo en blanco y negro se invierte y el gráfico en <canvas> sigue blanco en mitad de todo. Después cambia a light dark: la página usa la paleta oscura que diseñó su autor, no una generada por el navegador.

Qué hace Safari exactamente

El artículo de WebKit explica el mecanismo con bastante detalle, así que merece la pena leerlo con calma en vez de suponer:

  • A quién transforma. Las páginas que declaran modo oscuro con color-scheme: light dark no se tocan. Para el resto, Safari estima rápidamente si la página es mayoritariamente clara u oscura; las que ya son oscuras con texto claro se quedan como están.
  • Cómo. La base es una matriz de color que invierte la luminosidad conservando el tono, de modo que los fondos claros pasan a oscuros y el texto oscuro pasa a claro. El texto busca la relación de contraste 4.5:1 de las WCAG, los degradados CSS claros también se transforman y los botones, el texto sobre imágenes y los menús que aparecen al pasar el ratón se ajustan para que sigan siendo usables.
  • Imágenes. La mayoría no se tocan. Los colores de los SVG se transforman cuando hace falta y, en los mapas de bits, Safari analiza el histograma de píxeles e invierte los «logos sencillos en blanco y negro».
  • Lo que puede romperse. Las máscaras y mix-blend-mode pueden desactivarse en los elementos transformados, y el contenido de <canvas> no se cambia. Es el gráfico blanco de la demo: lo que dibujes en colores claros se queda claro.
  • Decide el usuario. Con el sistema en oscuro, Safari ofrece una vista previa en las webs claras y el usuario pulsa «Try».

No es el primer navegador que lo hace. La página de color-scheme en MDN ya menciona el Auto Dark Theme de Chrome en Android como una de las sustituciones que desactiva only. Y la especificación CSS Color Adjustment describe justo este caso: cuando el usuario prefiere un esquema de color que el autor no soporta, el navegador lo sustituye y ajusta automáticamente el resto de colores.

La solución es una declaración

Si ya tienes tema oscuro, dilo, y dilo pronto. WebKit recomienda ponerlo en el <head> del HTML o en :root en lugar de añadirlo después con JavaScript, y MDN aconseja colocar la etiqueta meta antes de cualquier CSS para evitar un destello al cargar:

<meta name="color-scheme" content="light dark">
:root { color-scheme: light dark; }

body {
  background: light-dark(#FAF7F2, #16130F);
  color: light-dark(#1C1917, #F5F0E8);
}

Es la paleta que usa la demo en el modo light dark. light-dark() devuelve el primer color cuando el esquema en uso es claro y el segundo cuando es oscuro, y solo funciona si color-scheme permite los dos. color-scheme es Baseline Widely available desde enero de 2022 y light-dark() es Baseline desde mayo de 2024, así que en navegadores actuales no necesitas plan B. La demo lleva uno de todos modos: comprueba CSS.supports('color', 'light-dark(#000, #fff)') y, si falla, cambia de paleta con un atributo.

Si tu página tiene que seguir siendo clara (un documento tipo impreso, una marca que nunca ha tenido versión oscura), la forma de excluirse es la palabra clave only:

<meta name="color-scheme" content="light only">
:root { color-scheme: light only; }

La gramática de la especificación es normal | [ light | dark | <custom-ident> ]+ && only?, así que light only y only light significan lo mismo. También puedes aplicarlo a un único elemento (un mapa incrustado, un diagrama) en lugar de a toda la página.

Detalles a tener en cuenta

  • only no funcionaba en Safari 27.3 beta 1. Lo dice WebKit en el propio artículo, y añade que puede cambiar durante la beta. Declarar un modo oscuro de verdad es lo que funciona hoy.
  • Tu JavaScript no ve la transformación. Por privacidad, Safari no deja que las páginas detecten cuándo se aplica Adaptive Dark Mode. Al leer los colores CSS obtienes los valores originales y las imágenes dibujadas en un canvas salen como eran. La lectura central de la demo lo enseña: el usuario ve un fondo oscuro mientras tu script lee el claro.
  • El soporte parcial también vale. Si solo algunos componentes tienen estilos oscuros, WebKit sugiere poner color-scheme: light dark en esos elementos concretos.
  • El canvas es cosa tuya. Ni Safari ni light-dark() van a recolorear lo que dibujes. Si declaras modo oscuro, vuelve a dibujar los gráficos con colores leídos de tu tema. La demo no lo hace a propósito, para que veas el hueco en los dos modos.
  • La simulación es una simulación. La demo invierte la luminosidad en OKLCH y conserva el tono, siguiendo la descripción de WebKit, pero no es el algoritmo de Safari. Para ver el de verdad necesitas Safari 27.3 beta.

Qué vigilar

  • Si la palabra clave only empieza a funcionar en las siguientes betas de la 27.3 y si el comportamiento llega igual a la versión estable.
  • Cómo trata Safari prefers-color-scheme en las páginas transformadas. El artículo no lo dice, así que yo no daría nada por hecho.
  • Las webs que fijan color-scheme desde JavaScript después de cargar. WebKit desaconseja hacerlo expresamente; si un selector de tema lo hace hoy, conviene añadir también una declaración fija en el <head>.

Fuentes