Elevation
Elevation is used to create and communicate depth in an interface.
Usage
To use elevation, apply a box-shadow
to an element. The box-shadow
property takes the variable available in the UI library, as specified in the variants.
<div
style={{
background: 'white',
boxShadow: 'var(--elevations-e200)',
display: 'inline-block',
padding: '16px',
}}
>
An elevated element
</div>
This example usees the e200
variant.
When to use
- Separate elements. Use elevation to make relationships between interface elements clearer, like showing that a panel is floating above a background.
- Show temporary elements. Elevation is useful for showing extra elements above other page content. The elevation makes it clear that the extra elements are floating above the page and can be dismissed.
When not to use
- Decoration. Don't use elevation for decoration only. The elevation should be communicating something about an element's relationship to the interface.
Variants
Demo
- There are four levels of elevation:
e100
,e200
,e300
,e400
. - Use different elevation levels to communicate different depths or stacks of elements.
- Don't skip an elevation level. If there are two layered or stacked elements, use two levels next to one another, like
e100
ande200
.
API Reference
CssReset
Usage
To use CssReset
, you can import the component from the @dhis2/ui
library
import { CssReset } from '@dhis2/ui'
CssVariables
Usage
To use CssVariables
, you can import the component from the @dhis2/ui
library
import { CssVariables } from '@dhis2/ui'
Props
Name | Type | Default | Required | Description |
---|---|---|---|---|
colors | boolean | false | ||
elevations | boolean | false | ||
layers | boolean | false | ||
spacers | boolean | false | ||
theme | boolean | false |