npm package: @niewicz/mde-popover
Description: [![npm version](https://badge.fury.io/js/%40niewicz%2Fmde-popover.svg)](https://www.npmjs.com/package/%40niewicz%2Fmde-popover)
Latest version: 15.0.0

# Angular Popover

[![npm version](https://badge.fury.io/js/%40niewicz%2Fmde-popover.svg)](https://www.npmjs.com/package/%40niewicz%2Fmde-popover)

### Project status

Angular Material Popover is production ready for Angular 14.

This is forked project from [joejordanbrown/popover](https://github.com/joejordanbrown/popover).

This was originally created as an example for a `@angular/material` issue feature request.
Issue can be found at [angular/material2#2691](https://github.com/angular/material2/issues/2691).

If you'd like to contribute please create an issue or pull request.

### Examples

**Material theme picker**

[![Material theme picker](https://media.giphy.com/media/jsxheZJXN1346GD5St/giphy.gif)](https://stackblitz.com/edit/angular-popover-demo)

**Standard popover**

![image](https://cloud.githubusercontent.com/assets/10200431/22394189/02e9b21e-e511-11e6-9f91-c6b470a6b212.png)

![image](https://cloud.githubusercontent.com/assets/10200431/22394186/e21a235c-e510-11e6-9cde-948b1a4382bc.png)

**Google+ style popover**

![image](https://cloud.githubusercontent.com/assets/10200431/22397870/4f27ddba-e573-11e6-943f-2d737b59d39e.png)

### Installation

Install npm package using:

`yarn add @niewicz/mde-popover`
or
`npm install @niewicz/mde-popover`

Install required packages @angular/cdk

`yarn add @angular/cdk`
or
`npm install @angular/cdk`

### Initial setup

The CDK overlays depend on a small set of structural styles to work correctly. If you're using Angular Material, these styles have been included together with the theme, otherwise if you're using the CDK on its own, you'll have to include the styles yourself. You can do so by importing the prebuilt styles in your global stylesheet:

@import '~@angular/cdk/overlay-prebuilt.css';

### Import module

app.module.ts

```typescript
import { BrowserModule } from "@angular/platform-browser";
import { NgModule } from "@angular/core";

import { AppComponent } from "./app.component";
import { MdePopoverModule } from "@niewicz/mde-popover";

@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule, MdePopoverModule],
  providers: [],
  bootstrap: [AppComponent],
})
export class AppModule {}
```

### Todo

1. A design document needs creating to finalise requirements and API specifications.
   Once a document is created the component can be refactored and released as beta for testing.
2. Refactor now that @angular/cdk is released.

### Available features

| Feature | Notes                                                                                        | Docs                                                                                                             |
| ------- | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| popover | In-progress ([popover demo](https://uixd.co.uk/open-source-software/material-extended/demo)) | [Docs](https://github.com/niewicz/popover/blob/master/projects/material-extended/mde/src/lib/popover/popover.md) |

### Issues

Please report bugs and issues [here](https://github.com/niewicz/popover/issues).

###

### License

MIT ©

[Angular Popover by UIXD](https://uixd.co.uk)