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 2013/08/19 23:47:49 UTC
[1/4] docs commit: Added config.xml docs for preferences
Updated Branches:
refs/heads/master 76ef2fb73 -> 95747c10a
Added config.xml docs for preferences
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/4c355e14
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/4c355e14
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/4c355e14
Branch: refs/heads/master
Commit: 4c355e149c3fa84c5a679ab76380f8ff4a531769
Parents: 76ef2fb
Author: Kristoffer Flores <kf...@blackberry.com>
Authored: Mon Aug 19 17:19:46 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Mon Aug 19 14:38:16 2013 -0700
----------------------------------------------------------------------
.../guide/platforms/blackberry10/config.md | 62 ++++++++++++++++++++
1 file changed, 62 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4c355e14/docs/en/3.0.0/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/3.0.0/guide/platforms/blackberry10/config.md b/docs/en/3.0.0/guide/platforms/blackberry10/config.md
new file mode 100644
index 0000000..add0e0f
--- /dev/null
+++ b/docs/en/3.0.0/guide/platforms/blackberry10/config.md
@@ -0,0 +1,62 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Blackberry10 Configuration
+
+The `config.xml` file controls various Cordova settings. These apply across the application.
+The `config.xml` file is is located in `<project folder>/<www>` directory.
+
+## `<preference>`
+
+Various preferences (as `<preference>` tags) default on not breaking existing apps.
+The available preferences are:
+
+* `autoHideSplashScreen`: (`true` or `false`): Set to `false` to control when the splashscreen
+ is hidden through a JavaScript API. This preference defaults to true.
+
+* `backgroundColor`: Specifies the background color of your app. The value must specify
+ a color value in the ARGB pixel format using 8 hexadecimal digits.
+
+* `childBrowser`: Disables child browser windows. By default, when the content attempts
+ to open a resource in a new window or tab (by using window.open(), or by specifying _blank
+ as the target of an anchor), the WebWorks app will open a secondary browser window
+ to display the resource. This feature is enabled by default. The value must specify
+ `disable` to prevent the above actions from occuring.
+
+* `hideKeyboardFormAccessoryBar`: (`enable` or `disable`) Disables the keyboard form
+ accessory bar in an HTML form. The keyboard form accessory bar is a row of
+ buttons (Previous, Next, and Submit) that the user can use to navigate through a form.
+ By default, when a WebWorks app contains an HTML form and an <input> element gets
+ focus, WebWorks displays this form accessory bar. This feature allows you to prevent your
+ app from displaying the form accessory bar by specifying value as `enable`.
+
+* `orientation`: (`auto`, `portrait`, or `landscape`) Specifies the persistent orientation
+ for screens in your app. By default, if you do not specify a screen orientation,
+ the orientation is set to auto.
+
+* `popBlocker`: Enables the popup blocker. By default, all popups are displayed by
+ BlackBerry WebWorks apps in a child browser window. You can prevent popups from displaying
+ without user intervention by enabling the popup blocker. This is done by specifying
+ value as `enable`.
+
+* `webSecurity`: Disables web security. Disabling web security allows you to access
+ remote content from unknown sources during development. Before packaging your app for
+ distribution, you should remove this setting. This feature is intended as a
+ development convenience only. In production, all URIs should be known and should be
+ whitelisted using the <access> element. To disable, specify value as `disable`.
[3/4] docs commit: Link BlackBerry 10 Configuration in edge and 3.0.0.
Posted by mw...@apache.org.
Link BlackBerry 10 Configuration in edge and 3.0.0.
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/6ee184de
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/6ee184de
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/6ee184de
Branch: refs/heads/master
Commit: 6ee184de373697aed445d9f747d8a11eeba9aae3
Parents: 48ffb2c
Author: Michael Brooks <mi...@michaelbrooks.ca>
Authored: Mon Aug 19 14:42:48 2013 -0700
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Mon Aug 19 14:42:48 2013 -0700
----------------------------------------------------------------------
docs/en/3.0.0/guide/platforms/blackberry10/config.md | 2 +-
docs/en/3.0.0/guide/platforms/index.md | 1 +
docs/en/edge/guide/platforms/blackberry10/config.md | 2 +-
docs/en/edge/guide/platforms/index.md | 1 +
4 files changed, 4 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6ee184de/docs/en/3.0.0/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/3.0.0/guide/platforms/blackberry10/config.md b/docs/en/3.0.0/guide/platforms/blackberry10/config.md
index add0e0f..56ee12e 100644
--- a/docs/en/3.0.0/guide/platforms/blackberry10/config.md
+++ b/docs/en/3.0.0/guide/platforms/blackberry10/config.md
@@ -17,7 +17,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
under the License.
---
-# Blackberry10 Configuration
+# BlackBerry 10 Configuration
The `config.xml` file controls various Cordova settings. These apply across the application.
The `config.xml` file is is located in `<project folder>/<www>` directory.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6ee184de/docs/en/3.0.0/guide/platforms/index.md
----------------------------------------------------------------------
diff --git a/docs/en/3.0.0/guide/platforms/index.md b/docs/en/3.0.0/guide/platforms/index.md
index 45ea7e1..401a45d 100644
--- a/docs/en/3.0.0/guide/platforms/index.md
+++ b/docs/en/3.0.0/guide/platforms/index.md
@@ -56,6 +56,7 @@ a lower-level alternative to the `cordova` command-line utility.
## BlackBerry 10
* BlackBerry 10 Platform Guide
+* BlackBerry 10 Configuration
* BlackBerry 10 Plugins
* BlackBerry 10 Command-line Tools
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6ee184de/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index add0e0f..56ee12e 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -17,7 +17,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
under the License.
---
-# Blackberry10 Configuration
+# BlackBerry 10 Configuration
The `config.xml` file controls various Cordova settings. These apply across the application.
The `config.xml` file is is located in `<project folder>/<www>` directory.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/6ee184de/docs/en/edge/guide/platforms/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/index.md b/docs/en/edge/guide/platforms/index.md
index 45ea7e1..401a45d 100644
--- a/docs/en/edge/guide/platforms/index.md
+++ b/docs/en/edge/guide/platforms/index.md
@@ -56,6 +56,7 @@ a lower-level alternative to the `cordova` command-line utility.
## BlackBerry 10
* BlackBerry 10 Platform Guide
+* BlackBerry 10 Configuration
* BlackBerry 10 Plugins
* BlackBerry 10 Command-line Tools
[4/4] docs commit: Update BlackBerry10 Configuration code tags.
Posted by mw...@apache.org.
Update BlackBerry10 Configuration code tags.
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/95747c10
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/95747c10
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/95747c10
Branch: refs/heads/master
Commit: 95747c10a5ec2ba1534e1fbe0a330057f86d7a25
Parents: 6ee184d
Author: Michael Brooks <mi...@michaelbrooks.ca>
Authored: Mon Aug 19 14:47:34 2013 -0700
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Mon Aug 19 14:47:34 2013 -0700
----------------------------------------------------------------------
docs/en/3.0.0/guide/platforms/blackberry10/config.md | 6 +++---
docs/en/edge/guide/platforms/blackberry10/config.md | 6 +++---
2 files changed, 6 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/95747c10/docs/en/3.0.0/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/3.0.0/guide/platforms/blackberry10/config.md b/docs/en/3.0.0/guide/platforms/blackberry10/config.md
index 56ee12e..f2f5177 100644
--- a/docs/en/3.0.0/guide/platforms/blackberry10/config.md
+++ b/docs/en/3.0.0/guide/platforms/blackberry10/config.md
@@ -34,7 +34,7 @@ The available preferences are:
a color value in the ARGB pixel format using 8 hexadecimal digits.
* `childBrowser`: Disables child browser windows. By default, when the content attempts
- to open a resource in a new window or tab (by using window.open(), or by specifying _blank
+ to open a resource in a new window or tab (by using window.open(), or by specifying `_blank`
as the target of an anchor), the WebWorks app will open a secondary browser window
to display the resource. This feature is enabled by default. The value must specify
`disable` to prevent the above actions from occuring.
@@ -42,7 +42,7 @@ The available preferences are:
* `hideKeyboardFormAccessoryBar`: (`enable` or `disable`) Disables the keyboard form
accessory bar in an HTML form. The keyboard form accessory bar is a row of
buttons (Previous, Next, and Submit) that the user can use to navigate through a form.
- By default, when a WebWorks app contains an HTML form and an <input> element gets
+ By default, when a WebWorks app contains an HTML form and an `<input>` element gets
focus, WebWorks displays this form accessory bar. This feature allows you to prevent your
app from displaying the form accessory bar by specifying value as `enable`.
@@ -59,4 +59,4 @@ The available preferences are:
remote content from unknown sources during development. Before packaging your app for
distribution, you should remove this setting. This feature is intended as a
development convenience only. In production, all URIs should be known and should be
- whitelisted using the <access> element. To disable, specify value as `disable`.
+ whitelisted using the `<access>` element. To disable, specify value as `disable`.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/95747c10/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
index 56ee12e..f2f5177 100644
--- a/docs/en/edge/guide/platforms/blackberry10/config.md
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -34,7 +34,7 @@ The available preferences are:
a color value in the ARGB pixel format using 8 hexadecimal digits.
* `childBrowser`: Disables child browser windows. By default, when the content attempts
- to open a resource in a new window or tab (by using window.open(), or by specifying _blank
+ to open a resource in a new window or tab (by using window.open(), or by specifying `_blank`
as the target of an anchor), the WebWorks app will open a secondary browser window
to display the resource. This feature is enabled by default. The value must specify
`disable` to prevent the above actions from occuring.
@@ -42,7 +42,7 @@ The available preferences are:
* `hideKeyboardFormAccessoryBar`: (`enable` or `disable`) Disables the keyboard form
accessory bar in an HTML form. The keyboard form accessory bar is a row of
buttons (Previous, Next, and Submit) that the user can use to navigate through a form.
- By default, when a WebWorks app contains an HTML form and an <input> element gets
+ By default, when a WebWorks app contains an HTML form and an `<input>` element gets
focus, WebWorks displays this form accessory bar. This feature allows you to prevent your
app from displaying the form accessory bar by specifying value as `enable`.
@@ -59,4 +59,4 @@ The available preferences are:
remote content from unknown sources during development. Before packaging your app for
distribution, you should remove this setting. This feature is intended as a
development convenience only. In production, all URIs should be known and should be
- whitelisted using the <access> element. To disable, specify value as `disable`.
+ whitelisted using the `<access>` element. To disable, specify value as `disable`.
[2/4] docs commit: Mirror BlackBerry 10 Configuration to edge.
Posted by mw...@apache.org.
Mirror BlackBerry 10 Configuration to edge.
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/48ffb2c8
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/48ffb2c8
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/48ffb2c8
Branch: refs/heads/master
Commit: 48ffb2c8bbb1de0040aa08ba286a3ea492c4c075
Parents: 4c355e1
Author: Michael Brooks <mi...@michaelbrooks.ca>
Authored: Mon Aug 19 14:41:00 2013 -0700
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Mon Aug 19 14:41:00 2013 -0700
----------------------------------------------------------------------
.../edge/guide/platforms/blackberry10/config.md | 62 ++++++++++++++++++++
1 file changed, 62 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/48ffb2c8/docs/en/edge/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/blackberry10/config.md b/docs/en/edge/guide/platforms/blackberry10/config.md
new file mode 100644
index 0000000..add0e0f
--- /dev/null
+++ b/docs/en/edge/guide/platforms/blackberry10/config.md
@@ -0,0 +1,62 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Blackberry10 Configuration
+
+The `config.xml` file controls various Cordova settings. These apply across the application.
+The `config.xml` file is is located in `<project folder>/<www>` directory.
+
+## `<preference>`
+
+Various preferences (as `<preference>` tags) default on not breaking existing apps.
+The available preferences are:
+
+* `autoHideSplashScreen`: (`true` or `false`): Set to `false` to control when the splashscreen
+ is hidden through a JavaScript API. This preference defaults to true.
+
+* `backgroundColor`: Specifies the background color of your app. The value must specify
+ a color value in the ARGB pixel format using 8 hexadecimal digits.
+
+* `childBrowser`: Disables child browser windows. By default, when the content attempts
+ to open a resource in a new window or tab (by using window.open(), or by specifying _blank
+ as the target of an anchor), the WebWorks app will open a secondary browser window
+ to display the resource. This feature is enabled by default. The value must specify
+ `disable` to prevent the above actions from occuring.
+
+* `hideKeyboardFormAccessoryBar`: (`enable` or `disable`) Disables the keyboard form
+ accessory bar in an HTML form. The keyboard form accessory bar is a row of
+ buttons (Previous, Next, and Submit) that the user can use to navigate through a form.
+ By default, when a WebWorks app contains an HTML form and an <input> element gets
+ focus, WebWorks displays this form accessory bar. This feature allows you to prevent your
+ app from displaying the form accessory bar by specifying value as `enable`.
+
+* `orientation`: (`auto`, `portrait`, or `landscape`) Specifies the persistent orientation
+ for screens in your app. By default, if you do not specify a screen orientation,
+ the orientation is set to auto.
+
+* `popBlocker`: Enables the popup blocker. By default, all popups are displayed by
+ BlackBerry WebWorks apps in a child browser window. You can prevent popups from displaying
+ without user intervention by enabling the popup blocker. This is done by specifying
+ value as `enable`.
+
+* `webSecurity`: Disables web security. Disabling web security allows you to access
+ remote content from unknown sources during development. Before packaging your app for
+ distribution, you should remove this setting. This feature is intended as a
+ development convenience only. In production, all URIs should be known and should be
+ whitelisted using the <access> element. To disable, specify value as `disable`.