Shadow atom

Atomic Components

The shadow atom is used to apply internal or external shadows to components like thumbnails, buttons, text fields, and many more. Eight preset levels are proposed.

Introduction

All GoodBarber components manage it in order to keep consistency. We have global shadow management in the backoffice.

It has 8 types of preset levels, but it's also possible to customize this offset. A shadow can be internal or external.

The shadow doesn’t have any impact on the component it’s applied on. The layout, the size or the margins of this component doesn’t change if you change the shadow level.

Shadow levels

Shadow levels

JSON

Here’s the JSON format of this object :

{

"enabled": BOOL // Default value 0,

"position": { "internal", "external" }, // Default external

"color": COLOR,

"type": { "level1", "level2", "level3", "level4", "custom"},

"offset": { x: FLOAT, y: FLOAT } // Used only on custom type,

"blur": FLOAT // Used only on custom type,

"opacity": {0 -> 1} // Used only on custom type,

}

Documentation

Shadow levels values

These parameters are valid for all devices:

DROP SHADOWLevel 1Level 2Level 3Level 4
Offset Y1 px3 px6 px20 px
Blur3 px6 px12 px40 px

Drop shadow levels

Drop shadow levels

INNER SHADOWLevel -1Level -2Level -3Level -4
Offset Y1 px3 px6 px20 px
Blur3 px6 px12 px40 px

Inner shadow levels

Inner shadow levels

Shadow management

Not all components can receive Atom Shadow, or only in a restricted way. These parameters are detailed in the sections specific to each component. Indeed:

  • Some components cannot receive the Atom Shadow

In the example below, we do not apply the Atom Shadow to the text or the outline of the button

Good practice
Good practice
Bad practice
Bad practice
  • Some components can only receive certain levels of shadow

The floating menu and the alert message below should come to the fore, so they will receive high shadow levels (here Level 3 and 4)

Shade level according to the component

Shade level according to the component

  • Some components can receive different Levels from the Atom Shadow depending on their state

Below is the behavior of a Textfield changing from Inactive to Active state

Text field state

Text field state

Example