box-shadow

Especificando uma única box-shadow usando:

• Dois, três ou quatro valores para <length>.

  • Se apenas dois valores forem definidos, eles serão interpretados como valores de <offset-x><offset-y>.
  • Se o terceiro valor for dados, é interpretado como <blur-radius>.
  • Se o quarto valor for dados, é interpretado como <spread-radius>.

• Opcionalmente, o atributo inset.

• Opcionalmente, o valor <color>.

Para especificar mais de uma sombra, separe-as com virgula.

inset

Se não for especificado, a sombra ganha o efeito de como se a caixa fosse aumentada acima do conteúdo). A presença da palavra-chave inset muda a sombra para dentro da moldura (como se o conteúdo estivesse pressionado dentro da caixa). As sombras de inserção são desenhadas dentro da borda (mesmo as transparentes), acima do plano de fundo, mas abaixo do conteúdo.

<offset-x> <offset-y>

Existem dois valores <length> para configurar o desvio (offset) da sombra:

• <offset-x> especifica a distância horizontal. Valores negativos colocarão a sombra à esquerda do elemento.
• <offset-y> especifca a distância vertical. Valores negativos colocam a sombra acima do elemento.

Consulte <length> para as unidades disponíveis.

Se ambos os valores forem 0, a sombra será posicionada atrás do elemento (e poderá gerar um efeito de desfocagem caso <blur-radius> e/ou <spread-radius> estiverem configurados).

<blur-radius>

Este é um terceiro valor para <length>. Quanto maior for este valor, maior o efeito de desfocagem, desta forma a sombra se tornará maior e mais clara. Valores negativos não são permitidos. Se não for especificado, o valor padrão é 0 (os limites da sombra serão retos). A especificação não inclui um algoritmo exato de como o raio de esmaecimento deve ser calculado, no entanto, descreve o seguinte:

...para uma sombra com bordas longas e retas, deverá ser criada uma transição de cor do comprimento da distância de desfocagem que é perpendicular e centralizada com as bordas da sombra, e isto deve variar da cor total da sombra do seu ponto central até totalmente transparente no ponto final fora dela.

<spread-radius>

Este é um quarto valor de <length>. Valores positivos farão com que a sombra expanda e cresça maior, valores negativos farão com que a sombra encolha. Se não for especificado, o valor padrão é 0 (a sombra terá o mesmo tamanho do elemento)

<color>

Consulte <color> para possiveis palavras-chave e notações. Se não for especificada, a cor que será utilizada vai depender do navegador - geralmente é o valor da propriedade color, mas tenha em mente que o Safari atualmente imprime uma sombra transparente neste caso.

Each shadow in the list (treating none as a 0-length list) is interpolated via the color (as color) component, and x, y, blur, and (when appropriate) spread (as length) components. For each shadow, if both input shadows are or are not inset, then the interpolated shadow must match the input shadows in that regard. If any pair of input shadows has one inset and the other not inset, the entire shadow list is uninterpolable. If the lists of shadows have different lengths, then the shorter list is padded at the end with shadows whose color is transparent, all lengths are 0, and whose inset (or not) matches the longer list.

box-shadow = 
  <spread-shadow>#  

<spread-shadow> = 
  <'box-shadow-color'>?                               &&
  [ <'box-shadow-offset'> [ <'box-shadow-blur'> <'box-shadow-spread'>? ]? ]  &&
  <'box-shadow-position'>?                            

<box-shadow-color> = 
  <color>#  

<box-shadow-offset> = 
  [ none | <length>{2} ]#  

<box-shadow-blur> = 
  <length [0,∞]>#  

<box-shadow-spread> = 
  <length>#  

<box-shadow-position> = 
  [ outset | inset ]#  

• box-shadow test
• box-shadow tutorial and examples
• Box Shadow CSS Generator

• The <color> data type
• Other color-related properties: color, background-color, border-color, outline-color, text-decoration-color, text-emphasis-color, caret-color, and column-rule-color
• Applying color to HTML elements using CSS