offset-x (Desplazamiento horizontal)Longitud (px)
Especifica el desplazamiento cartesiano horizontal de la sombra respecto a la caja del elemento. Los valores positivos proyectan la sombra hacia la derecha; los valores negativos la proyectan hacia la izquierda. En modelos de iluminación multicapa, offset-x se deriva como dx = distance * cos(theta), donde theta representa el ángulo de incidencia de la fuente de luz.
Por defecto: 0px
offset-y (Desplazamiento vertical)Longitud (px)
Define el desplazamiento cartesiano vertical de la sombra. Los valores positivos proyectan la sombra hacia abajo (simulando la iluminación cenital natural del sol o luminarias de techo); los valores negativos la proyectan hacia arriba. Los modelos estándar de elevación física escalan offset-y proporcionalmente con la elevación percibida en el eje Z.
Por defecto: 4px
blur-radius (Dispersión gaussiana)Longitud (px)
Define la desviación estándar para el núcleo de desenfoque gaussiano aplicado al perímetro de la sombra (sigma = blur / 2). Un radio de desenfoque de 0 genera una silueta dura y nítida; valores superiores a 0 producen un degradado difuso de penumbra. Valores mayores a 64px pueden ocasionar cuellos de botella en la rasterización por GPU en dispositivos móviles de recursos limitados.
Por defecto: 12px
spread-radius (Expansión y contracción perimetral)Longitud (px)
Expande o contrae la geometría de la sombra en las cuatro direcciones antes de la rasterización gaussiana. Los valores positivos expanden el perímetro hacia afuera; los valores negativos lo contraen hacia el interior, una técnica clave en sombras multicapa para prevenir el desbordamiento lateral sin perder anclaje vertical.
Por defecto: -2px
color & alpha (Absorción cromática y opacidad)Color (HEX / RGBA / OKLCH)
Especifica el color espectral y la opacidad de la sombra proyectada. El negro puro (rgba(0, 0, 0, alpha)) representa una absorción no calibrada que genera halos grisáceos turbios sobre fondos de color. Los design tokens profesionales emplean matices tintados (p. ej., azul marino profundo para superficies frías o sombra tostada para superficies cálidas) calibrados entre el 4% y el 25% de canal alfa.
Por defecto: rgba(0, 0, 0, 0.08)
inset (Sombra interna o hendidura)Bandera de palabra clave (Keyword Flag)
Al declararse, invierte el vector de proyección para renderizar la sombra dentro del border-box del elemento en lugar de proyectarla externamente. Las sombras inset simulan hendiduras, bajorrelieves, biseles interiores cóncavos y estados de botones presionados, recortándose con precisión según la curvatura de border-radius.
Por defecto: false (exterior)
harmonic falloff curve (Atenuación armónica entre capas)Exponente matemático (k)
Exponente polinómico o exponencial de ley de potencias (habitualmente k = 1.8 a 2.4) que modula cómo escalan el desplazamiento, el desenfoque gaussiano y la opacidad alfa a través de capas sucesivas en una sombra multicapa. Evita saltos lineales artificiales y emula la disipación óptica real de la ley del inverso del cuadrado de la distancia.
Por defecto: 2.0 (cuadrática)
