# Email Genie
Allows autocomplete on email field by providing a list of domain suggestions _(gmail.com, outlook.com, etc.)_. This package is lightweight, flexible, compatible with libraries _(jQuery, etc.)_ / frameworks _(React, Angular, Vue, etc.)_ and maximize native behaviors on desktop AND mobile browsers.
👍 Lite 5kb _(2kb Gzipped)_
⚡ Fast Native JavaScript
🚫 No Dependencies
🚫 No HTML Wrapper
🚫 No CSS injected
Examples
-----
- [Basic](https://codepen.io/smnarnold/pen/bGGPvZo)
- [Custom domains](https://codepen.io/smnarnold/pen/bGGPMba)
Installation
-----
```shell
npm i email-genie
```
Import
-----
### CDN
```js
;
```
### Classic
```js
const EmailGenie = require('email-genie');
```
### ES6
```js
import EmailGenie from 'email-genie';
```
Usage
-----
### Text selector
```js
const email = new EmailGenie('.email');
```
### Vanilla JS
```js
const elem = document.querySelector('.email')
const field = new EmailGenie(elem);
```
### jQuery
```js
const field = new EmailGenie($('.email'));
```
Add custom domains
-----
```js
const field = new EmailGenie('.email', {
domains: ['business.com', 'company.com', 'university.com'],
});
```
Options
-----
| Option | Default | Possibilities | Description |
| ------- | ------- | ------------- | ----------- |
| domains | ['gmail.com', 'outlook.com', 'hotmail.com', 'msn.com', 'live.com', 'googlemail.com', 'yahoo.com', 'me.com', 'icloud.com'] | [] | Array of domains suggestions. _(By default, this array will be added to the default domains suggestions. View overrideDomains option to override instead.)_ |
| overrideDomains | false | Boolean _(true/false)_ | Wether the domains suggestions array should override the default one. |
| insert | 'afterend' | 'beforebegin', 'afterend', 'documentend' | Where the datalist generated should be inserted: Before the input, after the input, at the end of the document. |
Support
-----
Chrome, Firefox, Safari, Edge, IE 11
