ngx-print

This directive makes printing your HTML sections smooth and easy in your Angular application. It is inspired from the old AngularJS ngPrint directive, thus it is intendend to be used with the new Angular -2/4/5/6/7-... Enjoy ! contributions are so welcomed :)

Dependencies

| ngx-print | Angular | | ------------ | ------------ | | 1.2.1 | 7.0.0 - 14.1.0 | | 1.3.x | 15.0.0 | | 1.4.x | 16.0.0 | | 1.5.x | 17.0.0 |

Setup

1- In your root application folder run: ```bash $ npm install ngx-print ``` 2- Once ngx-print is installed, you need to import the main module NgxPrintModule :

```js

import {NgxPrintModule} from 'ngx-print'; @NgModule({ ... imports: NgxPrintModule, ..., ... }) export class YourAppModule { } ``` 3- Then plug n' play with it: - Assuming you want to print the following HTML section: ```html print ``` - Now, what you have to do is tagging your wanted-to-print section by an id attribute, then link that id to a directive parameter in your button : ```html print ```

Optional properties

• You want a customized title for your printing window ? you have the choice by adding a new attribute to your print button printTitle:

```html printTitle="MyTitle"

printSectionId="print-section"  

ngxPrint>print</button>

```

• Also, would you like to customize the printing window style sheet (CSS) ? Hence you can do so by adding infinite styles to another attribute called printStyle:

```html [printStyle]="{h1 : {'color': 'red'}, h2 : {'border': 'solid 1px'}}"

printSectionId="print-section"

ngxPrint>print</button>

``` Here some simple styles were added to every h1 & h2 tags within the div where print-section is tagged to its id attribute.

• If you would like to use your existing CSS with media print you can add the useExistingCss attribute:

```html useExistingCss="true"

printSectionId="print-section"

ngxPrint>print</button>

```

• If you want to customize the printing window style sheet (CSS) by importing the css provided in assets/css use styleSheetFile:

```html print ```

• If you would like to show a preview without a print dialog use

previewOnly: ```html previewOnly="true"

printSectionId="print-section"

ngxPrint>print</button>

```

• Some print operations open a second dialog, and automatically closing the popup window happens before the second dialog opens. Set closeWindow to false to handle print operations that open a second dialog, like "Microsoft Print to PDF", or "Print using system dialog...":

```html [closeWindow]="false"

printSectionId="print-section"

ngxPrint>print</button>

```

• Set bodyClass to whatever class values are needed for some of your css rules that expect an ancestor to have a certain class. For example, a theme selector:

```html [bodyClass]="theme-dark"

printSectionId="print-section"

ngxPrint>print</button>

```

Using NgxPrint as a service

Inject the NgxPrintService in the constructor of your component or service: ```typescript constructor(private printService: NgxPrintService) { } ```

Printing a Section

```typescript import { PrintOptions } from './path-to-your/print-options.model'; printMe() { const customPrintOptions: PrintOptions = new PrintOptions({

printSectionId: 'print-section',

// Add any other print options as needed

}); this.printService.print(customPrintOptions) } ```

Print Options Object

The print options object allows you to specify how the print job should be handled. All of which have default values that you can optionally override, although printSectionId is required. It contains the following properties: ```typescript printSectionId: string = null; printTitle: string = null; useExistingCss: boolean = false; bodyClass: string = ''; previewOnly: boolean = false; closeWindow: boolean = true; printDelay: number = 0; ```

Setting PrintStyles or StyleSheets

```typescript // Optional property for css as a key-value pair this.printService.printStyle = styleSheet; // Optional property for a css file location this.printService.styleSheetFile = fileLocation; ```

Contributors :1stplacemedal:

Huge thanks to: deeplotia , Ben L , Gavyn McKenzie , silenceway, Muhammad Ahsan Ayaz, Core121 and to all ngx-print users

Donation

Did this project help you reducing time? I won't say no to a cup of coffee 🍵 :)