lion/packages/overlays/docs/GlobalOverlayController.md

43 lines
1.1 KiB
Markdown

# GlobalOverlayController
This is a base class for different global overlays (e.g. a dialog, see [Overlay System: Scope](./OverlaySystemScope.md) - the ones positioned relatively to the viewport).
You should not use this controller directly unless you want to create a unique type of global overlays which is not supported out of the box. But for implementation details check out [Overlay System: Implementation](./OverlaySystemImplementation.md).
All supported types of global overlays are described below.
## How to use
### Installation
```sh
npm i --save @lion/overlays
```
### Example
```js
import { overlays } from '@lion/overlays';
const myCtrl = overlays.add(
new GlobalOverlayController({
/* options */
}),
);
```
### BottomsheetController
A specific extension of GlobalOverlayController configured to create accessible dialogs at the bottom of the screen.
```js
import { BottomsheetController } from '@lion/overlays';
```
### ModalDialogController
A specific extension of GlobalOverlayController configured to create accessible modal dialogs placed in the center of the screen.
```js
import { ModalDialogController } from '@lion/overlays';
```