print-job/README.md

Print a single HTML container

# print-job

This small JavaScript library prints a single HTML container.

## Features

* No popup windows or iFrames
* No moving and replacing HTML
* Preserve styles inherited from parent elements

## Install
```bash
npm install --save print-job
```

## Usage

#### In the browser
If the library is directly sourced to the window, it operates on the `PrintJob` global variable:
```javascript
window.PrintJob
````

#### In ES6
```javascript
import PrintJob from 'print-job';
```

## Documentation


### Print a container
You can pass in any valid selector, but only the first element found will be printed.
```javascript
PrintJob.print('#areaYouWantToPrint');
``` 

You can alternatively pass in an element instead of a selector:
```javascript
let element = document.getElementById('areaYouWantToPrint');
PrintJob.print(element);
```

---

### Print an external image
Print just an image by supplying an external URL to the `.image()` method. This is handy for printing a large version of
an image found on the page.  
 ```javascript
PrintJob.image('url/to/image.jpg');
```

_**Note:** Because the image has to be fetched, your application code will continue to run after calling this method.
The image will be printed the moment it loads._ 

### Upcoming Features
* Use custom print CSS
* Lifecycle callbacks
    * Before print
    * After print
* Preset jobs (set up the job and print later)