summaryrefslogtreecommitdiff
path: root/plugins/com.ionic.keyboard/README.md
diff options
context:
space:
mode:
authorARC <arjunrc@gmail.com>2015-05-13 14:58:25 -0400
committerARC <arjunrc@gmail.com>2015-05-13 14:58:25 -0400
commit73968ba1b3c3b5efeb92f70969e40d143eebf3d8 (patch)
tree25f9d358356645c89c212f014f622d5c831e81d0 /plugins/com.ionic.keyboard/README.md
parent1bef6ad92cafa215e3927d0a4d0a29147d52fe56 (diff)
Added plugin directory as well to make sure you have all you need to compile (hopefully)
Diffstat (limited to 'plugins/com.ionic.keyboard/README.md')
-rw-r--r--plugins/com.ionic.keyboard/README.md123
1 files changed, 123 insertions, 0 deletions
diff --git a/plugins/com.ionic.keyboard/README.md b/plugins/com.ionic.keyboard/README.md
new file mode 100644
index 00000000..63f70012
--- /dev/null
+++ b/plugins/com.ionic.keyboard/README.md
@@ -0,0 +1,123 @@
+Keyboard
+======
+
+The `cordova.plugins.Keyboard` object provides functions to make interacting with the keyboard easier, and fires events to indicate that the keyboard will hide/show.
+
+ cordova plugin add com.ionic.keyboard
+
+Methods
+-------
+
+- cordova.plugins.Keyboard.hideKeyboardAccessoryBar
+- cordova.plugins.Keyboard.close
+- cordova.plugins.Keyboard.disableScroll
+- cordova.plugins.Keyboard.show
+
+Properties
+--------
+
+- cordova.plugins.Keyboard.isVisible
+
+Events
+--------
+
+These events are fired on the window.
+
+- native.keyboardshow
+ * A number `keyboardHeight` is given on the event object, which is the pixel height of the keyboard.
+- native.keyboardhide
+
+Keyboard.hideKeyboardAccessoryBar
+=================
+
+Hide the keyboard accessory bar with the next, previous and done buttons.
+
+ cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
+ cordova.plugins.Keyboard.hideKeyboardAccessoryBar(false);
+
+Supported Platforms
+-------------------
+
+- iOS
+
+
+Keyboard.close
+=================
+
+Close the keyboard if it is open.
+
+ cordova.plugins.Keyboard.close();
+
+Supported Platforms
+-------------------
+
+- iOS, Android, Blackberry 10
+
+
+Keyboard.disableScroll
+=================
+
+Disable native scrolling, useful if you are using JavaScript to scroll
+
+ cordova.plugins.Keyboard.disableScroll(true);
+ cordova.plugins.Keyboard.disableScroll(false);
+
+Supported Platforms
+-------------------
+
+- iOS
+
+Keyboard.show
+=================
+
+Force keyboard to be shown on Android. This typically helps if autofocus on a text element does not pop up the keyboard automatically
+
+ cordova.plugins.Keyboard.show();
+
+Supported Platforms
+
+- Android, Blackberry 10
+
+native.keyboardshow
+=================
+
+This event fires when the keyboard will be shown
+
+ window.addEventListener('native.keyboardshow', keyboardShowHandler);
+
+ function keyboardShowHandler(e){
+ alert('Keyboard height is: ' + e.keyboardHeight);
+ }
+
+Properties
+-----------
+
+keyboardHeight: the height of the keyboard in pixels
+
+
+Supported Platforms
+-------------------
+
+- iOS, Android, Blackberry 10
+
+
+native.keyboardhide
+=================
+
+This event fires when the keyboard will hide
+
+ window.addEventListener('native.keyboardhide', keyboardHideHandler);
+
+ function keyboardHideHandler(e){
+ alert('Goodnight, sweet prince');
+ }
+
+Properties
+-----------
+
+None
+
+Supported Platforms
+-------------------
+
+- iOS, Android, Blackberry 10