You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2014/06/27 01:55:49 UTC
svn commit: r1605933 [1/11] - in /cordova/site/public/docs/en: 3.5.0/ edge/
Author: mwbrooks
Date: Thu Jun 26 23:55:47 2014
New Revision: 1605933
URL: http://svn.apache.org/r1605933
Log:
Update documentation.
Modified:
cordova/site/public/docs/en/3.5.0/_index.html
cordova/site/public/docs/en/3.5.0/config_ref_images.md.html
cordova/site/public/docs/en/3.5.0/config_ref_index.md.html
cordova/site/public/docs/en/3.5.0/cordova_events_events.md.html
cordova/site/public/docs/en/3.5.0/cordova_plugins_pluginapis.md.html
cordova/site/public/docs/en/3.5.0/cordova_storage_storage.md.html
cordova/site/public/docs/en/3.5.0/guide_appdev_privacy_index.md.html
cordova/site/public/docs/en/3.5.0/guide_appdev_security_index.md.html
cordova/site/public/docs/en/3.5.0/guide_appdev_whitelist_index.md.html
cordova/site/public/docs/en/3.5.0/guide_cli_index.md.html
cordova/site/public/docs/en/3.5.0/guide_hybrid_plugins_index.md.html
cordova/site/public/docs/en/3.5.0/guide_hybrid_webviews_index.md.html
cordova/site/public/docs/en/3.5.0/guide_next_index.md.html
cordova/site/public/docs/en/3.5.0/guide_overview_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_amazonfireos_config.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_amazonfireos_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_amazonfireos_plugin.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_amazonfireos_webview.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_android_config.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_android_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_android_plugin.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_android_tools.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_android_upgrade.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_android_webview.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_blackberry10_config.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_blackberry10_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_blackberry10_plugin.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_blackberry10_tools.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_blackberry10_upgrade.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_blackberry_upgrade.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_firefoxos_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_ios_config.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_ios_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_ios_plugin.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_ios_tools.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_ios_upgrade.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_ios_webview.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_tizen_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_ubuntu_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_win8_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_win8_upgrade.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_wp8_index.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_wp8_parallels.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_wp8_plugin.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_wp8_upgrade.md.html
cordova/site/public/docs/en/3.5.0/guide_platforms_wp8_vmware.md.html
cordova/site/public/docs/en/3.5.0/guide_support_index.md.html
cordova/site/public/docs/en/3.5.0/index.html
cordova/site/public/docs/en/3.5.0/plugin_ref_plugman.md.html
cordova/site/public/docs/en/3.5.0/plugin_ref_spec.md.html
cordova/site/public/docs/en/edge/_index.html
cordova/site/public/docs/en/edge/_index.json
cordova/site/public/docs/en/edge/config_ref_images.md.html
cordova/site/public/docs/en/edge/config_ref_index.md.html
cordova/site/public/docs/en/edge/cordova_events_events.md.html
cordova/site/public/docs/en/edge/cordova_plugins_pluginapis.md.html
cordova/site/public/docs/en/edge/cordova_storage_storage.md.html
cordova/site/public/docs/en/edge/guide_appdev_privacy_index.md.html
cordova/site/public/docs/en/edge/guide_appdev_security_index.md.html
cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html
cordova/site/public/docs/en/edge/guide_cli_index.md.html
cordova/site/public/docs/en/edge/guide_hybrid_plugins_index.md.html
cordova/site/public/docs/en/edge/guide_hybrid_webviews_index.md.html
cordova/site/public/docs/en/edge/guide_next_index.md.html
cordova/site/public/docs/en/edge/guide_overview_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_config.md.html
cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_plugin.md.html
cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_webview.md.html
cordova/site/public/docs/en/edge/guide_platforms_android_config.md.html
cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_android_plugin.md.html
cordova/site/public/docs/en/edge/guide_platforms_android_tools.md.html
cordova/site/public/docs/en/edge/guide_platforms_android_upgrade.md.html
cordova/site/public/docs/en/edge/guide_platforms_android_webview.md.html
cordova/site/public/docs/en/edge/guide_platforms_blackberry10_config.md.html
cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_blackberry10_plugin.md.html
cordova/site/public/docs/en/edge/guide_platforms_blackberry10_tools.md.html
cordova/site/public/docs/en/edge/guide_platforms_blackberry10_upgrade.md.html
cordova/site/public/docs/en/edge/guide_platforms_blackberry_upgrade.md.html
cordova/site/public/docs/en/edge/guide_platforms_firefoxos_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_config.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_upgrade.md.html
cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html
cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_ubuntu_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_win8_upgrade.md.html
cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html
cordova/site/public/docs/en/edge/guide_platforms_wp8_parallels.md.html
cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html
cordova/site/public/docs/en/edge/guide_platforms_wp8_upgrade.md.html
cordova/site/public/docs/en/edge/guide_platforms_wp8_vmware.md.html
cordova/site/public/docs/en/edge/guide_support_index.md.html
cordova/site/public/docs/en/edge/index.html
cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html
cordova/site/public/docs/en/edge/plugin_ref_spec.md.html
Modified: cordova/site/public/docs/en/3.5.0/_index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/_index.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/_index.html (original)
+++ cordova/site/public/docs/en/3.5.0/_index.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Keyword Index</h1>
@@ -153,6 +157,8 @@
<div id="content">
+
+
<h1>Keyword Index</h1>
<div id="index">
@@ -170,6 +176,7 @@
<li><a href="guide_platforms_android_webview.md.html#Android%20WebViews">Android WebViews</a></li>
<li><a href="index.html#API%20Reference">API Reference</a></li>
</ul>
+
<h2>B</h2>
<ul>
@@ -180,18 +187,21 @@
<li><a href="guide_platforms_blackberry10_plugin.md.html#BlackBerry%2010%20Plugins">BlackBerry 10 Plugins</a></li>
<li><a href="guide_platforms_blackberry10_tools.md.html#BlackBerry%2010%20Shell%20Tool%20Guide">BlackBerry 10 Shell Tool Guide</a></li>
</ul>
+
<h2>C</h2>
<ul>
<li><a href="guide_platforms_wp8_parallels.md.html#Configuring%20Parallels%20Desktop">Configuring Parallels Desktop</a></li>
<li><a href="guide_platforms_wp8_vmware.md.html#Configuring%20VMWare%20Fusion">Configuring VMWare Fusion</a></li>
</ul>
+
<h2>D</h2>
<ul>
<li><a href="guide_next_index.md.html#Debugging">Debugging</a></li>
<li><a href="cordova_events_events.md.html#deviceready">deviceready</a></li>
</ul>
+
<h2>E</h2>
<ul>
@@ -199,22 +209,26 @@
<li><a href="cordova_events_events.md.html#endcallbutton">endcallbutton</a></li>
<li><a href="cordova_events_events.md.html#Events">Events</a></li>
</ul>
+
<h2>F</h2>
<ul>
<li><a href="guide_platforms_firefoxos_index.md.html#Firefox%20OS%20Platform%20Guide">Firefox OS Platform Guide</a></li>
</ul>
+
<h2>G</h2>
<ul>
<li><a href="guide_next_index.md.html#Getting%20Help">Getting Help</a></li>
<li><a href="index.html#Guides">Guides</a></li>
</ul>
+
<h2>H</h2>
<ul>
<li><a href="guide_next_index.md.html#Handling%20Upgrades">Handling Upgrades</a></li>
</ul>
+
<h2>I</h2>
<ul>
@@ -225,26 +239,31 @@
<li><a href="guide_platforms_ios_tools.md.html#iOS%20Shell%20Tool%20Guide">iOS Shell Tool Guide</a></li>
<li><a href="guide_platforms_ios_webview.md.html#iOS%20WebViews">iOS WebViews</a></li>
</ul>
+
<h2>K</h2>
<ul>
<li><a href="guide_next_index.md.html#Keeping%20Up">Keeping Up</a></li>
</ul>
+
<h2>M</h2>
<ul>
<li><a href="cordova_events_events.md.html#menubutton">menubutton</a></li>
</ul>
+
<h2>N</h2>
<ul>
<li><a href="guide_next_index.md.html#Next%20Steps">Next Steps</a></li>
</ul>
+
<h2>O</h2>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
</ul>
+
<h2>P</h2>
<ul>
@@ -256,11 +275,13 @@
<li><a href="plugin_ref_spec.md.html#Plugin%20Specification">Plugin Specification</a></li>
<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
</ul>
+
<h2>R</h2>
<ul>
<li><a href="cordova_events_events.md.html#resume">resume</a></li>
</ul>
+
<h2>S</h2>
<ul>
@@ -269,6 +290,7 @@
<li><a href="cordova_events_events.md.html#startcallbutton">startcallbutton</a></li>
<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
</ul>
+
<h2>T</h2>
<ul>
@@ -277,6 +299,7 @@
<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
<li><a href="guide_platforms_tizen_index.md.html#Tizen%20Platform%20Guide">Tizen Platform Guide</a></li>
</ul>
+
<h2>U</h2>
<ul>
@@ -290,12 +313,14 @@
<li><a href="guide_next_index.md.html#User%20Interface">User Interface</a></li>
<li><a href="plugin_ref_plugman.md.html#Using%20Plugman%20to%20Manage%20Plugins">Using Plugman to Manage Plugins</a></li>
</ul>
+
<h2>V</h2>
<ul>
<li><a href="cordova_events_events.md.html#volumedownbutton">volumedownbutton</a></li>
<li><a href="cordova_events_events.md.html#volumeupbutton">volumeupbutton</a></li>
</ul>
+
<h2>W</h2>
<ul>
@@ -311,6 +336,7 @@
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>
Modified: cordova/site/public/docs/en/3.5.0/config_ref_images.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/config_ref_images.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/config_ref_images.md.html (original)
+++ cordova/site/public/docs/en/3.5.0/config_ref_images.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Icons and Splash Screens</h1>
@@ -163,9 +167,7 @@ screen for various platforms, both when
(described in <a href="guide_cli_index.md.html#The%20Command-Line%20Interface">The Command-Line Interface</a>) or using platform-specific
SDK tools (detailed in the <a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a>).</p>
-<h2>
-<a name="Icons%20and%20Splash%20Screens_configuring_icons_in_the_cli">Configuring Icons in the CLI</a>
-</h2>
+<h2><a name="Icons%20and%20Splash%20Screens_configuring_icons_in_the_cli">Configuring Icons in the CLI</a></h2>
<p>When working in the CLI you can define app icon(s) via <code><icon></code> element (<code>config.xml</code>).
If you do not specify an icon then the Apache Cordova logo is used.</p>
@@ -284,9 +286,7 @@ different screen resolutions.</p>
</platform>
</code></pre>
-<h2>
-<a name="Icons%20and%20Splash%20Screens_configuring_splash_screens_in_the_cli">Configuring Splash Screens in the CLI</a>
-</h2>
+<h2><a name="Icons%20and%20Splash%20Screens_configuring_splash_screens_in_the_cli">Configuring Splash Screens in the CLI</a></h2>
<p>Use the Splashscreen API to enable display of an app's introductory
splash screen on many platforms. When working in the CLI, splash
@@ -333,9 +333,7 @@ Guides</a>.</p>
<p>Don't forget to install the SplashScreen plugin before trying to use the
<code>navigator.splashscreen.hide()</code> or <code>navigator.splashscreen.show()</code> methods.</p>
-<h2>
-<a name="Icons%20and%20Splash%20Screens_splash_screens_for_the_android_platform">Splash Screens for the Android Platform</a>
-</h2>
+<h2><a name="Icons%20and%20Splash%20Screens_splash_screens_for_the_android_platform">Splash Screens for the Android Platform</a></h2>
<p>Place <a class="external" href="https://developer.android.com/tools/help/draw9patch.html">9-patch image</a>
files in the Android project's <code>platforms/android/res/drawable*</code> directories.</p>
@@ -348,6 +346,7 @@ files in the Android project's <code>pla
<li>medium (mdpi): at least 470 Ã 320</li>
<li>small (ldpi): at least 426 Ã 320</li>
</ul>
+
<p>When creating a new Android project, the default splash screen images
provided in the Cordova sample app should already be present in the
<code>platforms/android/res/drawable*</code> directories. Feel free to replace these
@@ -390,9 +389,7 @@ which is likely longer than necessary.
This event-driven approach is highly recommended versus having the splash
screen visible for always a fixed duration.</p>
-<h2>
-<a name="Icons%20and%20Splash%20Screens_splash_screens_for_the_ios_platform">Splash Screens for the iOS Platform</a>
-</h2>
+<h2><a name="Icons%20and%20Splash%20Screens_splash_screens_for_the_ios_platform">Splash Screens for the iOS Platform</a></h2>
<p>Copy splash screen images into the iOS project's <code>Resources/splash</code>
directory. Only add those images for the devices you want to support,
@@ -407,9 +404,8 @@ such as iPad or iPhone. The size of each
<li>Default@2x~iphone.png (640x960 pixels)</li>
<li>Default~iphone.png (320x480 pixels)</li>
</ul>
-<h2>
-<a name="Icons%20and%20Splash%20Screens_splash_screens_for_the_blackberry_10_platform">Splash Screens for the BlackBerry 10 Platform</a>
-</h2>
+
+<h2><a name="Icons%20and%20Splash%20Screens_splash_screens_for_the_blackberry_10_platform">Splash Screens for the BlackBerry 10 Platform</a></h2>
<p>Add a rim:splash element to config.xml for each resolution and locale you wish
to support:</p>
@@ -420,6 +416,7 @@ to support:</p>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>
Modified: cordova/site/public/docs/en/3.5.0/config_ref_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/config_ref_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/config_ref_index.md.html (original)
+++ cordova/site/public/docs/en/3.5.0/config_ref_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>The config.xml File</h1>
@@ -191,13 +195,12 @@ See the following sections for platform-
<li><a href="guide_platforms_android_config.md.html#Android%20Configuration">Android Configuration</a></li>
<li><a href="guide_platforms_blackberry10_config.md.html#BlackBerry%2010%20Configuration">BlackBerry 10 Configuration</a></li>
</ul>
+
<p>In addition to the various configuration options detailed below, you
can also configure an application's core set of images for each target
platform. See <a href="config_ref_images.md.html#Icons%20and%20Splash%20Screens">Icons and Splash Screens</a> for more information.</p>
-<h2>
-<a name="The%20config.xml%20File_core_configuration_elements">Core Configuration Elements</a>
-</h2>
+<h2><a name="The%20config.xml%20File_core_configuration_elements">Core Configuration Elements</a></h2>
<p>This example shows the default <code>config.xml</code> generated by the CLI's
<code>create</code> command, described in <a href="guide_cli_index.md.html#The%20Command-Line%20Interface">The Command-Line Interface</a>:</p>
@@ -240,9 +243,8 @@ case-insensitive. Many preferences are
platforms, as listed at the top of this page. The following sections
detail preferences that apply to more than one platform.</p></li>
</ul>
-<h2>
-<a name="The%20config.xml%20File_global_preferences">Global Preferences</a>
-</h2>
+
+<h2><a name="The%20config.xml%20File_global_preferences">Global Preferences</a></h2>
<p>The following global preferences apply to all platforms:</p>
@@ -268,9 +270,8 @@ default settings (usually portrait-only)
<code>config.xml</code> file.</p>
</li>
</ul>
-<h2>
-<a name="The%20config.xml%20File_multi_platform_preferences">Multi-Platform Preferences</a>
-</h2>
+
+<h2><a name="The%20config.xml%20File_multi_platform_preferences">Multi-Platform Preferences</a></h2>
<p>The following preferences apply to more than one platform, but not to
all of them:</p>
@@ -312,9 +313,8 @@ keyboard, helping users navigate from on
<p>Applies to iOS and BlackBerry. </p>
</li>
</ul>
-<h2>
-<a name="The%20config.xml%20File_the_feature_element">The feature Element</a>
-</h2>
+
+<h2><a name="The%20config.xml%20File_the_feature_element">The feature Element</a></h2>
<p>If you use the CLI to build applications, you use the <code>plugin</code> command
to enable device APIs. This does not modify the top-level <code>config.xml</code>
@@ -340,9 +340,7 @@ Device API for Android projects:</p>
<p>See the <a href="index.md.html#API%20Reference">API Reference</a> for details on how to specify each feature. See
the <a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a> for more information on plugins.</p>
-<h2>
-<a name="The%20config.xml%20File_the_platform_element">The platform Element</a>
-</h2>
+<h2><a name="The%20config.xml%20File_the_platform_element">The platform Element</a></h2>
<p>When using the CLI to build applications, it is sometimes necessary to specify
preferences or other elements specific to a particular platform. Use the <code><platform></code>
@@ -359,6 +357,7 @@ Fullscreen preference:</p>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>
Modified: cordova/site/public/docs/en/3.5.0/cordova_events_events.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/cordova_events_events.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/cordova_events_events.md.html (original)
+++ cordova/site/public/docs/en/3.5.0/cordova_events_events.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Events</h1>
@@ -216,9 +220,7 @@ Events added by org.apache.cordova.netwo
<p>Cordova lifecycle events.</p>
</blockquote>
-<h2>
-<a name="Events_event_types">Event Types</a>
-</h2>
+<h2><a name="Events_event_types">Event Types</a></h2>
<ul>
<li><a href="cordova_events_events.md.html#deviceready">deviceready</a></li>
@@ -232,28 +234,28 @@ Events added by org.apache.cordova.netwo
<li><a href="cordova_events_events.md.html#volumedownbutton">volumedownbutton</a></li>
<li><a href="cordova_events_events.md.html#volumeupbutton">volumeupbutton</a></li>
</ul>
-<h2>
-<a name="Events_events_added_by_org_apache_cordova_battery_status">
+
+<h2><a name="Events_events_added_by_org_apache_cordova_battery_status">
Events added by org.apache.cordova.battery-status
-</a>
-</h2>
+</a></h2>
<ul>
<li>batterycritical</li>
<li>batterylow</li>
<li>batterystatus</li>
</ul>
-<h2>
-<a name="Events_events_added_by_org_apache_cordova_network_information">
+
+<h2><a name="Events_events_added_by_org_apache_cordova_network_information">
Events added by org.apache.cordova.network-information
-</a>
-</h2>
+</a></h2>
<ul>
<li>online</li>
<li>offline</li>
</ul>
+
<hr>
+
<h1><a name="deviceready">deviceready</a></h1>
<p>The event fires when Cordova is fully loaded.</p>
@@ -261,9 +263,7 @@ Events added by org.apache.cordova.netwo
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#deviceready">deviceready</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="deviceready_details">Details</a>
-</h2>
+<h2><a name="deviceready_details">Details</a></h2>
<p>This event is essential to any application. It signals that Cordova's
device APIs have loaded and are ready to access.</p>
@@ -283,9 +283,7 @@ once the HTML document's DOM has loaded.
event handler registered after the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires has its
callback function called immediately.</p>
-<h2>
-<a name="deviceready_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="deviceready_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>Amazon Fire OS</li>
@@ -293,12 +291,11 @@ callback function called immediately.</p
<li>BlackBerry 10</li>
<li>iOS</li>
<li>Tizen</li>
-<li>Windows Phone 7 and 8</li>
+<li>Windows Phone 8</li>
<li>Windows 8</li>
</ul>
-<h2>
-<a name="deviceready_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="deviceready_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#deviceready">deviceready</a>", onDeviceReady, false);
@@ -307,9 +304,7 @@ function onDeviceReady() {
}
</code></pre>
-<h2>
-<a name="deviceready_full_example">Full Example</a>
-</h2>
+<h2><a name="deviceready_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE html>
<html>
@@ -339,6 +334,7 @@ function onDeviceReady() {
</code></pre>
<hr>
+
<h1><a name="pause">pause</a></h1>
<p>The event fires when an application is put into the background.</p>
@@ -346,9 +342,7 @@ function onDeviceReady() {
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#pause">pause</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="pause_details">Details</a>
-</h2>
+<h2><a name="pause_details">Details</a></h2>
<p>The <code><a href="cordova_events_events.md.html#pause">pause</a></code> event fires when the native platform puts the application
into the background, typically when the user switches to a different
@@ -357,21 +351,18 @@ application.</p>
<p>Applications typically should use <code>document.addEventListener</code> to
attach an event listener once the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires.</p>
-<h2>
-<a name="pause_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="pause_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>Amazon Fire OS</li>
<li>Android</li>
<li>BlackBerry 10</li>
<li>iOS</li>
-<li>Windows Phone 7 and 8</li>
+<li>Windows Phone 8</li>
<li>Windows 8</li>
</ul>
-<h2>
-<a name="pause_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="pause_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#pause">pause</a>", onPause, false);
@@ -380,9 +371,7 @@ function onPause() {
}
</code></pre>
-<h2>
-<a name="pause_full_example">Full Example</a>
-</h2>
+<h2><a name="pause_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE html>
<html>
@@ -416,9 +405,7 @@ function onPause() {
</html>
</code></pre>
-<h2>
-<a name="pause_ios_quirks">iOS Quirks</a>
-</h2>
+<h2><a name="pause_ios_quirks">iOS Quirks</a></h2>
<p>In the <code><a href="cordova_events_events.md.html#pause">pause</a></code> handler, any calls to the Cordova API or to native
plugins that go through Objective-C do not work, along with any
@@ -437,6 +424,7 @@ multi-tasking by setting
to <code>YES</code>. To run when locked on iOS 4, this setting does not matter.</p>
<hr>
+
<h1><a name="resume">resume</a></h1>
<p>The event fires when an application is retrieved from the background.</p>
@@ -444,9 +432,7 @@ to <code>YES</code>. To run when locked
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#resume">resume</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="resume_details">Details</a>
-</h2>
+<h2><a name="resume_details">Details</a></h2>
<p>The <code><a href="cordova_events_events.md.html#resume">resume</a></code> event fires when the native platform pulls the
application out from the background.</p>
@@ -454,21 +440,18 @@ application out from the background.</p>
<p>Applications typically should use <code>document.addEventListener</code> to
attach an event listener once the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires.</p>
-<h2>
-<a name="resume_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="resume_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>Amazon Fire OS</li>
<li>Android</li>
<li>BlackBerry 10</li>
<li>iOS</li>
-<li>Windows Phone 7 and 8</li>
+<li>Windows Phone 8</li>
<li>Windows 8</li>
</ul>
-<h2>
-<a name="resume_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="resume_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#resume">resume</a>", onResume, false);
@@ -477,9 +460,7 @@ function onResume() {
}
</code></pre>
-<h2>
-<a name="resume_full_example">Full Example</a>
-</h2>
+<h2><a name="resume_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE html>
<html>
@@ -513,9 +494,7 @@ function onResume() {
</html>
</code></pre>
-<h2>
-<a name="resume_ios_quirks">iOS Quirks</a>
-</h2>
+<h2><a name="resume_ios_quirks">iOS Quirks</a></h2>
<p>Any interactive functions called from a <code><a href="cordova_events_events.md.html#pause">pause</a></code> event handler execute
later when the app resumes, as signaled by the <code><a href="cordova_events_events.md.html#resume">resume</a></code> event. These
@@ -552,7 +531,9 @@ function onResume() {
</code></pre>
</li>
</ul>
+
<hr>
+
<h1><a name="backbutton">backbutton</a></h1>
<p>The event fires when the user presses the back button.</p>
@@ -560,9 +541,7 @@ function onResume() {
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#backbutton">backbutton</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="backbutton_details">Details</a>
-</h2>
+<h2><a name="backbutton_details">Details</a></h2>
<p>To override the default back-button behavior, register an event
listener for the <code><a href="cordova_events_events.md.html#backbutton">backbutton</a></code> event, typically by calling
@@ -570,19 +549,16 @@ listener for the <code><a href="cordova_
It is no longer necessary to call any other method to override the
back-button behavior.</p>
-<h2>
-<a name="backbutton_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="backbutton_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>Amazon Fire OS</li>
<li>Android</li>
<li>BlackBerry 10</li>
-<li>Windows Phone 7 and 8</li>
+<li>Windows Phone 8</li>
</ul>
-<h2>
-<a name="backbutton_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="backbutton_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#backbutton">backbutton</a>", onBackKeyDown, false);
@@ -591,9 +567,7 @@ function onBackKeyDown() {
}
</code></pre>
-<h2>
-<a name="backbutton_full_example">Full Example</a>
-</h2>
+<h2><a name="backbutton_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE html>
<html>
@@ -629,6 +603,7 @@ function onBackKeyDown() {
</code></pre>
<hr>
+
<h1><a name="menubutton">menubutton</a></h1>
<p>The event fires when the user presses the menu button.</p>
@@ -636,27 +611,22 @@ function onBackKeyDown() {
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#menubutton">menubutton</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="menubutton_details">Details</a>
-</h2>
+<h2><a name="menubutton_details">Details</a></h2>
<p>Applying an event handler overrides the default menu button behavior.</p>
<p>Applications typically should use <code>document.addEventListener</code> to
attach an event listener once the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires.</p>
-<h2>
-<a name="menubutton_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="menubutton_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>Amazon Fire OS</li>
<li>Android</li>
<li>BlackBerry 10</li>
</ul>
-<h2>
-<a name="menubutton_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="menubutton_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#menubutton">menubutton</a>", onMenuKeyDown, false);
@@ -665,9 +635,7 @@ function onMenuKeyDown() {
}
</code></pre>
-<h2>
-<a name="menubutton_full_example">Full Example</a>
-</h2>
+<h2><a name="menubutton_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
@@ -704,6 +672,7 @@ function onMenuKeyDown() {
</code></pre>
<hr>
+
<h1><a name="searchbutton">searchbutton</a></h1>
<p>The event fires when the user presses the search button on Android.</p>
@@ -711,9 +680,7 @@ function onMenuKeyDown() {
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#searchbutton">searchbutton</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="searchbutton_details">Details</a>
-</h2>
+<h2><a name="searchbutton_details">Details</a></h2>
<p>If you need to override the default search button behavior on Android
you can register an event listener for the '<a href="cordova_events_events.md.html#searchbutton">searchbutton</a>' event.</p>
@@ -721,16 +688,13 @@ you can register an event listener for t
<p>Applications typically should use <code>document.addEventListener</code> to
attach an event listener once the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires.</p>
-<h2>
-<a name="searchbutton_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="searchbutton_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>Android</li>
</ul>
-<h2>
-<a name="searchbutton_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="searchbutton_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#searchbutton">searchbutton</a>", onSearchKeyDown, false);
@@ -739,9 +703,7 @@ function onSearchKeyDown() {
}
</code></pre>
-<h2>
-<a name="searchbutton_full_example">Full Example</a>
-</h2>
+<h2><a name="searchbutton_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
@@ -778,6 +740,7 @@ function onSearchKeyDown() {
</code></pre>
<hr>
+
<h1><a name="startcallbutton">startcallbutton</a></h1>
<p>The event fires when the user presses the start call button.</p>
@@ -785,9 +748,7 @@ function onSearchKeyDown() {
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#startcallbutton">startcallbutton</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="startcallbutton_details">Details</a>
-</h2>
+<h2><a name="startcallbutton_details">Details</a></h2>
<p>If you need to override the default start call behavior you can
register an event listener for the <code><a href="cordova_events_events.md.html#startcallbutton">startcallbutton</a></code> event.</p>
@@ -795,16 +756,13 @@ register an event listener for the <code
<p>Applications typically should use <code>document.addEventListener</code> to
attach an event listener once the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires.</p>
-<h2>
-<a name="startcallbutton_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="startcallbutton_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>BlackBerry 10</li>
</ul>
-<h2>
-<a name="startcallbutton_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="startcallbutton_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#startcallbutton">startcallbutton</a>", onStartCallKeyDown, false);
@@ -813,9 +771,7 @@ function onStartCallKeyDown() {
}
</code></pre>
-<h2>
-<a name="startcallbutton_full_example">Full Example</a>
-</h2>
+<h2><a name="startcallbutton_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
@@ -852,6 +808,7 @@ function onStartCallKeyDown() {
</code></pre>
<hr>
+
<h1><a name="endcallbutton">endcallbutton</a></h1>
<p>This event fires when the user presses the end call button.</p>
@@ -859,25 +816,20 @@ function onStartCallKeyDown() {
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#endcallbutton">endcallbutton</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="endcallbutton_details">Details</a>
-</h2>
+<h2><a name="endcallbutton_details">Details</a></h2>
<p>The event overrides the default end call behavior.</p>
<p>Applications typically should use <code>document.addEventListener</code> to
attach an event listener once the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires.</p>
-<h2>
-<a name="endcallbutton_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="endcallbutton_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>BlackBerry 10</li>
</ul>
-<h2>
-<a name="endcallbutton_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="endcallbutton_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#endcallbutton">endcallbutton</a>", onEndCallKeyDown, false);
@@ -886,9 +838,7 @@ function onEndCallKeyDown() {
}
</code></pre>
-<h2>
-<a name="endcallbutton_full_example">Full Example</a>
-</h2>
+<h2><a name="endcallbutton_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
@@ -925,6 +875,7 @@ function onEndCallKeyDown() {
</code></pre>
<hr>
+
<h1><a name="volumedownbutton">volumedownbutton</a></h1>
<p>The event fires when the user presses the volume down button.</p>
@@ -932,9 +883,7 @@ function onEndCallKeyDown() {
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#volumedownbutton">volumedownbutton</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="volumedownbutton_details">Details</a>
-</h2>
+<h2><a name="volumedownbutton_details">Details</a></h2>
<p>If you need to override the default volume down behavior you can
register an event listener for the <code><a href="cordova_events_events.md.html#volumedownbutton">volumedownbutton</a></code> event.</p>
@@ -942,16 +891,13 @@ register an event listener for the <code
<p>Applications typically should use <code>document.addEventListener</code> to
attach an event listener once the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires.</p>
-<h2>
-<a name="volumedownbutton_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="volumedownbutton_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>BlackBerry 10</li>
</ul>
-<h2>
-<a name="volumedownbutton_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="volumedownbutton_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#volumedownbutton">volumedownbutton</a>", onVolumeDownKeyDown, false);
@@ -960,9 +906,7 @@ function onVolumeDownKeyDown() {
}
</code></pre>
-<h2>
-<a name="volumedownbutton_full_example">Full Example</a>
-</h2>
+<h2><a name="volumedownbutton_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
@@ -999,6 +943,7 @@ function onVolumeDownKeyDown() {
</code></pre>
<hr>
+
<h1><a name="volumeupbutton">volumeupbutton</a></h1>
<p>The event fires when the user presses the volume up button.</p>
@@ -1006,9 +951,7 @@ function onVolumeDownKeyDown() {
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#volumeupbutton">volumeupbutton</a>", yourCallbackFunction, false);
</code></pre>
-<h2>
-<a name="volumeupbutton_details">Details</a>
-</h2>
+<h2><a name="volumeupbutton_details">Details</a></h2>
<p>If you need to override the default volume up behavior you can
register an event listener for the <code><a href="cordova_events_events.md.html#volumeupbutton">volumeupbutton</a></code> event.</p>
@@ -1016,16 +959,13 @@ register an event listener for the <code
<p>Applications typically should use <code>document.addEventListener</code> to
attach an event listener once the <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> event fires.</p>
-<h2>
-<a name="volumeupbutton_supported_platforms">Supported Platforms</a>
-</h2>
+<h2><a name="volumeupbutton_supported_platforms">Supported Platforms</a></h2>
<ul>
<li>BlackBerry 10</li>
</ul>
-<h2>
-<a name="volumeupbutton_quick_example">Quick Example</a>
-</h2>
+
+<h2><a name="volumeupbutton_quick_example">Quick Example</a></h2>
<pre class="prettyprint"><code>document.addEventListener("<a href="cordova_events_events.md.html#volumeupbutton">volumeupbutton</a>", onVolumeUpKeyDown, false);
@@ -1034,9 +974,7 @@ function onVolumeUpKeyDown() {
}
</code></pre>
-<h2>
-<a name="volumeupbutton_full_example">Full Example</a>
-</h2>
+<h2><a name="volumeupbutton_full_example">Full Example</a></h2>
<pre class="prettyprint"><code><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
@@ -1076,6 +1014,7 @@ function onVolumeUpKeyDown() {
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>
Modified: cordova/site/public/docs/en/3.5.0/cordova_plugins_pluginapis.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/cordova_plugins_pluginapis.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/cordova_plugins_pluginapis.md.html (original)
+++ cordova/site/public/docs/en/3.5.0/cordova_plugins_pluginapis.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Plugin APIs</h1>
@@ -280,12 +284,14 @@
</blockquote>
</li>
</ul>
+
<p>Non-English translations of these plugin docs can be found by looking at older versions of the Cordova documentation. Use the drop-down menu at the very top-right of this site to switch versions.</p>
</div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>
Modified: cordova/site/public/docs/en/3.5.0/cordova_storage_storage.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/cordova_storage_storage.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/cordova_storage_storage.md.html (original)
+++ cordova/site/public/docs/en/3.5.0/cordova_storage_storage.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Storage</h1>
@@ -166,22 +170,14 @@ See
<a class="external" href="http://www.html5rocks.com/en/features/storage">html5rocks</a>.
for a more complete overview and examples.</p>
-<h2>
-<a name="Storage_localstorage">LocalStorage</a>
-</h2>
+<h2><a name="Storage_localstorage">LocalStorage</a></h2>
<p>Also known as <em>web storage</em>, <em>simple storage</em>, or by its alternate
<em>session storage</em> interface, this API provides synchronous key/value
pair storage, and is available in underlying WebView implementations.
Refer to <a class="external" href="http://www.w3.org/TR/webstorage/">the W3C spec</a> for details.</p>
-<p><strong>Windows Phone 7 Quirk</strong>: Dot notation is <em>not</em> available, so be sure
-to use <code>setItem</code> or <code>getItem</code> rather than access keys directly from
-the storage object, as in <code>window.localStorage.someKey</code>.</p>
-
-<h2>
-<a name="Storage_websql">WebSQL</a>
-</h2>
+<h2><a name="Storage_websql">WebSQL</a></h2>
<p>This API is available in the underlying WebView.
The <a class="external" href="http://dev.w3.org/html5/webdatabase/">Web SQL Database Specification</a>
@@ -195,9 +191,8 @@ offers more full-featured database table
<li>iOS</li>
<li>Tizen</li>
</ul>
-<h2>
-<a name="Storage_indexeddb">IndexedDB</a>
-</h2>
+
+<h2><a name="Storage_indexeddb">IndexedDB</a></h2>
<p>This API is available in the underlying WebView.
<a class="external" href="http://www.w3.org/TR/IndexedDB/">Indexed DB</a> offers more features
@@ -206,12 +201,12 @@ than LocalStorage but fewer than WebSQL.
<p>The following platforms support IndexedDB:</p>
<ul>
-<li>Windows Phone 8</li>
<li>BlackBerry 10</li>
+<li>Windows Phone 8</li>
+<li>Windows 8</li>
</ul>
-<h2>
-<a name="Storage_plugin_based_options">Plugin-Based Options</a>
-</h2>
+
+<h2><a name="Storage_plugin_based_options">Plugin-Based Options</a></h2>
<p>In addition to the storage APIs listed above, the
<a class="external" href="https://github.com/apache/cordova-plugin-file/blob/master/doc/index.md">File API</a>
@@ -222,6 +217,7 @@ allows you to cache data on the local fi
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>
Modified: cordova/site/public/docs/en/3.5.0/guide_appdev_privacy_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/guide_appdev_privacy_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/guide_appdev_privacy_index.md.html (original)
+++ cordova/site/public/docs/en/3.5.0/guide_appdev_privacy_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Privacy Guide</h1>
@@ -229,6 +233,7 @@ it is stored on the device or on your ba
also develop an appropriate data retention policy that is
implemented within the app and on your backend servers.</p></li>
</ul>
+
<p>Following are some additional helpful mobile privacy guides for developers:</p>
<ul>
@@ -238,10 +243,12 @@ implemented within the app and on your b
<li><p>Federal Trade Commission, <a class="external" href="http://www.ftc.gov/os/2013/02/130201mobileprivacyreport.pdf">Mobile Privacy Disclosures: Building Trust Through Transparency</a></p></li>
<li><p>Future of Privacy Forum, <a class="external" href="http://www.applicationprivacy.org">Application Privacy</a> Website</p></li>
</ul>
-</div>
+
+ </div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>
Modified: cordova/site/public/docs/en/3.5.0/guide_appdev_security_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/guide_appdev_security_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/guide_appdev_security_index.md.html (original)
+++ cordova/site/public/docs/en/3.5.0/guide_appdev_security_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Security Guide</h1>
@@ -163,9 +167,7 @@
<p>The following guide includes some security best practices that you should consider when developing a Cordova application. Please be aware that security is a very complicated topic and therefore this guide is not exhaustive. If you believe you can contribute to this guide, please feel free to file an issue in Cordova's bug tracker under <a class="external" href="https://issues.apache.org/jira/browse/CB/component/12316407">"Documentation"</a>. This guide is designed to be applicable to general Cordova development (all platforms) but special platform-specific considerations will be noted. </p>
-<h2>
-<a name="Security%20Guide_this_guide_discusses_the_following_topics">This guide discusses the following topics:</a>
-</h2>
+<h2><a name="Security%20Guide_this_guide_discusses_the_following_topics">This guide discusses the following topics:</a></h2>
<ul>
<li>Whitelist</li>
@@ -176,9 +178,8 @@
<li>General Tips</li>
<li>Recommended Articles and Other Resources</li>
</ul>
-<h2>
-<a name="Security%20Guide_whitelist">Whitelist</a>
-</h2>
+
+<h2><a name="Security%20Guide_whitelist">Whitelist</a></h2>
<ul>
<li><p>Read and understand the <a href="guide_appdev_whitelist_index.md.html#Whitelist%20Guide">Whitelist Guide</a></p></li>
@@ -187,25 +188,20 @@
If you want network requests to be evaluated against the whitelist, then it is important to change this and only allow the domains to which you need access. This can be done by editing the application-level config file located at:
<code>{project}/config.xml</code> (recent projects) or <code>{project}/www/config.xml</code> (older projects)</p></li>
<li><p>Android's Whitelist on Cordova 2.9.x is considered secure, however, it was discovered that if foo.com is included in the whitelist, foo.com.evil.com would be able to pass the whitelist test. This was fixed in Cordova 3.x. </p></li>
-<li><p>Domain whitelisting does not work on Android API 10 and below, and WP7/8 for iframes and XMLHttpRequest. This means an attacker can load any domain in an iframe and any script on that page within the iframe can directly access Cordova JavaScript objects and the corresponding native Java objects. You should take this into consideration when building applications for these platforms. In practice this means making sure you target an Android API higher than 10, and that if possible you do not use an iframe to load external content - use the inAppBrowser plugin or other third-party plugins. </p></li>
+<li><p>Domain whitelisting does not work on Android API 10 and below, and WP8 for iframes and XMLHttpRequest. This means an attacker can load any domain in an iframe and any script on that page within the iframe can directly access Cordova JavaScript objects and the corresponding native Java objects. You should take this into consideration when building applications for these platforms. In practice this means making sure you target an Android API higher than 10, and that if possible you do not use an iframe to load external content - use the inAppBrowser plugin or other third-party plugins. </p></li>
</ul>
-<h2>
-<a name="Security%20Guide_iframes_and_the_callback_id_mechanism">Iframes and the Callback Id Mechanism</a>
-</h2>
+
+<h2><a name="Security%20Guide_iframes_and_the_callback_id_mechanism">Iframes and the Callback Id Mechanism</a></h2>
<p>If content is served in an iframe from a whitelisted domain, that domain will have access to the native Cordova bridge. This means that if you whitelist a third-party advertising network and serve those ads through an iframe, it is possible that a malicious ad will be able to break out of the iframe and perform malicious actions. Because of this, you should generally not use iframes unless you control the server that hosts the iframe content. Also note that there are third party plugins available to support advertising networks. Note that this statement is not true for iOS, which intercepts everything including iframe connections. </p>
-<h2>
-<a name="Security%20Guide_certificate_pinning">Certificate Pinning</a>
-</h2>
+<h2><a name="Security%20Guide_certificate_pinning">Certificate Pinning</a></h2>
<p>Cordova does not support true certificate pinning. The main barrier to this is a lack of native APIs in Android for intercepting SSL connections to perform the check of the server's certificate. (Although it is possible to do certificate pinning on Android in Java using JSSE, the webview on Android is written in C++, and server connections are handled for you by the webview, so it is not possible to use Java and JSSE there.) Since Apache Cordova is meant to offer consistent APIs across multiple platforms, not having a capability in a major platform breaks that consistency.</p>
<p>There are ways to approximate certificate pinning, such as checking the server's public key (fingerprint) is the expected value when your application starts or at other various times during your application's lifetime. There are third-party plugins available for Cordova that can do that. However, this is not the same as true certificate pinning which automatically verifies the expected value on every connection to the server.</p>
-<h2>
-<a name="Security%20Guide_self_signed_certificates">Self-signed Certificates</a>
-</h2>
+<h2><a name="Security%20Guide_self_signed_certificates">Self-signed Certificates</a></h2>
<p>Using self-signed certificates on your server is not recommended. If you desire SSL, then it is highly recommended that your server have a certificate that has been properly signed by a well-known CA (certificate authority). The inability to do true certificate pinning makes this important.</p>
@@ -215,13 +211,9 @@ If you want network requests to be evalu
<p>When running Cordova on Android, using <code>android:debuggable="true"</code> in the application manifest will permit SSL errors such as certificate chain validation errors on self-signed certs. So you can use self-signed certs in this configuration, but this is not a configuration that should be used when your application is in production. It is meant to be used only during application development.</p>
-<h2>
-<a name="Security%20Guide_encrypted_storage">Encrypted storage</a>
-</h2>
-
-<h2>
-<a name="Security%20Guide_general_tips">General Tips</a>
-</h2>
+<h2><a name="Security%20Guide_encrypted_storage">Encrypted storage</a></h2>
+
+<h2><a name="Security%20Guide_general_tips">General Tips</a></h2>
<h3>Do not use Android Gingerbread!</h3>
@@ -230,45 +222,51 @@ If you want network requests to be evalu
<li>Gingerbread has been shown to be insecure and one of the most targeted mobile OSs <a class="external" href="http://bgr.com/2012/11/06/android-security-gingerbread-malware/">http://www.mobilemag.com/2012/11/06/andriod-2-3-gingerbread-security/</a>. </li>
<li>The Whitelist on Android does not work with Gingerbread or lower. This means an attacker can load malicious code in an iframe that would then have access to all of the Cordova APIs and could use that access to steal personal data, send SMS messages to premium-rate numbers, and perform other malicious acts. </li>
</ul>
+
<h3>Use InAppBrowser for outside links</h3>
<ul>
<li>Use the InAppBrowser when opening links to any outside website. This is much safer than whitelisting a domain name and including the content directly in your application because the InAppBrowser will use the native browser's security features and will not give the website access to your Cordova environment. Even if you trust the third party website and include it directly in your application, that third party website could link to malicious web content. </li>
</ul>
+
<h3>Validate all user input</h3>
<ul>
<li>Always validate any and all input that your application accepts. This includes usernames, passwords, dates, uploaded media, etc. Because an attacker could manipulate your HTML and JS assets (either by decompiling your application or using debugging tools like chrome://inspect), this validation should also be performed on your server, especially before handing the data off to any backend service. </li>
<li>Other sources where data should be validated: user documents, contacts, push notifications</li>
</ul>
+
<h3>Do not cache sensitive data</h3>
<ul>
<li>If usernames, password, geolocation information, and other sensitive data is cached, then it could potentially be retrieved later by an unauthorized user or application.</li>
</ul>
+
<h3>Don't use eval() unless you know what you're doing</h3>
<ul>
<li>The JavaScript function eval() has a long history of being abused. Using it incorrectly can open your code up for injection attacks, debugging difficulties, and slower code execution. </li>
</ul>
+
<h3>Do not assume that your source code is secure</h3>
<ul>
<li>Since a Cordova application is built from HTML and JavaScript assets that get packaged in a native container, you should not consider your code to be secure. It is possible to reverse engineer a Cordova application. </li>
</ul>
-<h2>
-<a name="Security%20Guide_recommended_articles_and_other_resources">Recommended Articles and Other Resources</a>
-</h2>
+
+<h2><a name="Security%20Guide_recommended_articles_and_other_resources">Recommended Articles and Other Resources</a></h2>
<ul>
<li><a class="external" href="https://www.owasp.org/index.php/HTML5_Security_Cheat_Sheet">HTML5 Security cheat sheet, detailing how to secure your HTML5 application</a></li>
<li><a class="external" href="https://github.com/phonegap/phonegap/wiki/Platform-Security">Phonegap's article on device security, such as using encrypted data</a></li>
<li><a class="external" href="http://www.cis.syr.edu/~wedu/Research/paper/webview_acsac2011.pdf">Whitepaper about well known security flaws in Webview based hybrid applications</a></li>
</ul>
-</div>
+
+ </div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>
Modified: cordova/site/public/docs/en/3.5.0/guide_appdev_whitelist_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.5.0/guide_appdev_whitelist_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/3.5.0/guide_appdev_whitelist_index.md.html (original)
+++ cordova/site/public/docs/en/3.5.0/guide_appdev_whitelist_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
specific language governing permissions and limitations
under the License.
--><html lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
-<meta name="generator" content="joDoc">
-<title>Apache Cordova API Documentation</title>
-<link rel="stylesheet" type="text/css" href="index.css">
-<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
-<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
-</head>
-<body>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+ <meta name="generator" content="joDoc">
+
+ <title>Apache Cordova API Documentation</title>
+
+ <link rel="stylesheet" type="text/css" href="index.css">
+ <link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+ <link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+ </head>
+ <body>
<div id="header">
<h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
<small>
@@ -99,6 +101,7 @@
<option value="3.1.0">3.1.0</option>
<option value="2.0.0">2.0.0</option>
</optgroup>
+<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
<optgroup label="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<option value="3.5.0">3.5.0</option>
<option value="3.4.0">3.4.0</option>
<option value="3.1.0">3.1.0</option>
-</optgroup></select></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Whitelist Guide</h1>
@@ -213,16 +217,13 @@ on each platform.)</p>
<p>This is the default value for newly created CLI projects.</p>
</li>
</ul>
-<h2>
-<a name="Whitelist%20Guide_amazon_fire_os_whitelisting">Amazon Fire OS Whitelisting</a>
-</h2>
+
+<h2><a name="Whitelist%20Guide_amazon_fire_os_whitelisting">Amazon Fire OS Whitelisting</a></h2>
<p>Platform-specific whitelisting rules are found in
<code>res/xml/config.xml</code>.</p>
-<h2>
-<a name="Whitelist%20Guide_android_whitelisting">Android Whitelisting</a>
-</h2>
+<h2><a name="Whitelist%20Guide_android_whitelisting">Android Whitelisting</a></h2>
<p>Platform-specific whitelisting rules are found in
<code>res/xml/config.xml</code>.</p>
@@ -236,9 +237,7 @@ application.</p>
page to open in the default browser rather than within the
application. (Compare this to iOS's behavior noted below.)</p>
-<h2>
-<a name="Whitelist%20Guide_ios_whitelisting">iOS Whitelisting</a>
-</h2>
+<h2><a name="Whitelist%20Guide_ios_whitelisting">iOS Whitelisting</a></h2>
<p>The platform's whitelisting rules are found in the named application
directory's <code>config.xml</code> file.</p>
@@ -258,9 +257,7 @@ all subdomains and top-level domains suc
domains via <code>href</code> hyperlink on iOS prevents the page from opening at
all.</p>
-<h2>
-<a name="Whitelist%20Guide_blackberry_10_whitelisting">BlackBerry 10 Whitelisting</a>
-</h2>
+<h2><a name="Whitelist%20Guide_blackberry_10_whitelisting">BlackBerry 10 Whitelisting</a></h2>
<p>The whitelisting rules are found in <code>www/config.xml</code>.</p>
@@ -297,12 +294,11 @@ protocol:</p>
<p><access origin="*" subdomains="true"></access></p>
</li>
</ul>
+
<p>(For more information on support, see BlackBerry's documentation on the
<a class="external" href="https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html">access element</a>.)</p>
-<h2>
-<a name="Whitelist%20Guide_ios_changes_in_3_1_0">iOS Changes in 3.1.0</a>
-</h2>
+<h2><a name="Whitelist%20Guide_ios_changes_in_3_1_0">iOS Changes in 3.1.0</a></h2>
<p>Prior to version 3.1.0, Cordova-iOS included some non-standard
extensions to the domain whilelisting scheme supported by other
@@ -327,16 +323,13 @@ for each TLD which you actually control,
are no longer supported; change to include a line for each domain
and protocol that you actually need to whitelist.</p></li>
</ul>
-<h2>
-<a name="Whitelist%20Guide_windows_phone_whitelisting">Windows Phone Whitelisting</a>
-</h2>
-<p>The whitelisting rules for Windows Phone 7 and 8 are found in the
+<h2><a name="Whitelist%20Guide_windows_phone_whitelisting">Windows Phone Whitelisting</a></h2>
+
+<p>The whitelisting rules for Windows Phone 8 are found in the
app's <code>config.xml</code> file.</p>
-<h2>
-<a name="Whitelist%20Guide_tizen_whitelisting">Tizen Whitelisting</a>
-</h2>
+<h2><a name="Whitelist%20Guide_tizen_whitelisting">Tizen Whitelisting</a></h2>
<p>Whitelisting rules are found in the app's <code>config.xml</code> file. The
platform relies on the same <code>subdomains</code> attribute as the BlackBerry
@@ -348,6 +341,7 @@ platform.
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>