grommet
Version:
focus on the essential experience
116 lines (84 loc) • 1.87 kB
Markdown
## Drop
A container that is overlaid next to a target.
[](https://storybook.grommet.io/?selectedKind=Drop&full=0&addons=0&stories=1&panelRight=0) [](https://codesandbox.io/s/github/grommet/grommet-sandbox?initialpath=drop&module=%2Fsrc%2FDrop.js)
## Usage
```javascript
import { Drop } from 'grommet';
<Drop target={reference}>...</Drop>
```
## Properties
**align**
How to align the drop with respect to the target element. Not specifying
a vertical or horizontal alignment will cause it to be aligned in the
center. Defaults to `{
"top": "top",
"left": "left"
}`.
```
{
top:
top
bottom,
bottom:
top
bottom,
right:
left
right,
left:
left
right
}
```
**onClickOutside**
Function that will be invoked when the user clicks outside the drop.
```
function
```
**onEsc**
Function that will be called when the user presses the escape key inside the drop.
```
function
```
**responsive**
Whether to dynamically re-place when resized. Defaults to `true`.
```
boolean
```
**restrictFocus**
Whether the drop should control focus.
```
boolean
```
**stretch**
Whether the drop element should be stretched to at least match the
width of the target element. The default is true because
that is what most uses of Drop want, like Select and Menu. Defaults to `true`.
```
boolean
```
**target**
Required. Target where the drop will be aligned to. This should be a React reference.
```
object
```
**elevation**
Elevated height of the target, indicated via a drop shadow.
```
none
xsmall
small
medium
large
xlarge
string
```
**plain**
Whether the drop element should have no background nor shadow
```
boolean
```
## Intrinsic element
```
div
```