Work/cordova-plugin-printer
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
21 Commits 1 Branch 0 Tags 369 KiB
Objective-C 44.3%
Java 40%
JavaScript 15.7%
b39106bb31
Go to file
Sebastián Katzer b39106bb31 Update README.md
2013-08-13 16:05:24 +02:00
src/ios Code refactoring 2013-08-13 15:39:22 +02:00
www Für Callbacks können Scopes angegeben werden. print() benötigt nur noch eine Callback-Funktion. 2013-08-13 11:01:15 +02:00
LICENSE Initial commit 2013-08-09 09:44:19 -07:00
plugin.xml Release version 0.2.1 2013-08-13 15:40:21 +02:00
README.md Update README.md 2013-08-13 16:05:24 +02:00

README.md

Cordova Printer-Plugin

A bunch of printing plugins for Cordova 3.x.x

by Sebastián Katzer (github.com/katzer)

Supported Platforms

  • iOS (Print from iOS devices to AirPrint compatible printers)

Adding the Plugin to your project

Through the Command-line Interface:

cordova plugin add https://github.com/katzer/cordova-plugin-printer.git

Release Notes

Version 0.2.1

  • Support for callback scopes

Version 0.2.0 (11.08.2013)

  • Added iOS support
    Based on the Print iOS plugin made by Randy McMillan

Using the plugin

The plugin creates the object window.plugin.printer with two methods:

isServiceAvailable()

Printing is only available on devices capable of multi-tasking (iPhone 3GS, iPhone 4 etc.) running iOS 4.2 or later. You can use this function to hide print functionality from users who will be unable to use it.
Function takes a callback function, passed to which is a boolean property. Optionally you can assign the scope in which the callback will be executed as a second parameter (default to window).

/*
 * Find out if printing is available. Use this for showing/hiding print buttons.
 */
window.plugin.printer.isServiceAvailable(
    function (isAvailable) {
        alert(isavailable ? 'Service is available' : 'Service NOT available');
    }
);

print()

Function takes an html string and (optionally) a callback function. Optionally you can assign the scope in which the callback will be executed as a third parameter (default to window).

// Get HTML string
var page = document.body.innerHTML;

/*
 * Pass an HTML and - optionally - a callback function.
 */
window.plugin.printer.print(page, function (success, available, error) {

}, this);

Testing in the iOS Simulator

There's no need to waste lots of paper when testing - if you're using the iOS simulator, select File->Open Printer Simulator to open some dummy printers (print outs will appear as PDF files).

Adding Page Breaks to Printouts

Use the 'page-break-before' property to specify a page break, e.g.

<p>
First page.
</p>

<p style="page-break-before: always">
Second page.
</p>

See W3Schools for more more information: http://www.w3schools.com/cssref/pr_print_pagebb.asp

Note: you will need to add an extra top margin to new pages.

Printing on Real Printers

Printing is only supported on AirPrint-enabled printers or with the use of third-party software on your computer. The following pages contain more information: