cordova-plugin-printer
Advanced tools
Changelog
Version 0.7.3 (19.12.2016)
Readme
SAMPLE APP :point_right:
Plugin for the Cordova framework to print HTML from iOS, Android and Windows Universal apps.
AirPrint is an Apple™ technology that helps you create full-quality printed output without the need to download or install drivers. AirPrint is built in to many printer models from most popular printer manufacturers. Just select an AirPrint printer on your local network to print from your favorite iOS or OS X app.
See Drawing and Printing Guide for iOS for detailed informations.
Starting with KitKat, most Android devices have print service plugins installed to enable printing using the Google Cloud Print and Google Drive services. Print service plugins from other printer manufactures are available through the App Store though the Google Cloud Print service plugin can also be used to print from an Android device to just about any printer type and model.
In addition to supporting physical printers, it is also possible to save printed output to your Google Drive account or locally as a PDF file on the Android device.
See Building Apps with Multimedia for Android for detailed informations.
Install the latest version:
cordova plugin add cordova-plugin-printer
Or a specific version:
cordova plugin add cordova-plugin-printer@VERSION
Or the latest dev version:
cordova plugin add https://github.com/katzer/cordova-plugin-printer.git
Or a custom version:
cordova plugin add cordova-plugin-printer --searchpath path/to/plugin
And then execute:
cordova build
Known limitations
Known limitations
See CHANGELOG.md to get the full changelog for the plugin.
The plugin and its methods are not available before the deviceready event has been fired.
document.addEventListener('deviceready', function () {
// cordova.plugins.printer is now available
}, false);
The device his printing capabilities can be reviewed through the printer.check interface. Use this function to hide print functionality from users who will be unable to use it.
/**
* Checks if the printer service is avaible (iOS)
* or if printer services are installed and enabled (Android).
*
* @param {Function} callback
* A callback function
* @param {Object} scope
* Optional scope of the callback
* Defaults to: window
*/
cordova.plugins.printer.check(function (avail, count) {
alert(avail ? 'Found ' + count + ' services' : 'No');
});
Displays a system interface allowing the user to select an available printer.
To speak with a printer directly you need to know the network address by picking them before via printer.pick.
Note that picking a printer is not supported for windows platform.
/**
* Displays system interface for selecting a printer.
*
* @param {Function} callback
* A callback function
*/
cordova.plugins.printer.pick(function (uri) {
alert(uri ? uri : 'Canceled');
});
Content can be send to a printer through the printer.print interface. The method takes a string with HTML content, an URI pointing to another web page or any DOM node.
/**
* Sends the content to print service.
*
* @param {String} content
* HTML string or DOM node
* if latter, innerHTML is used to get the content
* @param {Object} options
* Options for the print job
* @param {Function} callback
* An optional callback function
* @param {Object} scope
* An optional scope of the callback
* Defaults to: window
*/
cordova.plugins.printer.print('<html>..</html>', { duplex: 'long' }, function (res) {
alert(res ? 'Done' : 'Canceled');
});
The method accepts a list of attributes. Not all are supported on each platform and by each printer!
| Name | Description | Type | Platform |
|---|---|---|---|
| name | The name of the print job and of the document | String | all |
| duplex | Specifies the duplex mode to use for the print job. Either double-sided on short site (duplex:'short'), double-sided on long site (duplex:'long') or single-sided (duplex:'none'). Defaults to: 'none' | String | all |
| landscape | The orientation of the printed content, portrait or landscape. Defaults to: false | Boolean | all |
| graystyle | If your application only prints black text, setting this property to true can result in better performance in many cases. Defaults to: false | Boolean | all |
| printerId | The network URL to the printer. | String | iOS |
| border | Set to false to skip any border. Useful for fullscreen images. Defaults to: true | Boolean | iOS |
| hidePageRange | Set to true to hide the control for the page range. Defaults to: false | Boolean | iOS |
| hideNumberOfCopies | Set to true to hide the control for the number of copies. Defaults to: false | Boolean | iOS |
| hidePaperFormat | Set to true to hide the control for the paper format. Defaults to: false | Boolean | iOS |
| bounds | The Size and position of the print view Defaults to: [40, 30, 0, 0] | Array | iPad |
NOTE: All CSS rules needs to be embedded or accessible via absolute URLs in order to print out HTML encoded content.
Print the whole HTML page:
var page = location.href;
cordova.plugins.printer.print(page, 'Document.html');
Print the content from one part of the page:
var page = document.getElementById('legal-notice');
cordova.plugins.printer.print(page, 'Document.html');
Print some custom content:
var page = '<h1>Hello Document</h1>';
cordova.plugins.printer.print(page, 'Document.html');
Print a remote web page:
cordova.plugins.printer.print('http://blackberry.de', 'BB10');
Send to printer directly:
cordova.plugins.printer.pick(function (uri) {
cordova.plugins.printer.print(page, { printerId: uri });
});
git checkout -b my-new-feature)git commit -am 'Add some feature')git push origin my-new-feature)This software is released under the Apache 2.0 License.
Made with :yum: from Leipzig
© 2016 appPlant GmbH
FAQs
Prints HTML documents
The npm package cordova-plugin-printer receives a total of 2,453 weekly downloads. As such, cordova-plugin-printer popularity was classified as popular.
We found that cordova-plugin-printer demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In an unprecedented surge, May 2024 saw the publication of over 5,000 CVEs, marking a historic milestone in cybersecurity with an average of 164 CVEs per day, nearly double the 2023 daily average.
Security News
The White House is addressing fragmented cybersecurity regulations as CISOs report spending up to 50% of their time on compliance, aiming to harmonize requirements and improve cybersecurity outcomes.
Security News
Research
The Socket Research Team has identified a malicious Python package that is typosquatting the popular crytic-compile utility, frequently used in popular toolkits and development environments for smart contracts and crypto applications.