A easy to use service to print the window, parts of a window (div) or an image. Printing of Angular Templates or Components is possible.
You can print opening a new window / tab or using the current window. A directive can also be used to mark and store an HTML-element.
Several usefull directives can further assist you.
See the DEMO App and DEMO-Page for examples.
- Add to main app.module imports
- Use the NgxPrinterService where you like via DI (private printerService: NgxPrinterService)
- Use the the functions provided by the service
Easy start
The easiest way to print an HTML Element is HTML:
<div ngxPrintItemMarker directPrint="true"></div>The service prints by opening a new window. There is an option printWindowOpen to change this behavoir. Set printWindowOpen=false;
You can also set this option in .forRoot while importing the module to the app.module
imports: [
BrowserModule,
NgxPrinterModule.forRoot({printOpenWindow: true})
],Before openening the print window the service to some time to render the print content. Default time is 200ms. You can adjust the time using the property timeToWaitRender (also in forRoot).
When printing to the current window the service creates an component with a css-class called 'default'. You can override this class name using the property renderClass (also in forRoot). Make sure that the class is placed in your global styles (styles.css).
When printing to the current window the service searches the app-root component. If you have changed the name of the root component in your app you can override the name using the property appRootName.
The maker image is placed to the bottom left. You can change this by changing the property markerPosition. Use a value of the enum ngxPrintMarkerPosition (TopLeft, .TopRight, .BottomLeft, .BottomRight).
If you want to display a preview without fireing the print event you can use printPreviewOnly = true. This can also be usefull for debugging purposes.
this.printerService.printCurrentWindow();
this.printerService.printDiv('idOfDivToPrint');
this.printerService.printImg('assets/bratwurst.jpg');
@ViewChild('PrintTemplate')
private PrintTemplateTpl: TemplateRef<any>;
printTemplate() {
this.printerService.printAngular(this.PrintTemplateTpl);
}Beware: To print a component the component needs to be known by service (copy source and add it to entry component of app.module). Otherwise use printHTMLElement instead. You can pass an optional context as the second parameter.
@ViewChild(LittleDummyComponent, {read: ElementRef}) PrintComponent: ElementRef;
printHTMLElementToCurrent() {
this.printerService.printHTMLElement(this.PrintComponent.nativeElement);
}If you want to check whether the print window is open or not subscribe to observable $printWindowOpen
this.printWindowSubscription = this.printerService.$printWindowOpen.subscribe(val => {
console.log('Print window is open:', val);
});There is an directive ngxPrintItem to mark and store an HTML-Element as an item which can be printed later and anyhwere on the page. An id has to be set. These items are stored in the services observable printerService.$printItems.
Use the async pipe to subscribe and then call the function printPrintItem to print one item.
HTML:
<span id="firstPrintItem" ngxPrintItem printName="First one" >A <b>first</b> span with an ngxPrintItem directive</span>
<div *ngFor="let prinItem of $printItems | async">
<span>{{prinItem.id}} - {{prinItem.printName}}</span>
<button (click)="printItem(prinItem)">Print me!</button>
</div>TS:
printItem(itemToPrint: PrintItem) {
this.printerService.printPrintItem(itemToPrint);
}
});You can also use the function printPrintItems(itemsToPrint, ?customCssClass) to print more than one item.
The items will be printed beneath each other (simple flex css). To arrange them side by side you can set your custom
class as a second parameter.
TS:
this.$printItems.subscribe(items => {
itemsToPrint = items as PrintItem[];
});
this.printerService.printPrintItems(itemsToPrint);If you want to print a single item from the list of ngxPrintItems (see above) or other HTML-elements without ts you can use the diretive ngxPrintItemButton. You can use
- an id of the printItem from the list
- a class name (className="ABC") of an HTML element
- an id of an HTML element (divID = "") of an HTML element
- an property to print the whole window (printWindow="true")
The Click-Event to print the item will be automatically set.
HTML:
<button ngxPrintItemButton printItemId="firstPrintItem">Print first item directly</button>
<button ngxPrintItemButton className="printident">
Print item by className with this button
</button>
<button ngxPrintItemButton divID="printDiv">
Print div by id with this button
</button>
<button ngxPrintItemButton printWindow="true"> Print whole window with this button </button>If you want to indicate an item as printable you can use this directive. The default class adds a little printer symbol to the top left of the html element.
Just display marker.
HTML:
<div ngxPrintItemMarker>If you click the little printer print starts immediately.
HTML:
<div ngxPrintItemMarker directPrint="true"></div>Use this directive to prevent an sub-item (child) to be printed.
You can override the default class with the customClass property.
Make sure that the css class is globally accessable e.g. put it into "styles.css".
You can also only override the image using the property backgroundImage. You can
speficy the data for the background-url.
You can listen to the event 'printClicked'.
HTML:
<div id="printDivMarker" ngxPrintItemMarker (printClicked)="printerMarkerClicked()">
<div id="printDivMarker" ngxPrintItemMarker customClass="mymarker" >Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.
Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the --prod flag for a production build.
Run ng test to execute the unit tests via Karma.
..if you like this lib ;-)
