Merge branch 'master' of github.com:katzer/cordova-plugin-printer

This commit is contained in:
Sebastián Katzer 2013-08-20 17:48:05 +02:00
commit fb997fd982

View File

@ -6,7 +6,8 @@ A bunch of printing plugins for Cordova 3.x.x
by Sebastián Katzer ([github.com/katzer](https://github.com/katzer)) by Sebastián Katzer ([github.com/katzer](https://github.com/katzer))
## Supported Platforms ## ## Supported Platforms ##
- **iOS** *(Print from iOS devices to AirPrint compatible printers)* - **iOS** *(Print from iOS devices to AirPrint compatible printers)*<br>
See [Drawing and Printing Guide for iOS](http://developer.apple.com/library/ios/documentation/2ddrawing/conceptual/drawingprintingios/Printing/Printing.html) for detailed informations and screenshots.
## Adding the Plugin to your project ## ## Adding the Plugin to your project ##
Through the [Command-line Interface](http://cordova.apache.org/docs/en/3.0.0/guide_cli_index.md.html#The%20Command-line%20Interface): Through the [Command-line Interface](http://cordova.apache.org/docs/en/3.0.0/guide_cli_index.md.html#The%20Command-line%20Interface):
@ -22,6 +23,9 @@ cordova plugin rm de.appplant.cordova.plugin.printer
``` ```
## Release Notes ## ## Release Notes ##
#### Version 0.2.1 ####
- Support for callback scopes
#### Version 0.2.0 (11.08.2013) #### #### Version 0.2.0 (11.08.2013) ####
- Added iOS support<br> - Added iOS support<br>
*Based on the Print iOS plugin made by* ***Randy McMillan*** *Based on the Print iOS plugin made by* ***Randy McMillan***
@ -30,7 +34,8 @@ cordova plugin rm de.appplant.cordova.plugin.printer
The plugin creates the object ```window.plugin.printer``` with two methods: The plugin creates the object ```window.plugin.printer``` with two methods:
### isServiceAvailable() ### ### 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. 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.<br>
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*).
```javascript ```javascript
/* /*
@ -44,16 +49,18 @@ window.plugin.printer.isServiceAvailable(
``` ```
### print() ### ### print() ###
Function takes an html string and (optionally) a success callback and a failure callback. 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*).
```javascript ```javascript
// Get HTML string // Get HTML string
var page = document.body.innerHTML; var page = document.body.innerHTML;
/* /*
* Pass an HTML and - optionally - success function, error function. * Pass an HTML and - optionally - a callback function.
*/ */
window.plugin.printer.print(page); window.plugin.printer.print(page, function (success, available, error) {
}, this);
``` ```
#### Testing in the iOS Simulator #### #### Testing in the iOS Simulator ####