You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by au...@apache.org on 2017/11/07 23:02:24 UTC
svn commit: r1814540 [2/4] - in /cordova/site/public: ./ blog/
docs/en/dev/reference/cordova-plugin-camera/
docs/en/dev/reference/cordova-plugin-contacts/
docs/en/dev/reference/cordova-plugin-device-motion/
docs/en/dev/reference/cordova-plugin-device-o...
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-device-orientation/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-device-orientation/index.html?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-device-orientation/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-device-orientation/index.html Tue Nov 7 23:02:24 2017
@@ -2750,220 +2750,16 @@
<h1>cordova-plugin-device-orientation</h1>
-<h1>Deprecation Notice</h1>
-
-<p>With the <a href="https://www.w3.org/TR/2016/CR-orientation-event-20160818/">W3C Device Orientation API</a> now being
-supported on iOS, Android and Windows devices, this plugin is not needed any more. Migrating from this plugin to
-the <a href="https://www.w3.org/TR/2016/CR-orientation-event-20160818/">W3C Device Orientation API</a> is explained in this
-<a href="https://blog.phonegap.com/migrating-from-the-cordova-device-orientation-plugin-8442b869e6cc">PhoneGap blog post</a>.</p>
-
<hr>
<h2>Description</h2>
-<p>This plugin provides access to the device's compass. The compass is a sensor
-that detects the direction or heading that the device is pointed, typically
-from the top of the device. It measures the heading in degrees from 0 to
-359.99, where 0 is north.</p>
-
-<p>Access is via a global <code>navigator.compass</code> object.</p>
-
-<p>Although the object is attached to the global scoped <code>navigator</code>, it is not available until after the <code>deviceready</code> event.</p>
-<div class="highlight"><pre><code class="language-" data-lang="">document.addEventListener("deviceready", onDeviceReady, false);
-function onDeviceReady() {
- console.log(navigator.compass);
-}
-</code></pre></div>
-<p>Report issues on the <a href="https://issues.apache.org/jira/secure/RapidBoard.jspa?rapidView=190&projectKey=CB">Apache Cordova issue tracker</a></p>
-
-<h2>Installation</h2>
-<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin add cordova-plugin-device-orientation
-</code></pre></div>
-<h2>Supported Platforms</h2>
-
-<ul>
-<li>Amazon Fire OS</li>
-<li>Android</li>
-<li>BlackBerry 10</li>
-<li>Browser</li>
-<li>Firefox OS</li>
-<li>iOS</li>
-<li>Tizen</li>
-<li>Windows Phone 7 and 8 (if available in hardware)</li>
-<li>Windows 8</li>
-</ul>
-
-<h2>Methods</h2>
-
-<ul>
-<li>navigator.compass.getCurrentHeading</li>
-<li>navigator.compass.watchHeading</li>
-<li>navigator.compass.clearWatch</li>
-</ul>
-
-<h2>navigator.compass.getCurrentHeading</h2>
-
-<p>Get the current compass heading. The compass heading is returned via a <code>CompassHeading</code>
-object using the <code>compassSuccess</code> callback function.</p>
-<div class="highlight"><pre><code class="language-" data-lang="">navigator.compass.getCurrentHeading(compassSuccess, compassError);
-</code></pre></div>
-<h3>Example</h3>
-<div class="highlight"><pre><code class="language-" data-lang="">function onSuccess(heading) {
- alert('Heading: ' + heading.magneticHeading);
-};
-
-function onError(error) {
- alert('CompassError: ' + error.code);
-};
-
-navigator.compass.getCurrentHeading(onSuccess, onError);
-</code></pre></div>
-<h2>navigator.compass.watchHeading</h2>
-
-<p>Gets the device's current heading at a regular interval. Each time the heading
-is retrieved, the <code>headingSuccess</code> callback function is executed.</p>
-
-<p>The returned watch ID references the compass watch interval. The watch
-ID can be used with <code>navigator.compass.clearWatch</code> to stop watching the navigator.compass.</p>
-<div class="highlight"><pre><code class="language-" data-lang="">var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]);
-</code></pre></div>
-<p><code>compassOptions</code> may contain the following keys:</p>
-
-<ul>
-<li><strong>frequency</strong>: How often to retrieve the compass heading in milliseconds. <em>(Number)</em> (Default: 100)</li>
-<li><strong>filter</strong>: The change in degrees required to initiate a watchHeading success callback. When this value is set, <strong>frequency</strong> is ignored. <em>(Number)</em></li>
-</ul>
-
-<h3>Example</h3>
-<div class="highlight"><pre><code class="language-" data-lang="">function onSuccess(heading) {
- var element = document.getElementById('heading');
- element.innerHTML = 'Heading: ' + heading.magneticHeading;
-};
-
-function onError(compassError) {
- alert('Compass error: ' + compassError.code);
-};
-
-var options = {
- frequency: 3000
-}; // Update every 3 seconds
-
-var watchID = navigator.compass.watchHeading(onSuccess, onError, options);
-</code></pre></div>
-<h3>Browser Quirks</h3>
-
-<p>Values for current heading are randomly generated in order to simulate the compass.</p>
-
-<h3>iOS Quirks</h3>
-
-<p>Only one <code>watchHeading</code> can be in effect at one time in iOS. If a
-<code>watchHeading</code> uses a filter, calling <code>getCurrentHeading</code> or
-<code>watchHeading</code> uses the existing filter value to specify heading
-changes. Watching heading changes with a filter is more efficient than
-with time intervals.</p>
-
-<h3>Amazon Fire OS Quirks</h3>
-
-<ul>
-<li><code>filter</code> is not supported.</li>
-</ul>
-
-<h3>Android Quirks</h3>
-
-<ul>
-<li>No support for <code>filter</code>.</li>
-</ul>
-
-<h3>Firefox OS Quirks</h3>
+<h3>Deprecation Notice</h3>
-<ul>
-<li>No support for <code>filter</code>.</li>
-</ul>
-
-<h3>Tizen Quirks</h3>
-
-<ul>
-<li>No support for <code>filter</code>.</li>
-</ul>
-
-<h3>Windows Phone 7 and 8 Quirks</h3>
-
-<ul>
-<li>No support for <code>filter</code>.</li>
-</ul>
-
-<h2>navigator.compass.clearWatch</h2>
-
-<p>Stop watching the compass referenced by the watch ID parameter.</p>
-<div class="highlight"><pre><code class="language-" data-lang="">navigator.compass.clearWatch(watchID);
-</code></pre></div>
-<ul>
-<li><strong>watchID</strong>: The ID returned by <code>navigator.compass.watchHeading</code>.</li>
-</ul>
-
-<h3>Example</h3>
-<div class="highlight"><pre><code class="language-" data-lang="">var watchID = navigator.compass.watchHeading(onSuccess, onError, options);
-
-// ... later on ...
-
-navigator.compass.clearWatch(watchID);
-</code></pre></div>
-<h2>CompassHeading</h2>
-
-<p>A <code>CompassHeading</code> object is returned to the <code>compassSuccess</code> callback function.</p>
-
-<h3>Properties</h3>
-
-<ul>
-<li><p><strong>magneticHeading</strong>: The heading in degrees from 0-359.99 at a single moment in time. <em>(Number)</em></p></li>
-<li><p><strong>trueHeading</strong>: The heading relative to the geographic North Pole in degrees 0-359.99 at a single moment in time. A negative value indicates that the true heading can't be determined. <em>(Number)</em></p></li>
-<li><p><strong>headingAccuracy</strong>: The deviation in degrees between the reported heading and the true heading. <em>(Number)</em></p></li>
-<li><p><strong>timestamp</strong>: The time at which this heading was determined. <em>(DOMTimeStamp)</em></p></li>
-</ul>
-
-<h3>Amazon Fire OS Quirks</h3>
-
-<ul>
-<li><p><code>trueHeading</code> is not supported, but reports the same value as <code>magneticHeading</code></p></li>
-<li><p><code>headingAccuracy</code> is always 0 because there is no difference between the <code>magneticHeading</code> and <code>trueHeading</code></p></li>
-</ul>
-
-<h3>Android Quirks</h3>
-
-<ul>
-<li><p>The <code>trueHeading</code> property is not supported, but reports the same value as <code>magneticHeading</code>.</p></li>
-<li><p>The <code>headingAccuracy</code> property is always 0 because there is no difference between the <code>magneticHeading</code> and <code>trueHeading</code>.</p></li>
-</ul>
-
-<h3>Firefox OS Quirks</h3>
-
-<ul>
-<li><p>The <code>trueHeading</code> property is not supported, but reports the same value as <code>magneticHeading</code>.</p></li>
-<li><p>The <code>headingAccuracy</code> property is always 0 because there is no difference between the <code>magneticHeading</code> and <code>trueHeading</code>.</p></li>
-</ul>
-
-<h3>iOS Quirks</h3>
-
-<ul>
-<li>The <code>trueHeading</code> property is only returned for location services enabled via <code>navigator.geolocation.watchLocation()</code>.</li>
-</ul>
-
-<h2>CompassError</h2>
-
-<p>A <code>CompassError</code> object is returned to the <code>compassError</code> callback function when an error occurs.</p>
-
-<h3>Properties</h3>
-
-<ul>
-<li><strong>code</strong>: One of the predefined error codes listed below.</li>
-</ul>
-
-<h3>Constants</h3>
-
-<ul>
-<li><code>CompassError.COMPASS_INTERNAL_ERR</code></li>
-<li><code>CompassError.COMPASS_NOT_SUPPORTED</code></li>
-</ul>
+<p>With the <a href="https://www.w3.org/TR/2016/CR-orientation-event-20160818/">W3C Device Orientation API</a> now being
+supported on iOS, Android and Windows devices, this plugin is not needed any more. Migrating from this plugin to
+the <a href="https://www.w3.org/TR/2016/CR-orientation-event-20160818/">W3C Device Orientation API</a> is explained in this
+<a href="https://blog.phonegap.com/migrating-from-the-cordova-device-orientation-plugin-8442b869e6cc">PhoneGap blog post</a>.</p>
</div>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-file-transfer/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-file-transfer/index.html?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-file-transfer/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-file-transfer/index.html Tue Nov 7 23:02:24 2017
@@ -2764,6 +2764,10 @@
<p>Report issues with this plugin on the <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20File%20Transfer%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC">Apache Cordova issue tracker</a></p>
+<h2>Deprecated</h2>
+
+<p>With the new features introduced in <a href="https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest">XMLHttpRequest</a>, this plugin is not needed any more. Migrating from this plugin to using the new features of <a href="https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest">XMLHttpRequest</a>, is explained in this <a href="https://cordova.apache.org/blog/2017/10/18/from-filetransfer-to-xhr2.html">Cordova blog post</a>.</p>
+
<h2>Installation</h2>
<div class="highlight"><pre><code class="language-bash" data-lang="bash">cordova plugin add cordova-plugin-file-transfer
</code></pre></div>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-file/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-file/index.html?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-file/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-file/index.html Tue Nov 7 23:02:24 2017
@@ -3686,7 +3686,7 @@ filesystems to be installed. By default,
<p>Before you use the File plugin APIs, you can get access to the file system using <code>requestFileSystem</code>. When you do this, you can request either persistent or temporary storage. Persistent storage will not be removed unless permission is granted by the user.</p>
-<p>When you get file system access using <code>requestFileSystem</code>, access is granted for the sandboxed file system only (the sandbox limits access to the app itself), not for general access to any file system location on the device. (To access file system locations outside the sandboxed storage, use other methods such as window.requestLocalFileSystemURL, which support platform-specific locations. For one example of this, see <em>Append a File</em>.)</p>
+<p>When you get file system access using <code>requestFileSystem</code>, access is granted for the sandboxed file system only (the sandbox limits access to the app itself), not for general access to any file system location on the device. (To access file system locations outside the sandboxed storage, use other methods such as window.resolveLocalFileSystemURL, which support platform-specific locations. For one example of this, see <em>Append a File</em>.)</p>
<p>Here is a request for persistent storage.</p>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-geolocation/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-geolocation/index.html?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-geolocation/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-geolocation/index.html Tue Nov 7 23:02:24 2017
@@ -2883,15 +2883,19 @@ error, the <code>geolocationError</code>
</code></pre></div>
<h3>iOS Quirks</h3>
-<p>Since iOS 10 it's mandatory to add a <code>NSLocationWhenInUseUsageDescription</code> entry in the info.plist.</p>
+<p>Since iOS 10 it's mandatory to provide an usage description in the <code>info.plist</code> if trying to access privacy-sensitive data. When the system prompts the user to allow access, this usage description string will displayed as part of the permission dialog box, but if you didn't provide the usage description, the app will crash before showing the dialog. Also, Apple will reject apps that access private data but don't provide an usage description.</p>
-<p><code>NSLocationWhenInUseUsageDescription</code> describes the reason that the app accesses the user's location. When the system prompts the user to allow access, this string is displayed as part of the dialog box. To add this entry you can pass the variable <code>GEOLOCATION_USAGE_DESCRIPTION</code> on plugin install.</p>
-
-<p>Example:
- <code>cordova plugin add cordova-plugin-geolocation --variable GEOLOCATION_USAGE_DESCRIPTION="your usage message"</code></p>
-
-<p>If you don't pass the variable, the plugin will add an empty string as value.</p>
+<p>This plugins requires the following usage description:</p>
+<ul>
+<li><code>NSLocationWhenInUseUsageDescription</code> describes the reason that the app accesses the user's location. </li>
+</ul>
+
+<p>To add this entry into the <code>info.plist</code>, you can use the <code>edit-config</code> tag in the <code>config.xml</code> like this:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><edit-config target="NSLocationWhenInUseUsageDescription" file="*-Info.plist" mode="merge">
+ <string>need location access to find things nearby</string>
+</edit-config>
+</code></pre></div>
<h3>Android Quirks</h3>
<p>If Geolocation service is turned off the <code>onError</code> callback is invoked after <code>timeout</code> interval (if specified).
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html Tue Nov 7 23:02:24 2017
@@ -2936,31 +2936,27 @@ object featuring a <code>CaptureError.CA
<h3>iOS Quirks</h3>
-<p>Since iOS 10 it's mandatory to add a <code>NSCameraUsageDescription</code>, <code>NSMicrophoneUsageDescription</code> and <code>NSPhotoLibraryUsageDescriptionentry</code> in the info.plist.</p>
+<p>Since iOS 10 it's mandatory to provide an usage description in the <code>info.plist</code> if trying to access privacy-sensitive data. When the system prompts the user to allow access, this usage description string will displayed as part of the permission dialog box, but if you didn't provide the usage description, the app will crash before showing the dialog. Also, Apple will reject apps that access private data but don't provide an usage description.</p>
-<ul>
-<li><code>NSCameraUsageDescription</code> describes the reason that the app accesses the userâs camera.</li>
-<li><code>NSMicrophoneUsageDescription</code> describes the reason that the app accesses the userâs microphone.</li>
-<li><code>NSPhotoLibraryUsageDescriptionentry</code> describes the reason the app accesses the user's photo library.</li>
-</ul>
-
-<p>When the system prompts the user to allow access, this string is displayed as part of the dialog box.</p>
-
-<p>To add this entry you can pass the following variables on plugin install.</p>
+<p>This plugins requires the following usage descriptions:</p>
<ul>
-<li><code>CAMERA_USAGE_DESCRIPTION</code> for <code>NSCameraUsageDescription</code></li>
-<li><code>MICROPHONE_USAGE_DESCRIPTION</code> for <code>NSMicrophoneUsageDescription</code></li>
-<li><code>PHOTOLIBRARY_USAGE_DESCRIPTION</code> for <code>NSPhotoLibraryUsageDescriptionentry</code></li>
+<li><code>NSCameraUsageDescription</code> describes the reason the app accesses the user's camera.</li>
+<li><code>NSMicrophoneUsageDescription</code> describes the reason the app accesses the user's microphone.</li>
+<li><code>NSPhotoLibraryUsageDescriptionentry</code> describes the reason the app accesses the user's photo library.</li>
</ul>
-<p>-
-Example:</p>
-
-<p><code>cordova plugin add cordova-plugin-media-capture --variable CAMERA_USAGE_DESCRIPTION="your usage message"</code></p>
-
-<p>If you don't pass the variable, the plugin will add an empty string as value.</p>
-
+<p>To add these entries into the <code>info.plist</code>, you can use the <code>edit-config</code> tag in the <code>config.xml</code> like this:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><edit-config target="NSCameraUsageDescription" file="*-Info.plist" mode="merge">
+ <string>need camera access to take pictures</string>
+</edit-config>
+</code></pre></div><div class="highlight"><pre><code class="language-" data-lang=""><edit-config target="NSMicrophoneUsageDescription" file="*-Info.plist" mode="merge">
+ <string>need microphone access to record sounds</string>
+</edit-config>
+</code></pre></div><div class="highlight"><pre><code class="language-" data-lang=""><edit-config target="NSPhotoLibraryUsageDescription" file="*-Info.plist" mode="merge">
+ <string>need to photo library access to get pictures from there</string>
+</edit-config>
+</code></pre></div>
<h3>Windows Phone 7 Quirks</h3>
<p>Invoking the native camera application while your device is connected
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-media/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-media/index.html?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-media/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-media/index.html Tue Nov 7 23:02:24 2017
@@ -2820,7 +2820,7 @@ and may deprecate the current APIs.</p>
<h3>Methods</h3>
<ul>
-<li><p><code>media.getCurrentAmplitude</code>: Returns the current position within an audio file.</p></li>
+<li><p><code>media.getCurrentAmplitude</code>: Returns the current amplitude within an audio file.</p></li>
<li><p><code>media.getCurrentPosition</code>: Returns the current position within an audio file.</p></li>
<li><p><code>media.getDuration</code>: Returns the duration of an audio file.</p></li>
<li><p><code>media.play</code>: Start or resume playing an audio file.</p></li>
@@ -2848,7 +2848,7 @@ and may deprecate the current APIs.</p>
<h2>media.getCurrentAmplitude</h2>
-<p>Returns the current amplitude of the current recording.</p>
+<p>Returns the current amplitude within an audio file.</p>
<div class="highlight"><pre><code class="language-" data-lang="">media.getCurrentAmplitude(mediaSuccess, [mediaError]);
</code></pre></div>
<h3>Supported Platforms</h3>
@@ -3243,15 +3243,20 @@ function for any <code>Media</code> reso
<li><p>Files can be recorded and played back using the documents URI:</p>
<div class="highlight"><pre><code class="language-" data-lang="">var myMedia = new Media("documents://beer.mp3")
</code></pre></div></li>
-<li><p>Since iOS 10 it's mandatory to add a <code>NSMicrophoneUsageDescription</code> entry in the info.plist.</p></li>
+<li><p>Since iOS 10 it's mandatory to provide an usage description in the <code>info.plist</code> if trying to access privacy-sensitive data. When the system prompts the user to allow access, this usage description string will displayed as part of the permission dialog box, but if you didn't provide the usage description, the app will crash before showing the dialog. Also, Apple will reject apps that access private data but don't provide an usage description.</p></li>
</ul>
-<p><code>NSMicrophoneUsageDescription</code> describes the reason that the app accesses the userâs microphone. When the system prompts the user to allow access, this string is displayed as part of the dialog box. To add this entry you can pass the variable <code>MICROPHONE_USAGE_DESCRIPTION</code> on plugin install.</p>
+<p>This plugins requires the following usage description:</p>
-<p>Example: <code>cordova plugin add cordova-plugin-media --variable MICROPHONE_USAGE_DESCRIPTION="your usage message"</code></p>
-
-<p>If you don't pass the variable, the plugin will add an empty string as value.</p>
+<ul>
+<li><code>NSMicrophoneUsageDescription</code> describes the reason that the app accesses the user's microphone. </li>
+</ul>
+<p>To add this entry into the <code>info.plist</code>, you can use the <code>edit-config</code> tag in the <code>config.xml</code> like this:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><edit-config target="NSMicrophoneUsageDescription" file="*-Info.plist" mode="merge">
+ <string>need microphone access to record sounds</string>
+</edit-config>
+</code></pre></div>
<h3>Windows Quirks</h3>
<ul>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html Tue Nov 7 23:02:24 2017
@@ -3419,6 +3419,7 @@ to hide the splash-screen spinner.</li>
<p>In your <code>config.xml</code>, you can add the following preferences:</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashMaintainAspectRatio"</span> <span class="na">value=</span><span class="s">"true|false"</span> <span class="nt">/></span>
<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashShowOnlyFirstTime"</span> <span class="na">value=</span><span class="s">"true|false"</span> <span class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"white"</span> <span class="nt">/></span>
</code></pre></div>
<p>"SplashMaintainAspectRatio" preference is optional. If set to true, splash screen drawable is not stretched to fit screen, but instead simply "covers" the screen, like CSS "background-size:cover". This is very useful when splash screen images cannot be distorted in any way, for example when they contain scenery or text. This setting works best with images that have large margins (safe areas) that can be safely cropped on screens with different aspect ratios.</p>
@@ -3426,6 +3427,8 @@ to hide the splash-screen spinner.</li>
<p>"SplashShowOnlyFirstTime" preference is also optional and defaults to <code>true</code>. When set to <code>true</code> splash screen will only appear on application launch. However, if you plan to use <code>navigator.app.exitApp()</code> to close application and force splash screen appear on next launch, you should set this property to <code>false</code> (this also applies to closing the App with Back button).</p>
+<p>"SplashScreenSpinnerColor" preference is also optional and is ignored when not set. Setting it to a valid color name or HEX color code will change the color of the spinner on Android 5.0+ devices.</p>
+
<h3>Browser Quirks</h3>
<p>You can use the following preferences in your <code>config.xml</code>:</p>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html Tue Nov 7 23:02:24 2017
@@ -2783,6 +2783,9 @@
<li><p><strong>StatusBarStyle</strong> (status bar style, defaults to lightcontent). On iOS 7, set the status bar style. Available options default, lightcontent, blacktranslucent, blackopaque.</p>
<div class="highlight"><pre><code class="language-" data-lang=""><preference name="StatusBarStyle" value="lightcontent" />
</code></pre></div></li>
+<li><p><strong>StatusBarDefaultScrollToTop</strong> (boolean, defaults to false). On iOS 7, allows the Cordova WebView to use default scroll-to-top behavior. Defaults to false so you can listen to the "statusTap" event (described below) and customize the behavior instead.</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><preference name="StatusBarDefaultScrollToTop" value="false" />
+</code></pre></div></li>
</ul>
<h3>Android Quirks</h3>
Modified: cordova/site/public/feed.xml
URL: http://svn.apache.org/viewvc/cordova/site/public/feed.xml?rev=1814540&r1=1814539&r2=1814540&view=diff
==============================================================================
--- cordova/site/public/feed.xml (original)
+++ cordova/site/public/feed.xml Tue Nov 7 23:02:24 2017
@@ -6,8 +6,8 @@
</description>
<link>https://cordova.apache.org/</link>
<atom:link href="https://cordova.apache.org/feed.xml" rel="self" type="application/rss+xml"/>
- <pubDate>Tue, 31 Oct 2017 15:43:12 -0700</pubDate>
- <lastBuildDate>Tue, 31 Oct 2017 15:43:12 -0700</lastBuildDate>
+ <pubDate>Tue, 07 Nov 2017 22:39:19 +0000</pubDate>
+ <lastBuildDate>Tue, 07 Nov 2017 22:39:19 +0000</lastBuildDate>
<generator>Jekyll v2.5.3</generator>
<item>
@@ -45,7 +45,7 @@ cordova platform add ios@4.5.3
<li><a href="https://issues.apache.org/jira/browse/CB-13454">CB-13454</a> (ios) re-add icon-40@2x.png that was accidentally removed</li>
</ul>
</description>
- <pubDate>Tue, 31 Oct 2017 00:00:00 -0700</pubDate>
+ <pubDate>Tue, 31 Oct 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/announcements/2017/10/31/ios-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/announcements/2017/10/31/ios-release.html</guid>
@@ -84,7 +84,7 @@ cordova platform add ios@4.5.3
<li><a href="https://issues.apache.org/jira/browse/CB-13492">CB-13492</a> : Updated <code>opts.save</code> and included tests for no-save.</li>
</ul>
</description>
- <pubDate>Mon, 30 Oct 2017 00:00:00 -0700</pubDate>
+ <pubDate>Mon, 30 Oct 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/news/2017/10/30/fetch-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/news/2017/10/30/fetch-release.html</guid>
@@ -135,7 +135,7 @@ cordova platform update browser@5.0.1
<li><a href="https://issues.apache.org/jira/browse/CB-12895">CB-12895</a> ignoring <code>cordova.js</code> for <code>eslint</code></li>
</ul>
</description>
- <pubDate>Thu, 19 Oct 2017 00:00:00 -0700</pubDate>
+ <pubDate>Thu, 19 Oct 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/news/2017/10/19/browser-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/news/2017/10/19/browser-release.html</guid>
@@ -319,7 +319,7 @@ you&#39;ll need to ensure the File p
<p>Happy standards-compliant coding!</p>
</description>
- <pubDate>Wed, 18 Oct 2017 00:00:00 -0700</pubDate>
+ <pubDate>Wed, 18 Oct 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/blog/2017/10/18/from-filetransfer-to-xhr2.html</link>
<guid isPermaLink="true">https://cordova.apache.org/blog/2017/10/18/from-filetransfer-to-xhr2.html</guid>
@@ -366,7 +366,7 @@ cordova platform add ios@4.5.2
<li><a href="https://issues.apache.org/jira/browse/CB-13315">CB-13315</a> - (ios) fixed bug building for ios using Xcode 9 (#338)</li>
</ul>
</description>
- <pubDate>Mon, 16 Oct 2017 00:00:00 -0700</pubDate>
+ <pubDate>Mon, 16 Oct 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/announcements/2017/10/16/ios-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/announcements/2017/10/16/ios-release.html</guid>
@@ -509,7 +509,7 @@ cordova platform add ios@4.5.2
<li><a href="https://issues.apache.org/jira/browse/CB-12748">CB-12748</a> Update CI to test node 4 and 6</li>
</ul>
</description>
- <pubDate>Tue, 10 Oct 2017 00:00:00 -0700</pubDate>
+ <pubDate>Tue, 10 Oct 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/news/2017/10/10/tools-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/news/2017/10/10/tools-release.html</guid>
@@ -557,7 +557,7 @@ cordova platform update android@6.3.0
<li><a href="https://issues.apache.org/jira/browse/CB-12617">CB-12617</a> : removed node0.x support for platforms and added engineStrict</li>
</ul>
</description>
- <pubDate>Wed, 27 Sep 2017 00:00:00 -0700</pubDate>
+ <pubDate>Wed, 27 Sep 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/announcements/2017/09/27/android-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/announcements/2017/09/27/android-release.html</guid>
@@ -615,7 +615,7 @@ cordova platform add ios@4.5.1
<li><a href="https://issues.apache.org/jira/browse/CB-12888">CB-12888</a> - cordova emulate <strong>iOS</strong> doesn&#39;t work in <strong>iOS</strong> 11</li>
</ul>
</description>
- <pubDate>Mon, 25 Sep 2017 00:00:00 -0700</pubDate>
+ <pubDate>Mon, 25 Sep 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/announcements/2017/09/25/ios-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/announcements/2017/09/25/ios-release.html</guid>
@@ -705,7 +705,7 @@ cordova plugin add cordova-plugin-camera
<li><a href="https://issues.apache.org/jira/browse/CB-12847">CB-12847</a> added <code>bugs</code> entry to <code>package.json</code>.</li>
</ul>
</description>
- <pubDate>Fri, 22 Sep 2017 00:00:00 -0700</pubDate>
+ <pubDate>Fri, 22 Sep 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/news/2017/09/22/plugins-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/news/2017/09/22/plugins-release.html</guid>
@@ -787,7 +787,7 @@ cordova platform add ios@4.5.0
<li>Updated cordova-common to 2.1.0 and other bundled node_modules</li>
</ul>
</description>
- <pubDate>Fri, 08 Sep 2017 00:00:00 -0700</pubDate>
+ <pubDate>Fri, 08 Sep 2017 00:00:00 +0000</pubDate>
<link>https://cordova.apache.org/announcements/2017/09/08/ios-release.html</link>
<guid isPermaLink="true">https://cordova.apache.org/announcements/2017/09/08/ios-release.html</guid>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org