Press Dump Device button to get device information
' + + '' + + 'Expected result: Status box will get updated with device info. (i.e. platform, version, uuid, model, etc)'; + + contentEl.innerHTML = '' + device_tests; + + createActionButton('Dump device', function() { + clearLog(); + logMessage(JSON.stringify(window.device, null, '\t')); + }, "dump_device"); +}; diff --git a/cordova/plugins/org.apache.cordova.device/www/device.js b/cordova/plugins/org.apache.cordova.device/www/device.js new file mode 100644 index 000000000..05f4c4741 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.device/www/device.js @@ -0,0 +1,77 @@ +/* + * + * 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. + * +*/ + +var argscheck = require('cordova/argscheck'), + channel = require('cordova/channel'), + utils = require('cordova/utils'), + exec = require('cordova/exec'), + cordova = require('cordova'); + +channel.createSticky('onCordovaInfoReady'); +// Tell cordova channel to wait on the CordovaInfoReady event +channel.waitForInitialization('onCordovaInfoReady'); + +/** + * This represents the mobile device, and provides properties for inspecting the model, version, UUID of the + * phone, etc. + * @constructor + */ +function Device() { + this.available = false; + this.platform = null; + this.version = null; + this.uuid = null; + this.cordova = null; + this.model = null; + + var me = this; + + channel.onCordovaReady.subscribe(function() { + me.getInfo(function(info) { + //ignoring info.cordova returning from native, we should use value from cordova.version defined in cordova.js + //TODO: CB-5105 native implementations should not return info.cordova + var buildLabel = cordova.version; + me.available = true; + me.platform = info.platform; + me.version = info.version; + me.uuid = info.uuid; + me.cordova = buildLabel; + me.model = info.model; + channel.onCordovaInfoReady.fire(); + },function(e) { + me.available = false; + utils.alert("[ERROR] Error initializing Cordova: " + e); + }); + }); +} + +/** + * Get device info + * + * @param {Function} successCallback The function to call when the heading data is available + * @param {Function} errorCallback The function to call when there is an error getting the heading data. (OPTIONAL) + */ +Device.prototype.getInfo = function(successCallback, errorCallback) { + argscheck.checkArgs('fF', 'Device.getInfo', arguments); + exec(successCallback, errorCallback, "Device", "getDeviceInfo", []); +}; + +module.exports = new Device(); diff --git a/cordova/plugins/org.apache.cordova.dialogs/.fetch.json b/cordova/plugins/org.apache.cordova.dialogs/.fetch.json new file mode 100644 index 000000000..0a08cd6a3 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/.fetch.json @@ -0,0 +1 @@ +{"source":{"type":"registry","id":"org.apache.cordova.dialogs"}} \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/.npmignore b/cordova/plugins/org.apache.cordova.dialogs/.npmignore new file mode 100644 index 000000000..52b558e40 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/.npmignore @@ -0,0 +1,23 @@ +#If ignorance is bliss, then somebody knock the smile off my face + +*.csproj.user +*.suo +*.cache +Thumbs.db +*.DS_Store + +*.bak +*.cache +*.log +*.swp +*.user + + + + + + + + + + \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/CONTRIBUTING.md b/cordova/plugins/org.apache.cordova.dialogs/CONTRIBUTING.md new file mode 100644 index 000000000..f7dbcaba7 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/CONTRIBUTING.md @@ -0,0 +1,37 @@ + + +# Contributing to Apache Cordova + +Anyone can contribute to Cordova. And we need your contributions. + +There are multiple ways to contribute: report bugs, improve the docs, and +contribute code. + +For instructions on this, start with the +[contribution overview](http://cordova.apache.org/#contribute). + +The details are explained there, but the important items are: + - Sign and submit an Apache ICLA (Contributor License Agreement). + - Have a Jira issue open that corresponds to your contribution. + - Run the tests so your patch doesn't break existing functionality. + +We look forward to your contributions! diff --git a/cordova/plugins/org.apache.cordova.dialogs/LICENSE b/cordova/plugins/org.apache.cordova.dialogs/LICENSE new file mode 100644 index 000000000..7a4a3ea24 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed 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. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/NOTICE b/cordova/plugins/org.apache.cordova.dialogs/NOTICE new file mode 100644 index 000000000..8ec56a524 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/NOTICE @@ -0,0 +1,5 @@ +Apache Cordova +Copyright 2012 The Apache Software Foundation + +This product includes software developed at +The Apache Software Foundation (http://www.apache.org/). diff --git a/cordova/plugins/org.apache.cordova.dialogs/README.md b/cordova/plugins/org.apache.cordova.dialogs/README.md new file mode 100644 index 000000000..8fa5da43c --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/README.md @@ -0,0 +1,22 @@ + + +# org.apache.cordova.dialogs + +Plugin documentation: [doc/index.md](doc/index.md) diff --git a/cordova/plugins/org.apache.cordova.dialogs/RELEASENOTES.md b/cordova/plugins/org.apache.cordova.dialogs/RELEASENOTES.md new file mode 100644 index 000000000..673d15c74 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/RELEASENOTES.md @@ -0,0 +1,97 @@ + +# Release Notes + +### 0.2.2 (Sept 25, 2013) +* CB-4889 bumping&resetting version +* [windows8] commandProxy was moved +* CB-4889 renaming reference in Notification.cs +* CB-4889 renaming org.apache.cordova.core.dialogs to org.apache.cordova.dialogs +* Rename CHANGELOG.md -> RELEASENOTES.md +* [CB-4592] [Blackberry10] Added beep support +* [CB-4752] Incremented plugin version on dev branch. + + ### 0.2.3 (Oct 28, 2013) +* CB-5128: added repo + issue tag to plugin.xml for dialogs plugin +* new plugin execute arguments supported +* new plugin style +* smaller fonts styling input +* img files copied inside plugin +* style added +* prompt added +* styling from James +* fixed "exec" calls addedd css, but not working yet +* first (blind) try +* [CB-4915] Incremented plugin version on dev branch. + + +### 0.2.4 (Dec 4, 2013) +* add ubuntu platform +* 1. Added amazon-fireos platform. 2. Change to use amazon-fireos as a platform if user agent string contains 'cordova-amazon-fireos'. +* added beep funtionality using ms-winsoundevent:Notfication.Default + +### 0.2.5 (Jan 02, 2014) +* CB-4696 Fix compile error for Xcode 4.5. +* CB-5658 Add doc/index.md for Dialogs plugin +* CB-3762 Change prompt default to empty string +* Move images from css to img + +### 0.2.6 (Feb 05, 2014) +* no need to recreate the manifest.webapp file after each `cordova prepare` for FFOS +* FFOS description added + +### 0.2.7 (Apr 17, 2014) +* CB-6212: [iOS] fix warnings compiled under arm64 64-bit +* CB-6411: [BlackBerry10] Work around Audio playback issue +* CB-6411: [BlackBerry10] Updates to beep +* CB-6422: [windows8] use cordova/exec/proxy +* CB-6460: Update license headers +* Add NOTICE file + +### 0.2.8 (Jun 05, 2014) +* CB-6801 Add license +* running original windows.open, inAppBrowser is overriding it no need to place CSS in every page anymore +* CB-5945 [Windows8] do not call success callbacks until dialog is dismissed +* CB-4616 Returned index 0 was not documented for notification.prompt +* update docs to state that prompt is supported on windowsphone +* CB-6528 allow scroll on alert message content +* [CB-6628][amazon-fireos]dialogs plugin's confirm and prompt methods dont work confirm() method was missing amazon-fireos platform check. added that. prompt() method had bug. It is executed in a worker thread that does not have a message queue(or Looper object) associated with it and hence "can't create a handler" exception is thrown. To fix this issue, we need to create the EditText widget from within the UI thread. This was fixed sometime ago when we added fireos platform but commit got lost somewhere. So fixing it again now. +* CB-6491 add CONTRIBUTING.md +* Added check for isFinishing() on the parent activity to prevent crashes when trying to display dialogs when activity is in this phase of it's lifecycle +* CB-4966 Dialogs are in window now No need to add anything to manifest or index.html +* Removing FirefoxOS Quirks * no need to add special permission (it's different API with the same name) * notification.css is added automatically + +### 0.2.9 (Aug 06, 2014) +* ubuntu: pass proper arguments to prompt callback +* ubuntu: use TextField instead of TextInput +* ubuntu: proper message escaping before passing to qml +* **FFOS** update notification.js +* CB-6127 Updated translations for docs +* android: Explicitly apply default theme to dialogs +* Fix Beep exception on Android when no argument passed + +### 0.2.10 (Sep 17, 2014) +* CB-7538 Android beep thread fix Beep now executes in it's own thread. It was previously executing in the main UI thread which was causing the application to lock up will the beep was occurring. Closing pull request +* Set dialog text dir to locale +* Renamed test dir, added nested plugin.xml +* added documentation for manual tests +* CB-6965 Added manual tests +* CB-6965 Port notification tests to test-framework diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/de/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/de/index.md new file mode 100644 index 000000000..5b630f6a1 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/de/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +Dieses Plugin ermöglicht den Zugriff auf einige native Dialog-UI-Elemente. + +## Installation + + cordova plugin add org.apache.cordova.dialogs + + +## Methoden + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +Zeigt eine benutzerdefinierte Warnung oder Dialogfeld Feld. Die meisten Implementierungen von Cordova ein native Dialogfeld für dieses Feature verwenden, aber einige Plattformen des Browsers `alert` Funktion, die in der Regel weniger anpassbar ist. + + Navigator.Notification.Alert (Message, AlertCallback, [Titel], [ButtonName]) + + +* **Nachricht**: Dialogfeld Nachricht. *(String)* + +* **AlertCallback**: Callback aufgerufen wird, wenn Warnungs-Dialogfeld geschlossen wird. *(Funktion)* + +* **Titel**: Dialog "Titel". *(String)* (Optional, Standard ist`Alert`) + +* **ButtonName**: Name der Schaltfläche. *(String)* (Optional, Standard ist`OK`) + +### Beispiel + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### Unterstützte Plattformen + +* Amazon Fire OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 und 8 +* Windows 8 + +### Windows Phone 7 und 8 Macken + +* Es gibt keine eingebaute Datenbanksuchroutine-Warnung, aber Sie können binden, wie folgt zu nennen `alert()` im globalen Gültigkeitsbereich: + + window.alert = navigator.notification.alert; + + +* Beide `alert` und `confirm` sind nicht blockierende Aufrufe, die Ergebnisse davon nur asynchron sind. + +### Firefox OS Macken: + +Beide Native blockierenden `window.alert()` und nicht-blockierende `navigator.notification.alert()` stehen zur Verfügung. + +## navigator.notification.confirm + +Zeigt das Dialogfeld anpassbare Bestätigung. + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **Nachricht**: Dialogfeld Nachricht. *(String)* + +* **ConfirmCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)* + +* **Titel**: Dialog "Titel". *(String)* (Optional, Standard ist`Confirm`) + +* **ButtonLabels**: Array von Zeichenfolgen, die Schaltflächenbezeichnungen angeben. *(Array)* (Optional, Standard ist [ `OK,Cancel` ]) + +### confirmCallback + +Die `confirmCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Dialogfeld zur Bestätigung drückt. + +Der Rückruf dauert das Argument `buttonIndex` *(Anzahl)*, die der Index der Schaltfläche gedrückt ist. Beachten Sie, dass der Index 1-basierte Indizierung, verwendet, sodass der Wert ist `1` , `2` , `3` , etc.. + +### Beispiel + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### Unterstützte Plattformen + +* Amazon Fire OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 und 8 +* Windows 8 + +### Windows Phone 7 und 8 Macken + +* Es gibt keine integrierte Browser-Funktion für `window.confirm` , aber Sie können es binden, indem Sie zuweisen: + + window.confirm = navigator.notification.confirm; + + +* Aufrufe von `alert` und `confirm` sind nicht blockierend, so dass das Ergebnis nur asynchron zur Verfügung steht. + +### Firefox OS Macken: + +Beide Native blockierenden `window.confirm()` und nicht-blockierende `navigator.notification.confirm()` stehen zur Verfügung. + +## navigator.notification.prompt + +Zeigt eine native Dialogfeld, das mehr als des Browsers anpassbar ist `prompt` Funktion. + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **Nachricht**: Dialogfeld Nachricht. *(String)* + +* **PromptCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)* + +* **Titel**: Dialog Title *(String)* (Optional, Standard ist`Prompt`) + +* **ButtonLabels**: Array von Zeichenfolgen angeben Schaltfläche Etiketten *(Array)* (Optional, Standard ist`["OK","Cancel"]`) + +* **DefaultText**: Standard-Textbox Eingabewert ( `String` ) (Optional, Standard: leere Zeichenfolge) + +### promptCallback + +Die `promptCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Eingabedialogfeld drückt. Die `results` an den Rückruf übergebene Objekt enthält die folgenden Eigenschaften: + +* **ButtonIndex**: der Index der Schaltfläche gedrückt. *(Anzahl)* Beachten Sie, dass der Index 1-basierte Indizierung, verwendet, sodass der Wert ist `1` , `2` , `3` , etc.. + +* **Eingang1**: in Eingabedialogfeld eingegebenen Text. *(String)* + +### Beispiel + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### Unterstützte Plattformen + +* Amazon Fire OS +* Android +* Firefox OS +* iOS +* Windows Phone 7 und 8 + +### Android Macken + +* Android unterstützt maximal drei Schaltflächen und mehr als das ignoriert. + +* Auf Android 3.0 und höher, werden die Schaltflächen in umgekehrter Reihenfolge für Geräte angezeigt, die das Holo-Design verwenden. + +### Firefox OS Macken: + +Beide Native blockierenden `window.prompt()` und nicht-blockierende `navigator.notification.prompt()` stehen zur Verfügung. + +## navigator.notification.beep + +Das Gerät spielt einen Signalton sound. + + navigator.notification.beep(times); + + +* **Zeiten**: die Anzahl der Wiederholungen des Signaltons. *(Anzahl)* + +### Beispiel + + // Beep twice! + navigator.notification.beep(2); + + +### Unterstützte Plattformen + +* Amazon Fire OS +* Android +* BlackBerry 10 +* iOS +* Tizen +* Windows Phone 7 und 8 +* Windows 8 + +### Amazon Fire OS Macken + +* Amazon Fire OS spielt die Standardeinstellung **Akustische Benachrichtigung** unter **Einstellungen/Display & Sound** Bereich angegeben. + +### Android Macken + +* Android spielt die Standardeinstellung **Benachrichtigung Klingelton** unter **Einstellungen/Sound & Display** -Panel angegeben. + +### Windows Phone 7 und 8 Macken + +* Stützt sich auf eine generische Piepton-Datei aus der Cordova-Distribution. + +### Tizen Macken + +* Tizen implementiert Signaltöne durch Abspielen einer Audiodatei über die Medien API. + +* Die Beep-Datei muss kurz sein, befinden muss einem `sounds` Unterverzeichnis des Stammverzeichnisses der Anwendung, und muss den Namen`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/es/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/es/index.md new file mode 100644 index 000000000..3ccb5f7af --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/es/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +Este plugin proporciona acceso a algunos elementos de la interfaz nativa de diálogo. + +## Instalación + + cordova plugin add org.apache.cordova.dialogs + + +## Métodos + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +Muestra un cuadro de alerta o cuadro de diálogo personalizado. La mayoría de las implementaciones de Cordova utilizan un cuadro de diálogo nativa para esta característica, pero algunas plataformas utilizan el navegador `alert` la función, que es típicamente menos personalizable. + + navigator.notification.alert(message, alertCallback, [title], [buttonName]) + + +* **mensaje**: mensaje de diálogo. *(String)* + +* **alertCallback**: Callback para invocar al diálogo de alerta es desestimada. *(Función)* + +* **título**: título de diálogo. *(String)* (Opcional, por defecto`Alert`) + +* **buttonName**: nombre del botón. *(String)* (Opcional, por defecto`OK`) + +### Ejemplo + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### Plataformas soportadas + +* Amazon fuego OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 y 8 +* Windows 8 + +### Windows Phone 7 y 8 rarezas + +* No hay ninguna alerta del navegador integrado, pero puede enlazar uno proceda a llamar a `alert()` en el ámbito global: + + window.alert = navigator.notification.alert; + + +* Ambos `alert` y `confirm` son no-bloqueo llamadas, cuyos resultados sólo están disponibles de forma asincrónica. + +### Firefox OS rarezas: + +Dos nativos de bloqueo `window.alert()` y no-bloqueo `navigator.notification.alert()` están disponibles. + +## navigator.notification.confirm + +Muestra un cuadro de diálogo de confirmación personalizables. + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **mensaje**: mensaje de diálogo. *(String)* + +* **confirmCallback**: Callback para invocar con índice del botón pulsado (1, 2 ó 3) o cuando el cuadro de diálogo es despedido sin la presión del botón (0). *(Función)* + +* **título**: título de diálogo. *(String)* (Opcional, por defecto`Confirm`) + +* **buttonLabels**: matriz de cadenas especificando las etiquetas de botón. *(Matriz)* (Opcional, por defecto [ `OK,Cancel` ]) + +### confirmCallback + +El `confirmCallback` se ejecuta cuando el usuario presiona uno de los botones en el cuadro de diálogo de confirmación. + +La devolución de llamada toma el argumento `buttonIndex` *(número)*, que es el índice del botón presionado. Observe que el índice utiliza indexación basada en uno, entonces el valor es `1` , `2` , `3` , etc.. + +### Ejemplo + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### Plataformas soportadas + +* Amazon fuego OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 y 8 +* Windows 8 + +### Windows Phone 7 y 8 rarezas + +* No hay ninguna función de navegador incorporado para `window.confirm` , pero lo puede enlazar mediante la asignación: + + window.confirm = navigator.notification.confirm; + + +* Llama a `alert` y `confirm` son no-bloqueo, así que el resultado sólo está disponible de forma asincrónica. + +### Firefox OS rarezas: + +Dos nativos de bloqueo `window.confirm()` y no-bloqueo `navigator.notification.confirm()` están disponibles. + +## navigator.notification.prompt + +Muestra un cuadro de diálogo nativa que es más personalizable que del navegador `prompt` función. + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **mensaje**: mensaje de diálogo. *(String)* + +* **promptCallback**: Callback para invocar con índice del botón pulsado (1, 2 ó 3) o cuando el cuadro de diálogo es despedido sin la presión del botón (0). *(Función)* + +* **título**: título *(String)* (opcional, por defecto de diálogo`Prompt`) + +* **buttonLabels**: matriz de cadenas especificando botón etiquetas *(Array)* (opcional, por defecto`["OK","Cancel"]`) + +* **defaultText**: valor de la entrada predeterminada textbox ( `String` ) (opcional, por defecto: cadena vacía) + +### promptCallback + +El `promptCallback` se ejecuta cuando el usuario presiona uno de los botones del cuadro de diálogo pronto. El `results` objeto que se pasa a la devolución de llamada contiene las siguientes propiedades: + +* **buttonIndex**: el índice del botón presionado. *(Número)* Observe que el índice utiliza indexación basada en uno, entonces el valor es `1` , `2` , `3` , etc.. + +* **INPUT1**: el texto introducido en el cuadro de diálogo pronto. *(String)* + +### Ejemplo + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### Plataformas soportadas + +* Amazon fuego OS +* Android +* Firefox OS +* iOS +* Windows Phone 7 y 8 + +### Rarezas Android + +* Android soporta un máximo de tres botones e ignora nada más. + +* En Android 3.0 y posteriores, los botones aparecen en orden inverso para dispositivos que utilizan el tema Holo. + +### Firefox OS rarezas: + +Dos nativos de bloqueo `window.prompt()` y no-bloqueo `navigator.notification.prompt()` están disponibles. + +## navigator.notification.beep + +El aparato reproduce un sonido sonido. + + navigator.notification.beep(times); + + +* **tiempos**: el número de veces a repetir la señal. *(Número)* + +### Ejemplo + + // Beep twice! + navigator.notification.beep(2); + + +### Plataformas soportadas + +* Amazon fuego OS +* Android +* BlackBerry 10 +* iOS +* Tizen +* Windows Phone 7 y 8 +* Windows 8 + +### Amazon fuego OS rarezas + +* Amazon fuego OS reproduce el **Sonido de notificación** especificados en el panel de **configuración/pantalla y sonido** por defecto. + +### Rarezas Android + +* Androide reproduce el **tono de notificación** especificados en el panel **ajustes de sonido y visualización** por defecto. + +### Windows Phone 7 y 8 rarezas + +* Se basa en un archivo de sonido genérico de la distribución de Córdoba. + +### Rarezas Tizen + +* Tizen implementa pitidos por reproducir un archivo de audio a través de los medios de comunicación API. + +* El archivo de sonido debe ser corto, debe estar ubicado en un `sounds` subdirectorio del directorio raíz de la aplicación y deben ser nombrados`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/fr/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/fr/index.md new file mode 100644 index 000000000..5e4398a22 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/fr/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +Ce plugin permet d'accéder à certains éléments d'interface utilisateur native de dialogue. + +## Installation + + cordova plugin add org.apache.cordova.dialogs + + +## Méthodes + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +Affiche une boîte de dialogue ou d'alerte personnalisé. La plupart des implémentations de Cordova utilisent une boîte de dialogue natives pour cette fonctionnalité, mais certaines plates-formes du navigateur `alert` fonction, qui est généralement moins personnalisable. + + Navigator.notification.Alert (message, alertCallback, [titre], [buttonName]) + + +* **message**: message de la boîte de dialogue. *(String)* + +* **alertCallback**: callback à appeler lorsque la boîte de dialogue d'alerte est rejetée. *(Fonction)* + +* **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`) + +* **buttonName**: nom du bouton. *(String)* (Facultatif, par défaut`OK`) + +### Exemple + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### Plates-formes prises en charge + +* Amazon Fire OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 et 8 +* Windows 8 + +### Windows Phone 7 et 8 Quirks + +* Il n'y a aucune boîte de dialogue d'alerte intégrée au navigateur, mais vous pouvez en lier une pour appeler `alert()` dans le scope global: + + window.alert = navigator.notification.alert; + + +* Les deux appels `alert` et `confirm` sont non-blocants, leurs résultats ne sont disponibles que de façon asynchrone. + +### Firefox OS Quirks : + +Les deux indigènes bloquant `window.alert()` et non-bloquante `navigator.notification.alert()` sont disponibles. + +## navigator.notification.confirm + +Affiche une boîte de dialogue de confirmation personnalisable. + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **message**: message de la boîte de dialogue. *(String)* + +* **confirmCallback**: callback à appeler avec l'index du bouton pressé (1, 2 ou 3) ou lorsque la boîte de dialogue est fermée sans qu'un bouton ne soit pressé (0). *(Fonction)* + +* **titre**: titre de dialogue. *(String)* (Facultatif, par défaut`Confirm`) + +* **buttonLabels**: tableau de chaînes spécifiant les étiquettes des boutons. *(Array)* (Optionnel, par défaut, [ `OK,Cancel` ]) + +### confirmCallback + +Le `confirmCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue de confirmation. + +Le rappel prend l'argument `buttonIndex` *(nombre)*, qui est l'index du bouton activé. Notez que l'index utilise base d'indexation, la valeur est `1` , `2` , `3` , etc.. + +### Exemple + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### Plates-formes prises en charge + +* Amazon Fire OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Paciarelli +* Windows Phone 7 et 8 +* Windows 8 + +### Windows Phone 7 et 8 Quirks + +* Il n'y a aucune fonction intégrée au navigateur pour `window.confirm`, mais vous pouvez en lier une en affectant: + + window.confirm = navigator.notification.confirm ; + + +* Les appels à `alert` et `confirm` sont non-bloquants, donc le résultat est seulement disponible de façon asynchrone. + +### Firefox OS Quirks : + +Les deux indigènes bloquant `window.confirm()` et non-bloquante `navigator.notification.confirm()` sont disponibles. + +## navigator.notification.prompt + +Affiche une boîte de dialogue natif qui est plus personnalisable que le navigateur `prompt` fonction. + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **message**: message de la boîte de dialogue. *(String)* + +* **promptCallback**: rappel d'invoquer avec l'index du bouton pressé (1, 2 ou 3) ou lorsque la boîte de dialogue est fermée sans une presse de bouton (0). *(Fonction)* + +* **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`) + +* **buttonLabels**: tableau de chaînes spécifiant les étiquettes de boutons *(Array)* (facultatif, par défaut, les étiquettes `["OK","Cancel"]`) + +* **defaultText**: texte par défaut de la zone de texte ( `String` ) (en option, par défaut : chaîne vide) + +### promptCallback + +Le `promptCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue d'invite. Le `results` objet passé au rappel contient les propriétés suivantes : + +* **buttonIndex**: l'index du bouton activé. *(Nombre)* Notez que l'index utilise une indexation de base 1, donc la valeur est `1` , `2` , `3` , etc. + +* **entrée 1**: le texte entré dans la boîte de dialogue d'invite. *(String)* + +### Exemple + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### Plates-formes prises en charge + +* Amazon Fire OS +* Android +* Firefox OS +* iOS +* Windows Phone 7 et 8 + +### Quirks Android + +* Android prend en charge un maximum de trois boutons et ignore plus que cela. + +* Sur Android 3.0 et versions ultérieures, les boutons sont affichés dans l'ordre inverse pour les appareils qui utilisent le thème Holo. + +### Firefox OS Quirks : + +Les deux indigènes bloquant `window.prompt()` et non-bloquante `navigator.notification.prompt()` sont disponibles. + +## navigator.notification.beep + +Le dispositif joue un bip sonore. + + navigator.notification.beep(times); + + +* **temps**: le nombre de fois répéter le bip. *(Nombre)* + +### Exemple + + // Beep twice! + navigator.notification.beep(2); + + +### Plates-formes prises en charge + +* Amazon Fire OS +* Android +* BlackBerry 10 +* iOS +* Paciarelli +* Windows Phone 7 et 8 +* Windows 8 + +### Amazon Fire OS Quirks + +* Amazon Fire OS joue la valeur par défaut le **Son de Notification** spécifié sous le panneau **d'affichage des réglages/& Sound** . + +### Quirks Android + +* Android joue la **sonnerie de Notification** spécifié sous le panneau des **réglages/son et affichage** de valeur par défaut. + +### Windows Phone 7 et 8 Quirks + +* S'appuie sur un fichier générique bip de la distribution de Cordova. + +### Bizarreries de paciarelli + +* Paciarelli implémente les bips en lisant un fichier audio via les médias API. + +* Le fichier sonore doit être court, doit se trouver dans un `sounds` sous-répertoire du répertoire racine de l'application et doit être nommé`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/index.md new file mode 100644 index 000000000..97ebf92ff --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/index.md @@ -0,0 +1,248 @@ + + +# org.apache.cordova.dialogs + +This plugin provides access to some native dialog UI elements. + +## Installation + + cordova plugin add org.apache.cordova.dialogs + +## Methods + +- `navigator.notification.alert` +- `navigator.notification.confirm` +- `navigator.notification.prompt` +- `navigator.notification.beep` + +## navigator.notification.alert + +Shows a custom alert or dialog box. Most Cordova implementations use a native +dialog box for this feature, but some platforms use the browser's `alert` +function, which is typically less customizable. + + navigator.notification.alert(message, alertCallback, [title], [buttonName]) + +- __message__: Dialog message. _(String)_ + +- __alertCallback__: Callback to invoke when alert dialog is dismissed. _(Function)_ + +- __title__: Dialog title. _(String)_ (Optional, defaults to `Alert`) + +- __buttonName__: Button name. _(String)_ (Optional, defaults to `OK`) + + +### Example + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + +### Supported Platforms + +- Amazon Fire OS +- Android +- BlackBerry 10 +- Firefox OS +- iOS +- Tizen +- Windows Phone 7 and 8 +- Windows 8 + +### Windows Phone 7 and 8 Quirks + +- There is no built-in browser alert, but you can bind one as follows to call `alert()` in the global scope: + + window.alert = navigator.notification.alert; + +- Both `alert` and `confirm` are non-blocking calls, results of which are only available asynchronously. + +### Firefox OS Quirks: + +Both native-blocking `window.alert()` and non-blocking `navigator.notification.alert()` are available. + +## navigator.notification.confirm + +Displays a customizable confirmation dialog box. + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + +- __message__: Dialog message. _(String)_ + +- __confirmCallback__: Callback to invoke with index of button pressed (1, 2, or 3) or when the dialog is dismissed without a button press (0). _(Function)_ + +- __title__: Dialog title. _(String)_ (Optional, defaults to `Confirm`) + +- __buttonLabels__: Array of strings specifying button labels. _(Array)_ (Optional, defaults to [`OK,Cancel`]) + + +### confirmCallback + +The `confirmCallback` executes when the user presses one of the +buttons in the confirmation dialog box. + +The callback takes the argument `buttonIndex` _(Number)_, which is the +index of the pressed button. Note that the index uses one-based +indexing, so the value is `1`, `2`, `3`, etc. + +### Example + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + +### Supported Platforms + +- Amazon Fire OS +- Android +- BlackBerry 10 +- Firefox OS +- iOS +- Tizen +- Windows Phone 7 and 8 +- Windows 8 + +### Windows Phone 7 and 8 Quirks + +- There is no built-in browser function for `window.confirm`, but you can bind it by assigning: + + window.confirm = navigator.notification.confirm; + +- Calls to `alert` and `confirm` are non-blocking, so the result is only available asynchronously. + +### Firefox OS Quirks: + +Both native-blocking `window.confirm()` and non-blocking `navigator.notification.confirm()` are available. + +## navigator.notification.prompt + +Displays a native dialog box that is more customizable than the browser's `prompt` function. + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + +- __message__: Dialog message. _(String)_ + +- __promptCallback__: Callback to invoke with index of button pressed (1, 2, or 3) or when the dialog is dismissed without a button press (0). _(Function)_ + +- __title__: Dialog title _(String)_ (Optional, defaults to `Prompt`) + +- __buttonLabels__: Array of strings specifying button labels _(Array)_ (Optional, defaults to `["OK","Cancel"]`) + +- __defaultText__: Default textbox input value (`String`) (Optional, Default: empty string) + +### promptCallback + +The `promptCallback` executes when the user presses one of the buttons +in the prompt dialog box. The `results` object passed to the callback +contains the following properties: + +- __buttonIndex__: The index of the pressed button. _(Number)_ Note that the index uses one-based indexing, so the value is `1`, `2`, `3`, etc. + + + +- __input1__: The text entered in the prompt dialog box. _(String)_ + +### Example + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + +### Supported Platforms + +- Amazon Fire OS +- Android +- Firefox OS +- iOS +- Windows Phone 7 and 8 + +### Android Quirks + +- Android supports a maximum of three buttons, and ignores any more than that. + +- On Android 3.0 and later, buttons are displayed in reverse order for devices that use the Holo theme. + +### Firefox OS Quirks: + +Both native-blocking `window.prompt()` and non-blocking `navigator.notification.prompt()` are available. + +## navigator.notification.beep + +The device plays a beep sound. + + navigator.notification.beep(times); + +- __times__: The number of times to repeat the beep. _(Number)_ + +### Example + + // Beep twice! + navigator.notification.beep(2); + +### Supported Platforms + +- Amazon Fire OS +- Android +- BlackBerry 10 +- iOS +- Tizen +- Windows Phone 7 and 8 +- Windows 8 + +### Amazon Fire OS Quirks + +- Amazon Fire OS plays the default __Notification Sound__ specified under the __Settings/Display & Sound__ panel. + +### Android Quirks + +- Android plays the default __Notification ringtone__ specified under the __Settings/Sound & Display__ panel. + +### Windows Phone 7 and 8 Quirks + +- Relies on a generic beep file from the Cordova distribution. + +### Tizen Quirks + +- Tizen implements beeps by playing an audio file via the media API. + +- The beep file must be short, must be located in a `sounds` subdirectory of the application's root directory, and must be named `beep.wav`. + diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/it/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/it/index.md new file mode 100644 index 000000000..f0132c361 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/it/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +Questo plugin consente di accedere ad alcuni elementi di interfaccia utente nativa del dialogo. + +## Installazione + + cordova plugin add org.apache.cordova.dialogs + + +## Metodi + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +Mostra una finestra di avviso o la finestra di dialogo personalizzata. La maggior parte delle implementazioni di Cordova una dialogo nativa per questa caratteristica, ma alcune piattaforme utilizzano il browser `alert` funzione, che è in genere meno personalizzabile. + + navigator.notification.alert(message, alertCallback, [title], [buttonName]) + + +* **messaggio**: messaggio finestra di dialogo. *(String)* + +* **alertCallback**: Callback da richiamare quando viene chiusa la finestra di avviso. *(Funzione)* + +* **titolo**: titolo di dialogo. *(String)* (Opzionale, default è`Alert`) + +* **buttonName**: nome del pulsante. *(String)* (Opzionale, default è`OK`) + +### Esempio + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### Piattaforme supportate + +* Amazon fuoco OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 e 8 +* Windows 8 + +### Windows Phone 7 e 8 stranezze + +* Non non c'è nessun avviso del browser integrato, ma è possibile associare uno come segue per chiamare `alert()` in ambito globale: + + window.alert = navigator.notification.alert; + + +* Entrambi `alert` e `confirm` sono non di blocco chiamate, risultati di cui sono disponibili solo in modo asincrono. + +### Firefox OS Stranezze: + +Entrambi nativi di blocco `window.alert()` e non bloccante `navigator.notification.alert()` sono disponibili. + +## navigator.notification.confirm + +Visualizza una finestra di dialogo conferma personalizzabile. + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **messaggio**: messaggio finestra di dialogo. *(String)* + +* **confirmCallback**: Callback da richiamare con l'indice del pulsante premuto (1, 2 o 3) o quando la finestra di dialogo viene chiusa senza una pressione del pulsante (0). *(Funzione)* + +* **titolo**: titolo di dialogo. *(String)* (Opzionale, default è`Confirm`) + +* **buttonLabels**: matrice di stringhe che specificano le etichette dei pulsanti. *(Matrice)* (Opzionale, default è [ `OK,Cancel` ]) + +### confirmCallback + +Il `confirmCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo conferma. + +Il callback accetta l'argomento `buttonIndex` *(numero)*, che è l'indice del pulsante premuto. Nota che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1` , `2` , `3` , ecc. + +### Esempio + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### Piattaforme supportate + +* Amazon fuoco OS +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 e 8 +* Windows 8 + +### Windows Phone 7 e 8 stranezze + +* Non non c'è nessuna funzione browser incorporato per `window.confirm` , ma è possibile associare assegnando: + + window.confirm = navigator.notification.confirm; + + +* Chiama al `alert` e `confirm` sono non bloccante, quindi il risultato è disponibile solo in modo asincrono. + +### Firefox OS Stranezze: + +Entrambi nativi di blocco `window.confirm()` e non bloccante `navigator.notification.confirm()` sono disponibili. + +## navigator.notification.prompt + +Visualizza una finestra di dialogo nativa che è più personalizzabile del browser `prompt` funzione. + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **messaggio**: messaggio finestra di dialogo. *(String)* + +* **promptCallback**: Callback da richiamare con l'indice del pulsante premuto (1, 2 o 3) o quando la finestra di dialogo viene chiusa senza una pressione del pulsante (0). *(Funzione)* + +* **titolo**: dialogo titolo *(String)* (opzionale, default è`Prompt`) + +* **buttonLabels**: matrice di stringhe specificando il pulsante etichette *(Array)* (opzionale, default è`["OK","Cancel"]`) + +* **defaultText**: valore di input predefinito textbox ( `String` ) (opzionale, Default: stringa vuota) + +### promptCallback + +Il `promptCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo richiesta. Il `results` oggetto passato al metodo di callback contiene le seguenti proprietà: + +* **buttonIndex**: l'indice del pulsante premuto. *(Numero)* Nota che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1` , `2` , `3` , ecc. + +* **INPUT1**: il testo immesso nella finestra di dialogo richiesta. *(String)* + +### Esempio + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### Piattaforme supportate + +* Amazon fuoco OS +* Android +* Firefox OS +* iOS +* Windows Phone 7 e 8 + +### Stranezze Android + +* Android supporta un massimo di tre pulsanti e ignora di più di quello. + +* Su Android 3.0 e versioni successive, i pulsanti vengono visualizzati in ordine inverso per dispositivi che utilizzano il tema Holo. + +### Firefox OS Stranezze: + +Entrambi nativi di blocco `window.prompt()` e non bloccante `navigator.notification.prompt()` sono disponibili. + +## navigator.notification.beep + +Il dispositivo riproduce un bip sonoro. + + navigator.notification.beep(times); + + +* **volte**: il numero di volte per ripetere il segnale acustico. *(Numero)* + +### Esempio + + // Beep twice! + navigator.notification.beep(2); + + +### Piattaforme supportate + +* Amazon fuoco OS +* Android +* BlackBerry 10 +* iOS +* Tizen +* Windows Phone 7 e 8 +* Windows 8 + +### Amazon fuoco OS stranezze + +* Amazon fuoco OS riproduce il **Suono di notifica** specificato sotto il pannello **Impostazioni/Display e il suono** predefinito. + +### Stranezze Android + +* Android giochi default **Notification ringtone** specificato sotto il pannello **impostazioni/audio e Display** . + +### Windows Phone 7 e 8 stranezze + +* Si basa su un file generico bip dalla distribuzione di Cordova. + +### Tizen stranezze + +* Tizen implementa bip di riproduzione di un file audio tramite i media API. + +* Il file beep deve essere breve, deve essere situato un `sounds` sottodirectory della directory radice dell'applicazione e deve essere denominato`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/ja/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/ja/index.md new file mode 100644 index 000000000..eae820816 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/ja/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +このプラグインはいくつかのネイティブのダイアログの UI 要素へのアクセスを提供します。 + +## インストール + + cordova plugin add org.apache.cordova.dialogs + + +## メソッド + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +カスタムの警告またはダイアログ ボックスが表示されます。 ほとんどコルドバ ネイティブ] ダイアログ ボックスの使用この機能がいくつかのプラットフォームを使用して、ブラウザーの `alert` 関数は、通常より少なくカスタマイズ可能です。 + + navigator.notification.alert(message, alertCallback, [title], [buttonName]) + + +* **メッセージ**: ダイアログ メッセージ。*(文字列)* + +* **alertCallback**: 警告ダイアログが閉じられたときに呼び出すコールバック。*(機能)* + +* **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Alert`) + +* **buttonName**: ボタンの名前。*(文字列)*(省略可能、既定値は`OK`) + +### 例 + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### サポートされているプラットフォーム + +* アマゾン火 OS +* アンドロイド +* ブラックベリー 10 +* Firefox の OS +* iOS +* Tizen +* Windows Phone 7 と 8 +* Windows 8 + +### Windows Phone 7 と 8 癖 + +* 組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます `alert()` 、グローバル スコープで。 + + window.alert = navigator.notification.alert; + + +* 両方の `alert` と `confirm` は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。 + +### Firefox OS 互換: + +両方のネイティブ ブロック `window.alert()` ノン ブロッキングと `navigator.notification.alert()` は利用できます。 + +## navigator.notification.confirm + +カスタマイズ可能な確認のダイアログ ボックスが表示されます。 + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **メッセージ**: ダイアログ メッセージ。*(文字列)* + +* **confirmCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す （0） なしに解雇されたときに呼び出すコールバック。*(機能)* + +* **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Confirm`) + +* **buttonLabels**: ボタンのラベルを指定する文字列の配列。*(配列)*(省略可能、既定値は [ `OK,Cancel` ]) + +### confirmCallback + +`confirmCallback`の確認ダイアログ ボックスでボタンを押したときに実行されます。 + +コールバック引数 `buttonIndex` *（番号）*は、押されたボタンのインデックス。 メモこと、インデックスを使用して 1 ベースのインデックス化、ので、値は `1` 、 `2` 、 `3` 、等。 + +### 例 + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### サポートされているプラットフォーム + +* アマゾン火 OS +* アンドロイド +* ブラックベリー 10 +* Firefox の OS +* iOS +* Tizen +* Windows Phone 7 と 8 +* Windows 8 + +### Windows Phone 7 と 8 癖 + +* 組み込みブラウザーの機能はありません `window.confirm` が割り当てることによってバインドすることができます。 + + window.confirm = navigator.notification.confirm; + + +* 呼び出しを `alert` と `confirm` では非ブロッキング、結果は非同期的にのみ使用できます。 + +### Firefox OS 互換: + +両方のネイティブ ブロック `window.confirm()` ノン ブロッキングと `navigator.notification.confirm()` は利用できます。 + +## navigator.notification.prompt + +ブラウザーのより詳細にカスタマイズはネイティブのダイアログ ボックスが表示されます `prompt` 関数。 + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **メッセージ**: ダイアログ メッセージ。*(文字列)* + +* **promptCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す （0） なしに解雇されたときに呼び出すコールバック。*(機能)* + +* **タイトル**: *(文字列)* (省略可能、既定値のタイトル] ダイアログ`Prompt`) + +* **buttonLabels**： ボタンを指定する文字列の配列*(配列)* (省略可能、既定値のラベル`["OK","Cancel"]`) + +* **これら**: 既定テキスト ボックスの入力値 ( `String` ) (省略可能、既定: 空の文字列) + +### promptCallback + +`promptCallback`プロンプト ダイアログ ボックス内のボタンのいずれかを押したときに実行されます。`results`コールバックに渡されるオブジェクトに、次のプロパティが含まれています。 + +* **buttonIndex**: 押されたボタンのインデックス。*(数)*メモこと、インデックスを使用して 1 ベースのインデックス化、ので、値は `1` 、 `2` 、 `3` 、等。 + +* **input1**: プロンプト ダイアログ ボックスに入力したテキスト。*(文字列)* + +### 例 + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### サポートされているプラットフォーム + +* アマゾン火 OS +* アンドロイド +* Firefox の OS +* iOS +* Windows Phone 7 と 8 + +### Android の癖 + +* Android は最大 3 つのボタンをサポートしているし、それ以上無視します。 + +* アンドロイド 3.0 と後、ホロのテーマを使用するデバイスを逆の順序でボタンが表示されます。 + +### Firefox OS 互換: + +両方のネイティブ ブロック `window.prompt()` ノン ブロッキングと `navigator.notification.prompt()` は利用できます。 + +## navigator.notification.beep + +デバイス サウンドをビープ音を再生します。 + + navigator.notification.beep(times); + + +* **回**: ビープ音を繰り返す回数。*(数)* + +### 例 + + // Beep twice! + navigator.notification.beep(2); + + +### サポートされているプラットフォーム + +* アマゾン火 OS +* アンドロイド +* ブラックベリー 10 +* iOS +* Tizen +* Windows Phone 7 と 8 +* Windows 8 + +### アマゾン火 OS 癖 + +* アマゾン火 OS デフォルト**設定/表示 ＆ サウンド**パネルの下に指定した**通知音**を果たしています。 + +### Android の癖 + +* アンドロイド デフォルト**通知着信音****設定/サウンド ＆ ディスプレイ**パネルの下に指定を果たしています。 + +### Windows Phone 7 と 8 癖 + +* コルドバ分布からジェネリック ビープ音ファイルに依存します。 + +### Tizen の癖 + +* Tizen は、メディア API 経由でオーディオ ファイルを再生してビープ音を実装します。 + +* ビープ音ファイルする必要があります短いである必要があります、 `sounds` 、アプリケーションのルート ディレクトリのサブディレクトリと命名する必要があります`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/ko/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/ko/index.md new file mode 100644 index 000000000..2350421a0 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/ko/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +이 플러그인 몇 가지 기본 대화 상자 UI 요소에 액세스할 수 있습니다. + +## 설치 + + cordova plugin add org.apache.cordova.dialogs + + +## 메서드 + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +사용자 지정 경고 또는 대화 상자를 보여 줍니다. 이 기능에 대 한 기본 대화 상자를 사용 하는 대부분의 코르도바 구현 하지만 일부 플랫폼 사용 브라우저의 `alert` 함수는 일반적으로 덜 사용자 정의할 수 있습니다. + + navigator.notification.alert(message, alertCallback, [title], [buttonName]) + + +* **메시지**: 대화 메시지. *(문자열)* + +* **alertCallback**: 콜백을 호출할 때 경고 대화 기 각. *(기능)* + +* **제목**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Alert`) + +* **buttonName**: 단추 이름. *(문자열)* (옵션, 기본값:`OK`) + +### 예를 들어 + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### 지원 되는 플랫폼 + +* 아마존 화재 운영 체제 +* 안 드 로이드 +* 블랙베리 10 +* Firefox 운영 체제 +* iOS +* Tizen +* Windows Phone 7과 8 +* 윈도우 8 + +### Windows Phone 7, 8 특수 + +* 아니 내장 브라우저 경고 하지만 다음과 같이 전화를 바인딩할 수 있습니다 `alert()` 전역 범위에서: + + window.alert = navigator.notification.alert; + + +* 둘 다 `alert` 와 `confirm` 는 비차단 호출, 결과 비동기적으로 사용할 수 있습니다. + +### 파이어 폭스 OS 단점: + +두 기본 차단 `window.alert()` 및 비차단 `navigator.notification.alert()` 사용할 수 있습니다. + +## navigator.notification.confirm + +사용자 정의 확인 대화 상자가 표시 됩니다. + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **메시지**: 대화 메시지. *(문자열)* + +* **confirmCallback**: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. *(기능)* + +* **제목**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Confirm`) + +* **buttonLabels**: 단추 레이블을 지정 하는 문자열 배열입니다. *(배열)* (옵션, 기본값은 [ `OK,Cancel` ]) + +### confirmCallback + +`confirmCallback`사용자가 확인 대화 상자에서 단추 중 하나를 누를 때 실행 됩니다. + +콜백 인수 `buttonIndex` *(번호)를*누르면된 버튼의 인덱스입니다. 참고 인덱스에서는 인덱스 1부터 값은 `1` , `2` , `3` , 등등. + +### 예를 들어 + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### 지원 되는 플랫폼 + +* 아마존 화재 운영 체제 +* 안 드 로이드 +* 블랙베리 10 +* Firefox 운영 체제 +* iOS +* Tizen +* Windows Phone 7과 8 +* 윈도우 8 + +### Windows Phone 7, 8 특수 + +* 에 대 한 기본 제공 브라우저 함수가 `window.confirm` , 그러나 할당 하 여 바인딩할 수 있습니다: + + window.confirm = navigator.notification.confirm; + + +* 호출 `alert` 및 `confirm` 되므로 차단 되지 않은 결과만 비동기적으로 사용할 수 있습니다. + +### 파이어 폭스 OS 단점: + +두 기본 차단 `window.confirm()` 및 비차단 `navigator.notification.confirm()` 사용할 수 있습니다. + +## navigator.notification.prompt + +브라우저의 보다 더 많은 사용자 정의 기본 대화 상자 표시 `prompt` 기능. + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **메시지**: 대화 메시지. *(문자열)* + +* **promptCallback**: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. *(기능)* + +* **제목**: 제목 *(문자열)* (옵션, 기본값 대화 상자`Prompt`) + +* **buttonLabels**: 단추를 지정 하는 문자열의 배열 *(배열)* (옵션, 기본값은 레이블`["OK","Cancel"]`) + +* **defaultText**: 기본 텍스트 상자 입력 값 ( `String` ) (옵션, 기본값: 빈 문자열) + +### promptCallback + +`promptCallback`사용자가 프롬프트 대화 상자에서 단추 중 하나를 누를 때 실행 됩니다. `results`콜백에 전달 된 개체에는 다음 속성이 포함 되어 있습니다: + +* **buttonIndex**: 눌려진된 버튼의 인덱스. *(수)* 참고 인덱스에서는 인덱스 1부터 값은 `1` , `2` , `3` , 등등. + +* **input1**: 프롬프트 대화 상자에 입력 한 텍스트. *(문자열)* + +### 예를 들어 + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### 지원 되는 플랫폼 + +* 아마존 화재 운영 체제 +* 안 드 로이드 +* Firefox 운영 체제 +* iOS +* Windows Phone 7과 8 + +### 안 드 로이드 단점 + +* 안 드 로이드 최대 3 개의 단추를 지원 하 고 그것 보다는 더 이상 무시 합니다. + +* 안 드 로이드 3.0 및 나중에, 단추는 홀로 테마를 사용 하는 장치에 대 한 반대 순서로 표시 됩니다. + +### 파이어 폭스 OS 단점: + +두 기본 차단 `window.prompt()` 및 비차단 `navigator.notification.prompt()` 사용할 수 있습니다. + +## navigator.notification.beep + +장치는 경고음 소리를 재생 합니다. + + navigator.notification.beep(times); + + +* **시간**: 경고음을 반복 하는 횟수. *(수)* + +### 예를 들어 + + // Beep twice! + navigator.notification.beep(2); + + +### 지원 되는 플랫폼 + +* 아마존 화재 운영 체제 +* 안 드 로이드 +* 블랙베리 10 +* iOS +* Tizen +* Windows Phone 7과 8 +* 윈도우 8 + +### 아마존 화재 OS 단점 + +* 아마존 화재 운영 체제 기본 **설정/디스플레이 및 사운드** 패널에 지정 된 **알림 소리** 재생 됩니다. + +### 안 드 로이드 단점 + +* 안 드 로이드 기본 **알림 벨소리** **설정/사운드 및 디스플레이** 패널에서 지정 합니다. + +### Windows Phone 7, 8 특수 + +* 코르 도우 바 분포에서 일반 경고음 파일에 의존합니다. + +### Tizen 특수 + +* Tizen은 미디어 API 통해 오디오 파일을 재생 하 여 경고음을 구현 합니다. + +* 경고음 파일에 위치 해야 합니다, 짧은 해야 한 `sounds` 응용 프로그램의 루트 디렉터리의 하위 디렉터리 명명 해야 합니다`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/pl/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/pl/index.md new file mode 100644 index 000000000..c968310fe --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/pl/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +Ten plugin umożliwia dostęp do niektórych rodzimych okna dialogowego elementy interfejsu użytkownika. + +## Instalacji + + cordova plugin add org.apache.cordova.dialogs + + +## Metody + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +Pokazuje niestandardowe wpisu lub okno dialogowe. Większość implementacji Cordova używać rodzimych okno dialogowe dla tej funkcji, ale niektóre platformy używać przeglądarki `alert` funkcja, który jest zazwyczaj mniej konfigurowalny. + + navigator.notification.alert(message, alertCallback, [title], [buttonName]) + + +* **wiadomość**: komunikat okna dialogowego. *(String)* + +* **alertCallback**: wywołanie zwrotne do wywołania, gdy okno dialogowe alert jest oddalona. *(Funkcja)* + +* **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Alert`) + +* **buttonName**: Nazwa przycisku. *(String)* (Opcjonalna, domyślnie`OK`) + +### Przykład + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### Obsługiwane platformy + +* Amazon ogień OS +* Android +* Jeżyna 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 i 8 +* Windows 8 + +### Windows Phone 7 i 8 dziwactwa + +* Istnieje wpis nie wbudowana przeglądarka, ale można powiązać w następujący sposób na wywołanie `alert()` w globalnym zasięgu: + + window.alert = navigator.notification.alert; + + +* Zarówno `alert` i `confirm` są bez blokowania połączeń, których wyniki są tylko dostępne asynchronicznie. + +### Firefox OS dziwactwa: + +Blokuje zarówno rodzimych `window.alert()` i bez blokowania `navigator.notification.alert()` są dostępne. + +## navigator.notification.confirm + +Wyświetla okno dialogowe potwierdzenia konfigurowalny. + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **wiadomość**: komunikat okna dialogowego. *(String)* + +* **confirmCallback**: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). *(Funkcja)* + +* **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Confirm`) + +* **buttonLabels**: tablica ciągów, określając etykiety przycisków. *(Tablica)* (Opcjonalna, domyślnie [ `OK,Cancel` ]) + +### confirmCallback + +`confirmCallback`Wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym potwierdzenia. + +Wywołania zwrotnego przyjmuje argument `buttonIndex` *(numer)*, który jest indeksem wciśnięty przycisk. Uwaga, że indeks używa, na podstawie jednego indeksowania, więc wartość jest `1` , `2` , `3` , itp. + +### Przykład + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### Obsługiwane platformy + +* Amazon ogień OS +* Android +* Jeżyna 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 i 8 +* Windows 8 + +### Windows Phone 7 i 8 dziwactwa + +* Istnieje funkcja wbudowana przeglądarka nie `window.confirm` , ale można go powiązać przypisując: + + window.confirm = navigator.notification.confirm; + + +* Wzywa do `alert` i `confirm` są bez blokowania, więc wynik jest tylko dostępnych asynchronicznie. + +### Firefox OS dziwactwa: + +Blokuje zarówno rodzimych `window.confirm()` i bez blokowania `navigator.notification.confirm()` są dostępne. + +## navigator.notification.prompt + +Wyświetla okno dialogowe macierzystego, który bardziej niż przeglądarki `prompt` funkcja. + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **wiadomość**: komunikat okna dialogowego. *(String)* + +* **promptCallback**: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). *(Funkcja)* + +* **tytuł**: okno tytuł *(String)* (opcjonalna, domyślnie`Prompt`) + +* **buttonLabels**: tablica ciągów, określając przycisk etykiety *(tablica)* (opcjonalna, domyślnie`["OK","Cancel"]`) + +* **defaultText**: wartość wejściowa tekstowym domyślnego ( `String` ) (opcjonalna, domyślnie: pusty ciąg) + +### promptCallback + +`promptCallback`Wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym polecenia. `results`Obiekt przekazywany do wywołania zwrotnego zawiera następujące właściwości: + +* **buttonIndex**: indeks wciśnięty przycisk. *(Liczba)* Uwaga, że indeks używa, na podstawie jednego indeksowania, więc wartość jest `1` , `2` , `3` , itp. + +* **input1**: Tekst wprowadzony w oknie polecenia. *(String)* + +### Przykład + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### Obsługiwane platformy + +* Amazon ogień OS +* Android +* Firefox OS +* iOS +* Windows Phone 7 i 8 + +### Android dziwactwa + +* Android obsługuje maksymalnie trzy przyciski i więcej niż to ignoruje. + +* Android 3.0 i nowszych przyciski są wyświetlane w kolejności odwrotnej do urządzenia, które używają tematu Holo. + +### Firefox OS dziwactwa: + +Blokuje zarówno rodzimych `window.prompt()` i bez blokowania `navigator.notification.prompt()` są dostępne. + +## navigator.notification.beep + +Urządzenie odtwarza sygnał ciągły dźwięk. + + navigator.notification.beep(times); + + +* **razy**: liczba powtórzeń po sygnale. *(Liczba)* + +### Przykład + + // Beep twice! + navigator.notification.beep(2); + + +### Obsługiwane platformy + +* Amazon ogień OS +* Android +* Jeżyna 10 +* iOS +* Tizen +* Windows Phone 7 i 8 +* Windows 8 + +### Amazon ogień OS dziwactwa + +* Amazon ogień OS gra domyślny **Dźwięk powiadomienia** określone w panelu **ekranu/ustawienia i dźwięk** . + +### Android dziwactwa + +* Android gra domyślnie **dzwonek powiadomienia** określone w panelu **ustawień/dźwięk i wyświetlacz** . + +### Windows Phone 7 i 8 dziwactwa + +* Opiera się na pliku rodzajowego sygnał z rozkładu Cordova. + +### Osobliwości Tizen + +* Tizen implementuje dźwięków przez odtwarzania pliku audio za pośrednictwem mediów API. + +* Plik dźwiękowy muszą być krótkie, musi znajdować się w `sounds` podkatalogu katalogu głównego aplikacji i musi być nazwany`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/ru/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/ru/index.md new file mode 100644 index 000000000..4dafab2b7 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/ru/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +Этот плагин обеспечивает доступ к некоторым элементам собственного диалогового окна пользовательского интерфейса. + +## Установка + + cordova plugin add org.apache.cordova.dialogs + + +## Методы + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +Показывает окно пользовательские оповещения или диалоговое окно. Большинство реализаций Cordova использовать диалоговое окно родной для этой функции, но некоторые платформы браузера `alert` функция, которая как правило менее настраивается. + + Navigator.Notification.Alert (сообщение, alertCallback, [название], [buttonName]) + + +* **сообщение**: сообщение диалога. *(Строка)* + +* **alertCallback**: обратного вызова для вызова, когда закрывается диалоговое окно оповещения. *(Функция)* + +* **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Alert`) + +* **buttonName**: имя кнопки. *(Строка)* (Опционально, по умолчанию`OK`) + +### Пример + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### Поддерживаемые платформы + +* Amazon Fire ОС +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 и 8 +* Windows 8 + +### Windows Phone 7 и 8 причуды + +* Существует предупреждение не встроенный браузер, но можно привязать один следующим позвонить `alert()` в глобальной области действия: + + window.alert = navigator.notification.alert; + + +* Оба `alert` и `confirm` являются не блокировка звонков, результаты которых доступны только асинхронно. + +### Firefox OS причуды: + +Как родной блокировка `window.alert()` и неблокирующий `navigator.notification.alert()` доступны. + +## navigator.notification.confirm + +Отображает диалоговое окно Настраиваемый подтверждения. + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **сообщение**: сообщение диалога. *(Строка)* + +* **confirmCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)* + +* **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Confirm`) + +* **buttonLabels**: массив строк, указав названия кнопок. *(Массив)* (Не обязательно, по умолчанию [ `OK,Cancel` ]) + +### confirmCallback + +`confirmCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне подтверждения. + +Аргументом функции обратного вызова `buttonIndex` *(номер)*, который является индекс нажатой кнопки. Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д. + +### Пример + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### Поддерживаемые платформы + +* Amazon Fire ОС +* Android +* BlackBerry 10 +* Firefox OS +* iOS +* Tizen +* Windows Phone 7 и 8 +* Windows 8 + +### Windows Phone 7 и 8 причуды + +* Нет встроенного браузера функция для `window.confirm` , но его можно привязать путем присвоения: + + window.confirm = navigator.notification.confirm; + + +* Вызовы `alert` и `confirm` являются не блокируется, поэтому результат доступен только асинхронно. + +### Firefox OS причуды: + +Как родной блокировка `window.confirm()` и неблокирующий `navigator.notification.confirm()` доступны. + +## navigator.notification.prompt + +Отображает родной диалоговое окно более настраиваемый, чем в браузере `prompt` функции. + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **сообщение**: сообщение диалога. *(Строка)* + +* **promptCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)* + +* **название**: диалоговое окно название *(String)* (опционально, по умолчанию`Prompt`) + +* **buttonLabels**: массив строк, указав кнопку этикетки *(массив)* (опционально, по умолчанию`["OK","Cancel"]`) + +* **defaultText**: по умолчанию textbox входное значение ( `String` ) (опционально, по умолчанию: пустая строка) + +### promptCallback + +`promptCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне приглашения. `results`Объект, переданный в метод обратного вызова содержит следующие свойства: + +* **buttonIndex**: индекс нажатой кнопки. *(Число)* Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д. + +* **INPUT1**: текст, введенный в диалоговом окне приглашения. *(Строка)* + +### Пример + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### Поддерживаемые платформы + +* Amazon Fire ОС +* Android +* Firefox OS +* iOS +* Windows Phone 7 и 8 + +### Android причуды + +* Android поддерживает максимум из трех кнопок и игнорирует больше, чем это. + +* На Android 3.0 и более поздних версиях кнопки отображаются в обратном порядке для устройств, которые используют тему холо. + +### Firefox OS причуды: + +Как родной блокировка `window.prompt()` и неблокирующий `navigator.notification.prompt()` доступны. + +## navigator.notification.beep + +Устройство воспроизводит звуковой сигнал звук. + + navigator.notification.beep(times); + + +* **раз**: количество раз, чтобы повторить сигнал. *(Число)* + +### Пример + + // Beep twice! + navigator.notification.beep(2); + + +### Поддерживаемые платформы + +* Amazon Fire ОС +* Android +* BlackBerry 10 +* iOS +* Tizen +* Windows Phone 7 и 8 +* Windows 8 + +### Amazon Fire OS причуды + +* Amazon Fire OS играет по умолчанию **Звук уведомления** , указанного на панели **параметров/дисплей и звук** . + +### Android причуды + +* Android играет по умолчанию **уведомления рингтон** указанных в панели **настройки/звук и дисплей** . + +### Windows Phone 7 и 8 причуды + +* Опирается на общий звуковой файл из дистрибутива Кордова. + +### Причуды Tizen + +* Tizen реализует гудков, воспроизведении аудиофайла через СМИ API. + +* Звуковой файл должен быть коротким, должен быть расположен в `sounds` подкаталог корневого каталога приложения и должны быть названы`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/doc/zh/index.md b/cordova/plugins/org.apache.cordova.dialogs/doc/zh/index.md new file mode 100644 index 000000000..f9abbb132 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/doc/zh/index.md @@ -0,0 +1,247 @@ + + +# org.apache.cordova.dialogs + +這個外掛程式提供了對一些本機對話方塊的使用者介面元素的訪問。 + +## 安裝 + + cordova plugin add org.apache.cordova.dialogs + + +## 方法 + +* `navigator.notification.alert` +* `navigator.notification.confirm` +* `navigator.notification.prompt` +* `navigator.notification.beep` + +## navigator.notification.alert + +顯示一個自訂的警報或對話方塊框。 大多數科爾多瓦實現使用本機對話方塊中的此項功能，但一些平臺使用瀏覽器的 `alert` 函數，這是通常不那麼可自訂。 + + navigator.notification.alert(message, alertCallback, [title], [buttonName]) + + +* **消息**： 消息對話方塊。*（字串）* + +* **alertCallback**： 當警報對話方塊的被解雇時要調用的回檔。*（函數）* + +* **標題**： 標題對話方塊。*（字串）*（可選，預設值為`Alert`) + +* **buttonName**： 按鈕名稱。*（字串）*（可選，預設值為`OK`) + +### 示例 + + function alertDismissed() { + // do something + } + + navigator.notification.alert( + 'You are the winner!', // message + alertDismissed, // callback + 'Game Over', // title + 'Done' // buttonName + ); + + +### 支援的平臺 + +* 亞馬遜火 OS +* Android 系統 +* 黑莓 10 +* 火狐瀏覽器作業系統 +* iOS +* Tizen +* Windows Phone 7 和 8 +* Windows 8 + +### Windows Phone 7 和 8 怪癖 + +* 有沒有內置瀏覽器警報，但你可以綁定一個，如下所示調用 `alert()` 在全球範圍內： + + window.alert = navigator.notification.alert; + + +* 兩個 `alert` 和 `confirm` 的非阻塞的調用，其中的結果才是可用的非同步。 + +### 火狐瀏覽器作業系統怪癖： + +這兩個本機阻止 `window.alert()` 和非阻塞 `navigator.notification.alert()` 可用。 + +## navigator.notification.confirm + +顯示一個可自訂的確認對話方塊。 + + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) + + +* **消息**： 消息對話方塊。*（字串）* + +* **confirmCallback**: 要用索引 （1、 2 或 3） 按下的按鈕，或者在沒有按下按鈕 (0) 駁回了對話方塊中時調用的回檔。*（函數）* + +* **標題**： 標題對話方塊。*（字串）*（可選，預設值為`Confirm`) + +* **buttonLabels**： 指定按鈕標籤的字串陣列。*（陣列）*（可選，預設值為 [ `OK,Cancel` ]) + +### confirmCallback + +`confirmCallback`當使用者按下確認對話方塊中的按鈕之一的時候執行。 + +回檔將參數 `buttonIndex` *（編號）*，它是按下的按鈕的索引。 請注意索引使用基於 1 的索引，所以值是 `1` ， `2` ， `3` ，等等。 + +### 示例 + + function onConfirm(buttonIndex) { + alert('You selected button ' + buttonIndex); + } + + navigator.notification.confirm( + 'You are the winner!', // message + onConfirm, // callback to invoke with index of button pressed + 'Game Over', // title + ['Restart','Exit'] // buttonLabels + ); + + +### 支援的平臺 + +* 亞馬遜火 OS +* Android 系統 +* 黑莓 10 +* 火狐瀏覽器作業系統 +* iOS +* Tizen +* Windows Phone 7 和 8 +* Windows 8 + +### Windows Phone 7 和 8 怪癖 + +* 有沒有內置的瀏覽器功能的 `window.confirm` ，但你可以將它綁定通過分配： + + window.confirm = navigator.notification.confirm; + + +* 調用到 `alert` 和 `confirm` 的非阻塞，所以結果就是只可用以非同步方式。 + +### 火狐瀏覽器作業系統怪癖： + +這兩個本機阻止 `window.confirm()` 和非阻塞 `navigator.notification.confirm()` 可用。 + +## navigator.notification.prompt + +顯示本機的對話方塊，更可自訂的瀏覽器比 `prompt` 函數。 + + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) + + +* **消息**： 消息對話方塊。*（字串）* + +* **promptCallback**: 要用索引 （1、 2 或 3） 按下的按鈕，或者在沒有按下按鈕 (0) 駁回了對話方塊中時調用的回檔。*（函數）* + +* **標題**： 對話方塊的標題*（字串）* （可選，預設值為`Prompt`) + +* **buttonLabels**： 陣列，這些字串指定按鈕標籤*（陣列）* （可選，預設值為`["OK","Cancel"]`) + +* **defaultText**: 預設文字方塊中輸入值 （ `String` ） （可選，預設值: 空字串） + +### promptCallback + +`promptCallback`當使用者按下一個提示對話方塊中的按鈕時執行。`results`物件傳遞給回檔的包含以下屬性： + +* **buttonIndex**： 按下的按鈕的索引。*（人數）*請注意索引使用基於 1 的索引，所以值是 `1` ， `2` ， `3` ，等等。 + +* **輸入 1**： 在提示對話方塊中輸入的文本。*（字串）* + +### 示例 + + function onPrompt(results) { + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); + } + + navigator.notification.prompt( + 'Please enter your name', // message + onPrompt, // callback to invoke + 'Registration', // title + ['Ok','Exit'], // buttonLabels + 'Jane Doe' // defaultText + ); + + +### 支援的平臺 + +* 亞馬遜火 OS +* Android 系統 +* 火狐瀏覽器作業系統 +* iOS +* Windows Phone 7 和 8 + +### Android 的怪癖 + +* Android 支援最多的三個按鈕，並忽略任何更多。 + +* 關於 Android 3.0 及更高版本，使用全息主題的設備按相反的順序顯示按鈕。 + +### 火狐瀏覽器作業系統怪癖： + +這兩個本機阻止 `window.prompt()` 和非阻塞 `navigator.notification.prompt()` 可用。 + +## navigator.notification.beep + +該設備播放提示音聲音。 + + navigator.notification.beep(times); + + +* **時間**： 的次數重複發出蜂鳴音。*（人數）* + +### 示例 + + // Beep twice! + navigator.notification.beep(2); + + +### 支援的平臺 + +* 亞馬遜火 OS +* Android 系統 +* 黑莓 10 +* iOS +* Tizen +* Windows Phone 7 和 8 +* Windows 8 + +### 亞馬遜火 OS 怪癖 + +* 亞馬遜火 OS 播放預設**設置/顯示 & 聲音**面板下指定的**通知聲音**。 + +### Android 的怪癖 + +* Android 系統播放的預設**通知鈴聲****設置/聲音和顯示**面板下指定。 + +### Windows Phone 7 和 8 怪癖 + +* 依賴泛型蜂鳴音檔從科爾多瓦分佈。 + +### Tizen 怪癖 + +* Tizen 通過播放音訊檔通過媒體 API 實現會發出蜂鳴聲。 + +* 蜂鳴音檔必須很短，必須設在 `sounds` 子目錄中的應用程式的根目錄中，並且必須命名`beep.wav`. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/package.json b/cordova/plugins/org.apache.cordova.dialogs/package.json new file mode 100644 index 000000000..c598a82b5 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/package.json @@ -0,0 +1,26 @@ +{ + "version": "0.2.10", + "name": "org.apache.cordova.dialogs", + "cordova_name": "Notification", + "description": "Cordova Notification Plugin", + "license": "Apache 2.0", + "repo": "https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git", + "issue": "https://issues.apache.org/jira/browse/CB/component/12320642", + "keywords": [ + "cordova", + "notification" + ], + "platforms": [ + "firefoxos", + "android", + "amazon-fireos", + "ubuntu", + "ios", + "blackberry10", + "wp7", + "wp8", + "windows8" + ], + "engines": [], + "englishdoc": "\n\n# org.apache.cordova.dialogs\n\nThis plugin provides access to some native dialog UI elements.\n\n## Installation\n\n cordova plugin add org.apache.cordova.dialogs\n\n## Methods\n\n- `navigator.notification.alert`\n- `navigator.notification.confirm`\n- `navigator.notification.prompt`\n- `navigator.notification.beep`\n\n## navigator.notification.alert\n\nShows a custom alert or dialog box. Most Cordova implementations use a native\ndialog box for this feature, but some platforms use the browser's `alert`\nfunction, which is typically less customizable.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n\n- __message__: Dialog message. _(String)_\n\n- __alertCallback__: Callback to invoke when alert dialog is dismissed. _(Function)_\n\n- __title__: Dialog title. _(String)_ (Optional, defaults to `Alert`)\n\n- __buttonName__: Button name. _(String)_ (Optional, defaults to `OK`)\n\n\n### Example\n\n function alertDismissed() {\n // do something\n }\n\n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- BlackBerry 10\n- Firefox OS\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows 8\n\n### Windows Phone 7 and 8 Quirks\n\n- There is no built-in browser alert, but you can bind one as follows to call `alert()` in the global scope:\n\n window.alert = navigator.notification.alert;\n\n- Both `alert` and `confirm` are non-blocking calls, results of which are only available asynchronously.\n\n### Firefox OS Quirks:\n\nBoth native-blocking `window.alert()` and non-blocking `navigator.notification.alert()` are available.\n\n## navigator.notification.confirm\n\nDisplays a customizable confirmation dialog box.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n\n- __message__: Dialog message. _(String)_\n\n- __confirmCallback__: Callback to invoke with index of button pressed (1, 2, or 3) or when the dialog is dismissed without a button press (0). _(Function)_\n\n- __title__: Dialog title. _(String)_ (Optional, defaults to `Confirm`)\n\n- __buttonLabels__: Array of strings specifying button labels. _(Array)_ (Optional, defaults to [`OK,Cancel`])\n\n\n### confirmCallback\n\nThe `confirmCallback` executes when the user presses one of the\nbuttons in the confirmation dialog box.\n\nThe callback takes the argument `buttonIndex` _(Number)_, which is the\nindex of the pressed button. Note that the index uses one-based\nindexing, so the value is `1`, `2`, `3`, etc.\n\n### Example\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n\n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- BlackBerry 10\n- Firefox OS\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows 8\n\n### Windows Phone 7 and 8 Quirks\n\n- There is no built-in browser function for `window.confirm`, but you can bind it by assigning:\n\n window.confirm = navigator.notification.confirm;\n\n- Calls to `alert` and `confirm` are non-blocking, so the result is only available asynchronously.\n\n### Firefox OS Quirks:\n\nBoth native-blocking `window.confirm()` and non-blocking `navigator.notification.confirm()` are available.\n\n## navigator.notification.prompt\n\nDisplays a native dialog box that is more customizable than the browser's `prompt` function.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n\n- __message__: Dialog message. _(String)_\n\n- __promptCallback__: Callback to invoke with index of button pressed (1, 2, or 3) or when the dialog is dismissed without a button press (0). _(Function)_\n\n- __title__: Dialog title _(String)_ (Optional, defaults to `Prompt`)\n\n- __buttonLabels__: Array of strings specifying button labels _(Array)_ (Optional, defaults to `[\"OK\",\"Cancel\"]`)\n\n- __defaultText__: Default textbox input value (`String`) (Optional, Default: empty string)\n\n### promptCallback\n\nThe `promptCallback` executes when the user presses one of the buttons\nin the prompt dialog box. The `results` object passed to the callback\ncontains the following properties:\n\n- __buttonIndex__: The index of the pressed button. _(Number)_ Note that the index uses one-based indexing, so the value is `1`, `2`, `3`, etc.\n\n\n\n- __input1__: The text entered in the prompt dialog box. _(String)_\n\n### Example\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n\n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- Firefox OS\n- iOS\n- Windows Phone 7 and 8\n\n### Android Quirks\n\n- Android supports a maximum of three buttons, and ignores any more than that.\n\n- On Android 3.0 and later, buttons are displayed in reverse order for devices that use the Holo theme.\n\n### Firefox OS Quirks:\n\nBoth native-blocking `window.prompt()` and non-blocking `navigator.notification.prompt()` are available.\n\n## navigator.notification.beep\n\nThe device plays a beep sound.\n\n navigator.notification.beep(times);\n\n- __times__: The number of times to repeat the beep. _(Number)_\n\n### Example\n\n // Beep twice!\n navigator.notification.beep(2);\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- BlackBerry 10\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows 8\n\n### Amazon Fire OS Quirks\n\n- Amazon Fire OS plays the default __Notification Sound__ specified under the __Settings/Display & Sound__ panel.\n\n### Android Quirks\n\n- Android plays the default __Notification ringtone__ specified under the __Settings/Sound & Display__ panel.\n\n### Windows Phone 7 and 8 Quirks\n\n- Relies on a generic beep file from the Cordova distribution.\n\n### Tizen Quirks\n\n- Tizen implements beeps by playing an audio file via the media API.\n\n- The beep file must be short, must be located in a `sounds` subdirectory of the application's root directory, and must be named `beep.wav`.\n\n" +} \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.dialogs/plugin.xml b/cordova/plugins/org.apache.cordova.dialogs/plugin.xml new file mode 100644 index 000000000..3aa213498 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/plugin.xml @@ -0,0 +1,157 @@ + + + +Dialog Tests
' + + 'Dialog boxes will pop up for each of the following tests
' + + ' ' + + 'Expected result: Dialog will say "You pressed alert". Press continue to close dialog. Nothing will get updated in status box.' + + ' ' + + 'Expected result: Dialog will say "You pressed confirm". Press Yes, No, or Maybe to close dialog. Status box will tell you what option you selected.' + + ' ' + + 'Expected result: Dialog will say "You pressed confirm". Press Yes, No, or Maybe, Not Sure to close dialog. Status box will tell you what option you selected.' + + ' ' + + 'Expected result: Dialog will say "You pressed prompt". Enter any message and press Yes, No, or Maybe, Not Sure to close dialog. Status box will tell you what option you selected and message you entered.' + + ' ' + + 'Expected result: Dialog will have title "index.html" and say "You pressed alert" Press OK to close dialog. Nothing will get updated in status box.' + + ' ' + + 'Expected result: Dialog will have title "index.html" and say "You selected confirm". Press Cancel or OK to close dialog. Nothing will get updated in status box.' + + ' ' + + 'Expected result: Dialog will have title "index.html" and say "This is a prompt". "Default value" will be in text box. Press Cancel or OK to close dialog. Nothing will get updated in status box.'; + + contentEl.innerHTML = '' + + dialogs_tests; + + createActionButton('Beep', function () { + beep(); + }, 'beep'); + + createActionButton('Alert Dialog', function () { + alertDialog('You pressed alert.', 'Alert Dialog', 'Continue'); + }, 'alert'); + + createActionButton('Confirm Dialog - Deprecated', function () { + confirmDialogA('You pressed confirm.', 'Confirm Dialog', 'Yes,No,Maybe'); + }, 'confirm_deprecated'); + + createActionButton('Confirm Dialog', function () { + confirmDialogB('You pressed confirm.', 'Confirm Dialog', ['Yes', 'No', 'Maybe, Not Sure']); + }, 'confirm'); + + createActionButton('Prompt Dialog', function () { + promptDialog('You pressed prompt.', 'Prompt Dialog', ['Yes', 'No', 'Maybe, Not Sure']); + }, 'prompt'); + + createActionButton('Built-in Alert Dialog', function () { + alert('You pressed alert'); + }, 'built_in_alert'); + + createActionButton('Built-in Confirm Dialog', function () { + confirm('You selected confirm'); + }, 'built_in_confirm'); + + createActionButton('Built-in Prompt Dialog', function () { + prompt('This is a prompt', 'Default value'); + }, 'built_in_prompt'); +}; diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/android/notification.js b/cordova/plugins/org.apache.cordova.dialogs/www/android/notification.js new file mode 100644 index 000000000..8936a5c20 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/www/android/notification.js @@ -0,0 +1,74 @@ +/* + * + * 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. + * +*/ + +var exec = require('cordova/exec'); + +/** + * Provides Android enhanced notification API. + */ +module.exports = { + activityStart : function(title, message) { + // If title and message not specified then mimic Android behavior of + // using default strings. + if (typeof title === "undefined" && typeof message == "undefined") { + title = "Busy"; + message = 'Please wait...'; + } + + exec(null, null, 'Notification', 'activityStart', [ title, message ]); + }, + + /** + * Close an activity dialog + */ + activityStop : function() { + exec(null, null, 'Notification', 'activityStop', []); + }, + + /** + * Display a progress dialog with progress bar that goes from 0 to 100. + * + * @param {String} + * title Title of the progress dialog. + * @param {String} + * message Message to display in the dialog. + */ + progressStart : function(title, message) { + exec(null, null, 'Notification', 'progressStart', [ title, message ]); + }, + + /** + * Close the progress dialog. + */ + progressStop : function() { + exec(null, null, 'Notification', 'progressStop', []); + }, + + /** + * Set the progress dialog value. + * + * @param {Number} + * value 0-100 + */ + progressValue : function(value) { + exec(null, null, 'Notification', 'progressValue', [ value ]); + } +}; diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/blackberry10/beep.js b/cordova/plugins/org.apache.cordova.dialogs/www/blackberry10/beep.js new file mode 100644 index 000000000..660510770 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/www/blackberry10/beep.js @@ -0,0 +1,42 @@ +/* + * + * 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. + * +*/ + +module.exports = function (quantity) { + var count = 0, + beepObj, + play = function () { + //create new object every time due to strage playback behaviour + beepObj = new Audio('local:///chrome/plugin/org.apache.cordova.dialogs/notification-beep.wav'); + beepObj.addEventListener("ended", callback); + beepObj.play(); + }, + callback = function () { + if (--count > 0) { + play(); + } else { + delete beepObj; + } + }; + count += quantity || 1; + if (count > 0) { + play(); + } +}; diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/blackberry10/notification-beep.wav b/cordova/plugins/org.apache.cordova.dialogs/www/blackberry10/notification-beep.wav new file mode 100644 index 000000000..d0ad085fe Binary files /dev/null and b/cordova/plugins/org.apache.cordova.dialogs/www/blackberry10/notification-beep.wav differ diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/danger-press.png b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/danger-press.png new file mode 100644 index 000000000..d7529b5bc Binary files /dev/null and b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/danger-press.png differ diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/danger.png b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/danger.png new file mode 100644 index 000000000..400e3ae35 Binary files /dev/null and b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/danger.png differ diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/default.png b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/default.png new file mode 100644 index 000000000..2ff298a1f Binary files /dev/null and b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/default.png differ diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/gradient.png b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/gradient.png new file mode 100644 index 000000000..b2885450b Binary files /dev/null and b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/gradient.png differ diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/notification.css b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/notification.css new file mode 100644 index 000000000..34d92b883 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/notification.css @@ -0,0 +1,248 @@ +/* + * + * 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. + * +*/ + +/* Main dialog setup */ +form[role="dialog"] { + background: + url(../img/pattern.png) repeat left top, + url(../img/gradient.png) no-repeat left top / 100% 100%; + overflow: hidden; + position: absolute; + z-index: 100; + top: 0; + left: 0; + right: 0; + bottom: 0; + padding: 1.5rem 0 7rem; + font-family: "MozTT", Sans-serif; + font-size: 0; + /* Using font-size: 0; we avoid the unwanted visual space (about 3px) + created by white-spaces and break lines in the code betewen inline-block elements */ + color: #fff; + text-align: left; +} + +form[role="dialog"]:before { + content: ""; + display: inline-block; + vertical-align: middle; + width: 0.1rem; + height: 100%; + margin-left: -0.1rem; +} + +form[role="dialog"] > section { + font-weight: lighter; + font-size: 1.8rem; + color: #FAFAFA; + padding: 0 1.5rem; + -moz-box-sizing: padding-box; + width: 100%; + display: inline-block; + overflow-y: scroll; + max-height: 100%; + vertical-align: middle; + white-space: normal; +} + +form[role="dialog"] h1 { + font-weight: normal; + font-size: 1.6rem; + line-height: 1.5em; + color: #fff; + margin: 0; + padding: 0 1.5rem 1rem; + border-bottom: 0.1rem solid #686868; +} + +/* Menu & buttons setup */ +form[role="dialog"] menu { + margin: 0; + padding: 1.5rem; + padding-bottom: 0.5rem; + border-top: solid 0.1rem rgba(255, 255, 255, 0.1); + background: #2d2d2d url(../img/pattern.png) repeat left top; + display: block; + overflow: hidden; + position: absolute; + left: 0; + right: 0; + bottom: 0; + text-align: center; +} + +form[role="dialog"] menu button::-moz-focus-inner { + border: none; + outline: none; +} +form[role="dialog"] menu button { + width: 100%; + height: 2.4rem; + margin: 0 0 1rem; + padding: 0 1.5rem; + -moz-box-sizing: border-box; + display: inline-block; + vertical-align: middle; + text-overflow: ellipsis; + white-space: nowrap; + overflow: hidden; + background: #fafafa url(../img/default.png) repeat-x left bottom/ auto 100%; + border: 0.1rem solid #a6a6a6; + border-radius: 0.3rem; + font: 500 1.2rem/2.4rem 'MozTT', Sans-serif; + color: #333; + text-align: center; + text-shadow: 0.1rem 0.1rem 0 rgba(255,255,255,0.3); + text-decoration: none; + outline: none; +} + +/* Press (default & recommend) */ +form[role="dialog"] menu button:active, +form[role="dialog"] menu button.recommend:active, +a.recommend[role="button"]:active { + border-color: #008aaa; + color: #333; +} + +/* Recommend */ +form[role="dialog"] menu button.recommend { + background-image: url(../img/recommend.png); + background-color: #00caf2; + border-color: #008eab; +} + +/* Danger */ +form[role="dialog"] menu button.danger, +a.danger[role="button"] { + background-image: url(../img/danger.png); + background-color: #b70404; + color: #fff; + text-shadow: none; + border-color: #820000; +} + +/* Danger Press */ +form[role="dialog"] menu button.danger:active { + background-image: url(../img/danger-press.png); + background-color: #890707; +} + +/* Disabled */ +form[role="dialog"] > menu > button[disabled] { + background: #5f5f5f; + color: #4d4d4d; + text-shadow: none; + border-color: #4d4d4d; + pointer-events: none; +} + + +form[role="dialog"] menu button:nth-child(even) { + margin-left: 1rem; +} + +form[role="dialog"] menu button, +form[role="dialog"] menu button:nth-child(odd) { + margin: 0 0 1rem 0; +} + +form[role="dialog"] menu button { + width: calc((100% - 1rem) / 2); +} + +form[role="dialog"] menu button.full { + width: 100%; +} + +/* Specific component code */ +form[role="dialog"] p { + word-wrap: break-word; + margin: 1rem 0 0; + padding: 0 1.5rem 1rem; + line-height: 3rem; +} + +form[role="dialog"] p img { + float: left; + margin-right: 2rem; +} + +form[role="dialog"] p strong { + font-weight: lighter; +} + +form[role="dialog"] p small { + font-size: 1.4rem; + font-weight: normal; + color: #cbcbcb; + display: block; +} + +form[role="dialog"] dl { + border-top: 0.1rem solid #686868; + margin: 1rem 0 0; + overflow: hidden; + padding-top: 1rem; + font-size: 1.6rem; + line-height: 2.2rem; +} + +form[role="dialog"] dl > dt { + clear: both; + float: left; + width: 7rem; + padding-left: 1.5rem; + font-weight: 500; + text-align: left; +} + +form[role="dialog"] dl > dd { + padding-right: 1.5rem; + font-weight: 300; + text-overflow: ellipsis; + vertical-align: top; + overflow: hidden; +} + +/* input areas */ +input[type="text"], +input[type="password"], +input[type="email"], +input[type="tel"], +input[type="search"], +input[type="url"], +input[type="number"], +textarea { + -moz-box-sizing: border-box; + display: block; + overflow: hidden; + width: 100%; + height: 3rem; + resize: none; + padding: 0 1rem; + font-size: 1.6rem; + line-height: 3rem; + border: 0.1rem solid #ccc; + border-radius: 0.3rem; + box-shadow: none; /* override the box-shadow from the system (performance issue) */ + background: #fff url(input_areas/images/ui/shadow.png) repeat-x; +} diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/pattern.png b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/pattern.png new file mode 100644 index 000000000..af03f5690 Binary files /dev/null and b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/pattern.png differ diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/recommend.png b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/recommend.png new file mode 100644 index 000000000..42aed3900 Binary files /dev/null and b/cordova/plugins/org.apache.cordova.dialogs/www/firefoxos/recommend.png differ diff --git a/cordova/plugins/org.apache.cordova.dialogs/www/notification.js b/cordova/plugins/org.apache.cordova.dialogs/www/notification.js new file mode 100644 index 000000000..6bf815c02 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.dialogs/www/notification.js @@ -0,0 +1,111 @@ +/* + * + * 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. + * +*/ + +var exec = require('cordova/exec'); +var platform = require('cordova/platform'); + +/** + * Provides access to notifications on the device. + */ + +module.exports = { + + /** + * Open a native alert dialog, with a customizable title and button text. + * + * @param {String} message Message to print in the body of the alert + * @param {Function} completeCallback The callback that is called when user clicks on a button. + * @param {String} title Title of the alert dialog (default: Alert) + * @param {String} buttonLabel Label of the close button (default: OK) + */ + alert: function(message, completeCallback, title, buttonLabel) { + var _title = (title || "Alert"); + var _buttonLabel = (buttonLabel || "OK"); + exec(completeCallback, null, "Notification", "alert", [message, _title, _buttonLabel]); + }, + + /** + * Open a native confirm dialog, with a customizable title and button text. + * The result that the user selects is returned to the result callback. + * + * @param {String} message Message to print in the body of the alert + * @param {Function} resultCallback The callback that is called when user clicks on a button. + * @param {String} title Title of the alert dialog (default: Confirm) + * @param {Array} buttonLabels Array of the labels of the buttons (default: ['OK', 'Cancel']) + */ + confirm: function(message, resultCallback, title, buttonLabels) { + var _title = (title || "Confirm"); + var _buttonLabels = (buttonLabels || ["OK", "Cancel"]); + + // Strings are deprecated! + if (typeof _buttonLabels === 'string') { + console.log("Notification.confirm(string, function, string, string) is deprecated. Use Notification.confirm(string, function, string, array)."); + } + + // Some platforms take an array of button label names. + // Other platforms take a comma separated list. + // For compatibility, we convert to the desired type based on the platform. + if (platform.id == "amazon-fireos" || platform.id == "android" || platform.id == "ios" || platform.id == "windowsphone" || platform.id == "firefoxos" || platform.id == "ubuntu") { + + if (typeof _buttonLabels === 'string') { + var buttonLabelString = _buttonLabels; + _buttonLabels = _buttonLabels.split(","); // not crazy about changing the var type here + } + } else { + if (Array.isArray(_buttonLabels)) { + var buttonLabelArray = _buttonLabels; + _buttonLabels = buttonLabelArray.toString(); + } + } + exec(resultCallback, null, "Notification", "confirm", [message, _title, _buttonLabels]); + }, + + /** + * Open a native prompt dialog, with a customizable title and button text. + * The following results are returned to the result callback: + * buttonIndex Index number of the button selected. + * input1 The text entered in the prompt dialog box. + * + * @param {String} message Dialog message to display (default: "Prompt message") + * @param {Function} resultCallback The callback that is called when user clicks on a button. + * @param {String} title Title of the dialog (default: "Prompt") + * @param {Array} buttonLabels Array of strings for the button labels (default: ["OK","Cancel"]) + * @param {String} defaultText Textbox input value (default: empty string) + */ + prompt: function(message, resultCallback, title, buttonLabels, defaultText) { + var _message = (message || "Prompt message"); + var _title = (title || "Prompt"); + var _buttonLabels = (buttonLabels || ["OK","Cancel"]); + var _defaultText = (defaultText || ""); + exec(resultCallback, null, "Notification", "prompt", [_message, _title, _buttonLabels, _defaultText]); + }, + + /** + * Causes the device to beep. + * On Android, the default notification ringtone is played "count" times. + * + * @param {Integer} count The number of beeps. + */ + beep: function(count) { + var defaultedCount = count || 1; + exec(null, null, "Notification", "beep", [ defaultedCount ]); + } +}; diff --git a/cordova/plugins/org.apache.cordova.statusbar/.fetch.json b/cordova/plugins/org.apache.cordova.statusbar/.fetch.json new file mode 100644 index 000000000..6e11994e8 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.statusbar/.fetch.json @@ -0,0 +1 @@ +{"source":{"type":"registry","id":"org.apache.cordova.statusbar"}} \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.statusbar/CONTRIBUTING.md b/cordova/plugins/org.apache.cordova.statusbar/CONTRIBUTING.md new file mode 100644 index 000000000..f7dbcaba7 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.statusbar/CONTRIBUTING.md @@ -0,0 +1,37 @@ + + +# Contributing to Apache Cordova + +Anyone can contribute to Cordova. And we need your contributions. + +There are multiple ways to contribute: report bugs, improve the docs, and +contribute code. + +For instructions on this, start with the +[contribution overview](http://cordova.apache.org/#contribute). + +The details are explained there, but the important items are: + - Sign and submit an Apache ICLA (Contributor License Agreement). + - Have a Jira issue open that corresponds to your contribution. + - Run the tests so your patch doesn't break existing functionality. + +We look forward to your contributions! diff --git a/cordova/plugins/org.apache.cordova.statusbar/LICENSE b/cordova/plugins/org.apache.cordova.statusbar/LICENSE new file mode 100644 index 000000000..7a4a3ea24 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.statusbar/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed 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. \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.statusbar/NOTICE b/cordova/plugins/org.apache.cordova.statusbar/NOTICE new file mode 100644 index 000000000..8ec56a524 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.statusbar/NOTICE @@ -0,0 +1,5 @@ +Apache Cordova +Copyright 2012 The Apache Software Foundation + +This product includes software developed at +The Apache Software Foundation (http://www.apache.org/). diff --git a/cordova/plugins/org.apache.cordova.statusbar/README.md b/cordova/plugins/org.apache.cordova.statusbar/README.md new file mode 100644 index 000000000..8b91de985 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.statusbar/README.md @@ -0,0 +1,22 @@ + + +# org.apache.cordova.statusbar + +Plugin documentation: [doc/index.md](doc/index.md) \ No newline at end of file diff --git a/cordova/plugins/org.apache.cordova.statusbar/RELEASENOTES.md b/cordova/plugins/org.apache.cordova.statusbar/RELEASENOTES.md new file mode 100644 index 000000000..49d306af8 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.statusbar/RELEASENOTES.md @@ -0,0 +1,53 @@ + +# Release Notes + +### 0.1.5 (Apr 17, 2014) (First release as a core Cordova Plugin) +* CB-6316: Added README.md which point to the new location for docs +* CB-6316: Added license header to the documentation. Added README.md which point to the new location for docs +* CB-6316: Moved StatusBar plugin documentation to docs folder +* CB-6314: [android] Add StatusBar.isVisible support to Android +* CB-6460: Update license headers + +### 0.1.6 (Jun 05, 2014) +* CB-6783 - added StatusBarStyle config preference, updated docs (closes #9) +* CB-6812 Add license +* CB-6491 add CONTRIBUTING.md +* CB-6264 minor formatting issue +* Update docs with recent WP changes, remove 'clear' from the loist of named colors in documentation +* CB-6513 - Statusbar plugin for Android is not compiling + +### 0.1.7 (Aug 06, 2014) +* Add LICENSE and NOTICE +* Update statusbar.js +* Update backgroundColorByHexString function +* ios: Use a persistent callbackId instead of calling sendJs +* CB-6626 ios: Add a JS event for tapping on statusbar +* ios: Fix hide to adjust webview's frame only when status bar is not overlaying webview +* CB-6127 Updated translations for docs +* android: Fix StatusBar.initialize() not running on UI thread + +### 0.1.8 (Sep 17, 2014) +* CB-7549 [StatusBar][iOS 8] Landscape issue +* CB-7486 Remove StatusBarBackgroundColor intial preference (black background) so background will be initially transparent +* Renamed test dir, added nested plugin.xml +* added documentation for manual tests, moved background color test below overlay test +* CB-7195 ported statusbar tests to framework diff --git a/cordova/plugins/org.apache.cordova.statusbar/doc/de/index.md b/cordova/plugins/org.apache.cordova.statusbar/doc/de/index.md new file mode 100644 index 000000000..4a8e20554 --- /dev/null +++ b/cordova/plugins/org.apache.cordova.statusbar/doc/de/index.md @@ -0,0 +1,238 @@ + + +# org.apache.cordova.statusbar + +# StatusBar + +> Das `StatusBar` Objekt stellt einige Funktionen zum Anpassen des iOS und Android StatusBar. + +## "Einstellungen" + +#### config.xml + +* **StatusBarOverlaysWebView** (Boolean, der Standardwert ist True). Stellen Sie auf iOS 7 die Statusbar-Overlay oder keine Überlagerung der WebView beim Start. + +Overlay true = status bar will lay on top of web view content
Overlay false = status bar will be separate from web view and will not cover content' + + ' ' + + 'Expected result: If overlay false, background color for status bar will be red'; + + log('StatusBar.isVisible=' + StatusBar.isVisible); + window.addEventListener('statusTap', function () { + log('tap!'); + }, false); + + createActionButton("Show", function () { + doShow(); + }, 'action-show'); + + createActionButton("Hide", function () { + doHide(); + }, 'action-hide'); + + createActionButton("Style=red (background)", function () { + doColor1(); + }, 'action-color1'); + + createActionButton("Style=translucent black", function () { + doColor2(); + }, 'action-color2'); + + createActionButton("Style=default", function () { + doColor3(); + }, 'action-color3'); + + createActionButton("Toggle Overlays", function () { + doOverlay(); + }, 'action-overlays'); +}; diff --git a/cordova/plugins/org.apache.cordova.statusbar/www/statusbar.js b/cordova/plugins/org.apache.cordova.statusbar/www/statusbar.js new file mode 100644 index 000000000..d6f68acce --- /dev/null +++ b/cordova/plugins/org.apache.cordova.statusbar/www/statusbar.js @@ -0,0 +1,109 @@ +/* + * + * 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. + * +*/ + +var exec = require('cordova/exec'); + +var namedColors = { + "black": "#000000", + "darkGray": "#A9A9A9", + "lightGray": "#D3D3D3", + "white": "#FFFFFF", + "gray": "#808080", + "red": "#FF0000", + "green": "#00FF00", + "blue": "#0000FF", + "cyan": "#00FFFF", + "yellow": "#FFFF00", + "magenta": "#FF00FF", + "orange": "##FFA500", + "purple": "#800080", + "brown": "#A52A2A" +}; + +var StatusBar = { + + isVisible: true, + + overlaysWebView: function (doOverlay) { + exec(null, null, "StatusBar", "overlaysWebView", [doOverlay]); + }, + + styleDefault: function () { + // dark text ( to be used on a light background ) + exec(null, null, "StatusBar", "styleDefault", []); + }, + + styleLightContent: function () { + // light text ( to be used on a dark background ) + exec(null, null, "StatusBar", "styleLightContent", []); + }, + + styleBlackTranslucent: function () { + // #88000000 ? Apple says to use lightContent instead + exec(null, null, "StatusBar", "styleBlackTranslucent", []); + }, + + styleBlackOpaque: function () { + // #FF000000 ? Apple says to use lightContent instead + exec(null, null, "StatusBar", "styleBlackOpaque", []); + }, + + backgroundColorByName: function (colorname) { + return StatusBar.backgroundColorByHexString(namedColors[colorname]); + }, + + backgroundColorByHexString: function (hexString) { + if (hexString.charAt(0) !== "#") { + hexString = "#" + hexString; + } + + if (hexString.length === 4) { + var split = hexString.split(""); + hexString = "#" + split[1] + split[1] + split[2] + split[2] + split[3] + split[3]; + } + + exec(null, null, "StatusBar", "backgroundColorByHexString", [hexString]); + }, + + hide: function () { + exec(null, null, "StatusBar", "hide", []); + StatusBar.isVisible = false; + }, + + show: function () { + exec(null, null, "StatusBar", "show", []); + StatusBar.isVisible = true; + } + +}; + +// prime it +exec(function (res) { + if (typeof res == 'object') { + if (res.type == 'tap') { + cordova.fireWindowEvent('statusTap'); + } + } else { + StatusBar.isVisible = res; + } +}, null, "StatusBar", "_ready", []); + +module.exports = StatusBar; diff --git a/cordova/www b/cordova/www new file mode 120000 index 000000000..1feac97f4 --- /dev/null +++ b/cordova/www @@ -0,0 +1 @@ +../demo/src/main/webapp \ No newline at end of file diff --git a/demo/.settings/.jsdtscope b/demo/.settings/.jsdtscope new file mode 100644 index 000000000..2e64ef291 --- /dev/null +++ b/demo/.settings/.jsdtscope @@ -0,0 +1,12 @@ + +
TicketMonster - a JBoss example
+ +TicketMonster is an online ticketing demo application that gets you started with JBoss technologies, and helps you learn and evaluate them.
+ +Here are a few instructions for building and running it. You can learn more about the example from the tutorial.
+ +Updating the Performance dates
+ +NOTE: This step is optional. It is necessary only if you want to update the dates of the Performances in the import.sql script in an automated manner. Updating the performance dates ensure that they are always set to some timestamp in the future, and ensures that all performances are visible in the Monitor section of the TicketMonster application.
-
+
Run the
+update_import_sqlPerl script. You’ll need theDateTime,DateTime::Format::StrptimeandTie::FilePerl modules. These are usually available by default in your Perl installation.$ perl update_import_sql.pl src/main/resources/import.sql +
+
Generating the administration site
+ +NOTE: This step is optional. The administration site is already present in the source code. If you want to regenerate it from Forge, and apply the changes outlined in the tutorial, you may continue to follow the steps outlined here. Otherwise, you can skip this step and proceed to build TicketMonster.
+ +Before building and running TicketMonster, you must generate the administration site with Forge.
+ +-
+
Ensure that you have JBoss Forge installed. The current version of TicketMonster supports version 2.6.0.Final or higher of JBoss Forge. JBoss Developer Studio 8 is recommended, since it contains JBoss Forge 2 with all the necessary plugins for the TicketMonster app.
+Start the JBoss Forge console in JBoss Developer Studio. This can be done from the Forge Console view. If the view is not already visible, it can be opened through the ‘Window’ menu: Window -> Show View -> Other…. Select the ‘Forge Console’ item in the dialog to open the Forge Console. Click the Start button in the Forge Console tab, to start Forge.
+From the JBoss Forge prompt, browse to the ‘demo’ directory of the TicketMonster sources and execute the script for generating the administration site
++$ cd ticket-monster/demo +$ run admin_layer.fsh +
The git patches need to be applied manually. Both the patches are located in the patches sub-directory. To apply the manual changes, first apply the patch located in file admin_layer_functional.patch. Then perform the same for the file admin_layer_graphics.patch if you want to apply the style changes for the generated administration site. You can do so in JBoss Developer Studio, by opening the context-menu on the project (Right-click on the project) and then apply a git patch via Team -> Apply Patch…. Locate the patch file in the Workspace, select it and click the ‘Next’ button. In the next dialog, select to apply the patch on the ‘ticket-monster’ project in the workspace. Click Finish in the final page of the wizard after satisfying that the patch applies cleanly.
+Deployment to JBoss EAP 6.3 is optional. The project can be built and deployed to a running instance of JBoss EAP through the following command in JBoss Forge:
+$ build clean package jboss-as:deploy +
+
Building TicketMonster
+ +TicketMonster can be built from Maven, by runnning the following Maven command:
+mvn clean package
+Building TicketMonster with tests
+ +If you want to run the Arquillian tests as part of the build, you can enable one of the two available Arquillian profiles.
+ +For running the tests in an already running application server instance, use the arq-jbossas-remote profile.
mvn clean package -Parq-jbossas-remote
+If you want the test runner to start an application server instance, use the arq-jbossas-managed profile. You must set up the JBOSS_HOME property to point to the server location, or update the src/main/test/resources/arquillian.xml file.
mvn clean package -Parq-jbossas-managed
+Building TicketMonster with Postgresql (for OpenShift)
+ +If you intend to deploy into OpenShift, you can use the postgresql-openshift profile
mvn clean package -Ppostgresql-openshift
+Building TicketMonster with MySQL (for OpenShift)
+ +If you intend to deploy into OpenShift, you can use the mysql-openshift profile
mvn clean package -Pmysql-openshift
+Running TicketMonster
+ +You can run TicketMonster into a local JBoss EAP 6.3 instance or on OpenShift.
+ +Running TicketMonster locally
+ +Start JBoss Enterprise Application Platform 6.3
+ +-
+
- Open a command line and navigate to the root of the JBoss server directory. +
The following shows the command line to start the server with the web profile:
+For Linux: JBOSS_HOME/bin/standalone.sh +For Windows: JBOSS_HOME\bin\standalone.bat +
+
Deploy TicketMonster
+ +-
+
- Make sure you have started the JBoss Server as described above. +
Type this command to build and deploy the archive into a running server instance.
++mvn clean package jboss-as:deploy +
(You can use the
arq-jbossas-remoteprofile for running tests as well)
+This will deploy
target/ticket-monster.warto the running instance of the server.
+Now you can see the application running at
http://localhost:8080/ticket-monster
+
Running TicketMonster in OpenShift
+ +Create an OpenShift project
+ +++ +The following variables are used in these instructions. Be sure to replace them as follows: +* APP_NAME should be replaced with the name of the application you create on OpenShift. +* YOUR_DOMAIN_NAME should be replaced with the OpenShift domain name. +* APPLICATION_UUID should be replaced with the UUID generated by OpenShift for your application, for example: 52864af85973ca430200006f +* TICKETMONSTER_MAVEN_PROJECT_ROOT is the location of the Maven project sources for the TicketMonster application.
+
-
+
Open a shell command prompt and change to a directory of your choice. Enter the following command to create a JBoss EAP 6 application:
+rhc app create -a APP_NAME -t jbosseap-6 +
+
This command creates an OpenShift application named APP_NAME and will run the application inside the jbosseap-6 container. You should see some output similar to the following:
+ Application Options
+ -------------------
+ Domain: YOUR_DOMAIN
+ Cartridges: jbosseap-6 (addtl. costs may apply)
+ Gear Size: default
+ Scaling: no
+
+ Creating application 'APP_NAME' ... done
+
+
+ Waiting for your DNS name to be available ... done
+
+ Cloning into 'APP_NAME'...
+ Warning: Permanently added the RSA host key for IP address '54.90.10.115' to the list of known hosts.
+
+ Your application 'APP_NAME' is now available.
+
+ URL: http://APP_NAME-YOUR_DOMAIN.rhcloud.com/
+ SSH to: APPLICATION_UUID@APP_NAME-YOURDOMAIN.rhcloud.com
+ Git remote: ssh://APPLICATION_UUID@APP_NAME-YOUR_DOMAIN.rhcloud.com/~/git/APP_NAME.git/
+ Cloned to: /Users/vineet/openshiftapps/APP_NAME
+
+ Run 'rhc show-app APP_NAME' for more details about your app.
+-
+
- The create command creates a git repository in the current directory with the same name as the application. +
You do not need the generated default application, so navigate to the new git repository directory created by the OpenShift command and tell git to remove the source and pom files:
+ cd APP_NAME
+ git rm -r src pom.xml
+-
+
Copy the TicketMonster application sources into this new git repository:
+cp -r TICKETMONSTER_MAVEN_PROJECT_ROOT/src . +cp -r TICKETMONSTER_MAVEN_PROJECT_ROOT/pom.xml . +
+
Use MySQL as the database
+ +-
+
Add the MySQL 5.5 cartridge to the
+ticketmonsterapplication:rhc cartridge add mysql-5.5 -a ticketmonster +
+Configure the OpenShift build process, to use the
+mysql-openshiftprofile within the project POM. To do so, create a file namedpre_build_jbosseapunder the.openshift/action_hooksdirectory located in the git repository of the OpenShift application, with the following contents:export MAVEN_ARGS="clean package -Popenshift,mysql-openshift -DskipTests" +
+Set the executable bit for the action hook:
+chmod +x TICKET_MONSTER_OPENSHIFT_GIT_REPO/.openshift/build_hooks/pre_build_jbosseap +
+
On Windows, you will need to run the following command to set the executable bit to the pre_build_jbosseap file:
git update-index --chmod=+x .openshift/build_hooks/pre_build_jbosseap
+Use PostgreSQL as the database
+ +-
+
Add the PostgreSQL 9.2 cartridge to the
+ticketmonsterapplication:rhc cartridge add postgresql-9.2 -a ticketmonster +
+Configure the OpenShift build process, to use the
+postgresql-openshiftprofile within the project POM. To do so, create a file namedpre_build_jbosseapunder the.openshift/action_hooksdirectory located in the git repository of the OpenShift application, with the following contents:export MAVEN_ARGS="clean package -Popenshift,postgresql-openshift -DskipTests" +
+Set the executable bit for the action hook:
+chmod +x TICKET_MONSTER_OPENSHIFT_GIT_REPO/.openshift/build_hooks/pre_build_jbosseap +
+
On Windows, you will need to run the following command to set the executable bit to the pre_build_jbosseap file:
git update-index --chmod=+x .openshift/build_hooks/pre_build_jbosseap
+Deploying to OpenShift
+ +-
+
You can now deploy the changes to your OpenShift application using git as follows:
+git add -A +git commit -m "TicketMonster on OpenShift" +git push +
+
The final push command triggers the OpenShift infrastructure to build and deploy the changes.
+ +Note that the openshift profile in pom.xml is activated by OpenShift, and causes the WAR build by OpenShift to be copied to the deployments/ directory, and deployed without a context path.
Now you can see the application running at http://APP_NAME-YOUR_DOMAIN.rhcloud.com/.
+ diff --git a/demo/README.md b/demo/README.md new file mode 100644 index 000000000..c08d50ec4 --- /dev/null +++ b/demo/README.md @@ -0,0 +1,192 @@ +# TicketMonster - a JBoss example + +TicketMonster is an online ticketing demo application that gets you started with JBoss technologies, and helps you learn and evaluate them. + +Here are a few instructions for building and running it. You can learn more about the example from the [tutorial](http://www.jboss.org/ticket-monster). + +## Updating the Performance dates + +_NOTE: This step is optional. It is necessary only if you want to update the dates of the Performances in the `import.sql` script in an automated manner. Updating the performance dates ensure that they are always set to some timestamp in the future, and ensures that all performances are visible in the Monitor section of the TicketMonster application._ + +1. Run the `update_import_sql` Perl script. You'll need the `DateTime`, `DateTime::Format::Strptime` and `Tie::File` Perl modules. These are usually available by default in your Perl installation. + + $ perl update_import_sql.pl src/main/resources/import.sql + +## Generating the administration site + +_NOTE: This step is optional. The administration site is already present in the source code. If you want to regenerate it from Forge, and apply the changes outlined in the tutorial, you may continue to follow the steps outlined here. Otherwise, you can skip this step and proceed to build TicketMonster._ + +Before building and running TicketMonster, you must generate the administration site with Forge. + +1. Ensure that you have [JBoss Forge](http://jboss.org/forge) installed. The current version of TicketMonster supports version 2.6.0.Final or higher of JBoss Forge. JBoss Developer Studio 8 is recommended, since it contains JBoss Forge 2 with all the necessary plugins for the TicketMonster app. + +2. Start the JBoss Forge console in JBoss Developer Studio. This can be done from the Forge Console view. If the view is not already visible, it can be opened through the 'Window' menu: _Window_ -> _Show View_ -> _Other..._. Select the 'Forge Console' item in the dialog to open the Forge Console. Click the _Start_ button in the Forge Console tab, to start Forge. + +3. From the JBoss Forge prompt, browse to the 'demo' directory of the TicketMonster sources and execute the script for generating the administration site + + $ cd ticket-monster/demo + $ run admin_layer.fsh + + The git patches need to be applied manually. Both the patches are located in the patches sub-directory. To apply the manual changes, first apply the patch located in file _admin_layer_functional.patch_. Then perform the same for the file _admin_layer_graphics.patch_ if you want to apply the style changes for the generated administration site. You can do so in JBoss Developer Studio, by opening the context-menu on the project (Right-click on the project) and then apply a git patch via _Team_ -> _Apply Patch..._. Locate the patch file in the Workspace, select it and click the 'Next' button. In the next dialog, select to apply the patch on the 'ticket-monster' project in the workspace. Click Finish in the final page of the wizard after satisfying that the patch applies cleanly. + +4. Deployment to JBoss EAP 6.3 is optional. The project can be built and deployed to a running instance of JBoss EAP through the following command in JBoss Forge: + + $ build clean package jboss-as:deploy + +## Building TicketMonster + +TicketMonster can be built from Maven, by runnning the following Maven command: + + mvn clean package + +### Building TicketMonster with tests + +If you want to run the Arquillian tests as part of the build, you can enable one of the two available Arquillian profiles. + +For running the tests in an _already running_ application server instance, use the `arq-jbossas-remote` profile. + + mvn clean package -Parq-jbossas-remote + +If you want the test runner to _start_ an application server instance, use the `arq-jbossas-managed` profile. You must set up the `JBOSS_HOME` property to point to the server location, or update the `src/main/test/resources/arquillian.xml` file. + + mvn clean package -Parq-jbossas-managed + +### Building TicketMonster with Postgresql (for OpenShift) + +If you intend to deploy into [OpenShift](http://openshift.com), you can use the `postgresql-openshift` profile + + mvn clean package -Ppostgresql-openshift + +### Building TicketMonster with MySQL (for OpenShift) + +If you intend to deploy into [OpenShift](http://openshift.com), you can use the `mysql-openshift` profile + + mvn clean package -Pmysql-openshift + +## Running TicketMonster + +You can run TicketMonster into a local JBoss EAP 6.3 instance or on OpenShift. + +### Running TicketMonster locally + +#### Start JBoss Enterprise Application Platform 6.3 + +1. Open a command line and navigate to the root of the JBoss server directory. +2. The following shows the command line to start the server with the web profile: + + For Linux: JBOSS_HOME/bin/standalone.sh + For Windows: JBOSS_HOME\bin\standalone.bat + +#### Deploy TicketMonster + +1. Make sure you have started the JBoss Server as described above. +2. Type this command to build and deploy the archive into a running server instance. + + mvn clean package jboss-as:deploy + + (You can use the `arq-jbossas-remote` profile for running tests as well) + +3. This will deploy `target/ticket-monster.war` to the running instance of the server. +4. Now you can see the application running at `http://localhost:8080/ticket-monster` + +### Running TicketMonster in OpenShift + +#### Create an OpenShift project + +> The following variables are used in these instructions. Be sure to replace them as follows: +* APP_NAME should be replaced with the name of the application you create on OpenShift. +* YOUR_DOMAIN_NAME should be replaced with the OpenShift domain name. +* APPLICATION_UUID should be replaced with the UUID generated by OpenShift for your application, for example: 52864af85973ca430200006f +* TICKETMONSTER_MAVEN_PROJECT_ROOT is the location of the Maven project sources for the TicketMonster application. + +1. Open a shell command prompt and change to a directory of your choice. Enter the following command to create a JBoss EAP 6 application: + + rhc app create -a APP_NAME -t jbosseap-6 + + This command creates an OpenShift application named APP_NAME and will run the application inside the jbosseap-6 container. You should see some output similar to the following: + + Application Options + ------------------- + Domain: YOUR_DOMAIN + Cartridges: jbosseap-6 (addtl. costs may apply) + Gear Size: default + Scaling: no + + Creating application 'APP_NAME' ... done + + + Waiting for your DNS name to be available ... done + + Cloning into 'APP_NAME'... + Warning: Permanently added the RSA host key for IP address '54.90.10.115' to the list of known hosts. + + Your application 'APP_NAME' is now available. + + URL: http://APP_NAME-YOUR_DOMAIN.rhcloud.com/ + SSH to: APPLICATION_UUID@APP_NAME-YOURDOMAIN.rhcloud.com + Git remote: ssh://APPLICATION_UUID@APP_NAME-YOUR_DOMAIN.rhcloud.com/~/git/APP_NAME.git/ + Cloned to: /Users/vineet/openshiftapps/APP_NAME + + Run 'rhc show-app APP_NAME' for more details about your app. + +2. The create command creates a git repository in the current directory with the same name as the application. + + You do not need the generated default application, so navigate to the new git repository directory created by the OpenShift command and tell git to remove the source and pom files: + + cd APP_NAME + git rm -r src pom.xml + +3. Copy the TicketMonster application sources into this new git repository: + + cp -r TICKETMONSTER_MAVEN_PROJECT_ROOT/src . + cp -r TICKETMONSTER_MAVEN_PROJECT_ROOT/pom.xml . + +#### Use MySQL as the database + +1. Add the MySQL 5.5 cartridge to the `ticketmonster` application: + + rhc cartridge add mysql-5.5 -a ticketmonster + +2. Configure the OpenShift build process, to use the `mysql-openshift` profile within the project POM. To do so, create a file named `pre_build_jbosseap` under the `.openshift/action_hooks` directory located in the git repository of the OpenShift application, with the following contents: + + export MAVEN_ARGS="clean package -Popenshift,mysql-openshift -DskipTests" + +3. Set the executable bit for the action hook: + + chmod +x TICKET_MONSTER_OPENSHIFT_GIT_REPO/.openshift/build_hooks/pre_build_jbosseap + + On Windows, you will need to run the following command to set the executable bit to the `pre_build_jbosseap` file: + + git update-index --chmod=+x .openshift/build_hooks/pre_build_jbosseap + +#### Use PostgreSQL as the database + +1. Add the PostgreSQL 9.2 cartridge to the `ticketmonster` application: + + rhc cartridge add postgresql-9.2 -a ticketmonster + +2. Configure the OpenShift build process, to use the `postgresql-openshift` profile within the project POM. To do so, create a file named `pre_build_jbosseap` under the `.openshift/action_hooks` directory located in the git repository of the OpenShift application, with the following contents: + + export MAVEN_ARGS="clean package -Popenshift,postgresql-openshift -DskipTests" + +3. Set the executable bit for the action hook: + + chmod +x TICKET_MONSTER_OPENSHIFT_GIT_REPO/.openshift/build_hooks/pre_build_jbosseap + + On Windows, you will need to run the following command to set the executable bit to the `pre_build_jbosseap` file: + + git update-index --chmod=+x .openshift/build_hooks/pre_build_jbosseap + +#### Deploying to OpenShift + +1. You can now deploy the changes to your OpenShift application using git as follows: + + git add -A + git commit -m "TicketMonster on OpenShift" + git push + + The final push command triggers the OpenShift infrastructure to build and deploy the changes. + + Note that the `openshift` profile in pom.xml is activated by OpenShift, and causes the WAR build by OpenShift to be copied to the deployments/ directory, and deployed without a context path. + + Now you can see the application running at http://APP_NAME-YOUR_DOMAIN.rhcloud.com/. diff --git a/demo/admin_layer.fsh b/demo/admin_layer.fsh new file mode 100644 index 000000000..51b769fea --- /dev/null +++ b/demo/admin_layer.fsh @@ -0,0 +1,11 @@ +clear; + +echo "Generating the scaffold."; +scaffold-generate --provider AngularJS --webRoot /admin --targets org.jboss.examples.ticketmonster.model.* --generator ROOT_AND_NESTED_DTO --packageName org.jboss.examples.ticketmonster.rest; + +echo "Don't forget to apply the manual changes described in tutorial provided in admin_layer_functional.patch and admin_layer_graphics.patch. Both files are in the patches sub-directory."; + +echo "To build and deploy the application to JBoss EAP, run the following command:" +echo " build clean package jboss-as:deploy"; + +echo "Examine the app deployed at http://localhost:8080/ticket-monster/admin/index.html"; diff --git a/demo/patches/admin_layer_functional.patch b/demo/patches/admin_layer_functional.patch new file mode 100644 index 000000000..f71ac7107 --- /dev/null +++ b/demo/patches/admin_layer_functional.patch @@ -0,0 +1,996 @@ +diff --git ./src/main/java/org/jboss/examples/ticketmonster/rest/PerformanceEndpoint.java ./src/main/java/org/jboss/examples/ticketmonster/rest/PerformanceEndpoint.java +index 4d5c0b3..3f0e6ba 100644 +--- ./src/main/java/org/jboss/examples/ticketmonster/rest/PerformanceEndpoint.java ++++ ./src/main/java/org/jboss/examples/ticketmonster/rest/PerformanceEndpoint.java +@@ -9,6 +9,10 @@ import javax.persistence.NoResultException; + import javax.persistence.OptimisticLockException; + import javax.persistence.PersistenceContext; + import javax.persistence.TypedQuery; ++import javax.persistence.criteria.CriteriaBuilder; ++import javax.persistence.criteria.CriteriaQuery; ++import javax.persistence.criteria.Predicate; ++import javax.persistence.criteria.Root; + import javax.ws.rs.Consumes; + import javax.ws.rs.DELETE; + import javax.ws.rs.GET; +@@ -21,8 +25,12 @@ import javax.ws.rs.QueryParam; + import javax.ws.rs.core.Response; + import javax.ws.rs.core.Response.Status; + import javax.ws.rs.core.UriBuilder; ++ + import org.jboss.examples.ticketmonster.rest.dto.PerformanceDTO; ++import org.jboss.examples.ticketmonster.model.Booking; + import org.jboss.examples.ticketmonster.model.Performance; ++import org.jboss.examples.ticketmonster.model.SectionAllocation; ++import org.jboss.examples.ticketmonster.model.Show; + + /** + * +@@ -52,6 +60,18 @@ public class PerformanceEndpoint + { + return Response.status(Status.NOT_FOUND).build(); + } ++ Show show = entity.getShow(); ++ show.getPerformances().remove(entity); ++ entity.setShow(null); ++ this.em.merge(show); ++ List
+
+
+\ No newline at end of file
++
+diff --git ./src/main/webapp/admin/views/Event/detail.html ./src/main/webapp/admin/views/Event/detail.html
+index 78d55b3..4da1871 100644
+--- ./src/main/webapp/admin/views/Event/detail.html
++++ ./src/main/webapp/admin/views/Event/detail.html
+@@ -23,6 +23,8 @@
+
++
+-
+@@ -87,4 +87,4 @@
+
+
+
+-++
+
+
+ {{result.name}}
+- {{result.mediaItem.mediaType}}
++ {{result.mediaItem.url}}
+ {{result.category.description}}
+ {{result.description}}
+
+@@ -85,4 +85,4 @@
+
+
+
+-
+\ No newline at end of file
++
+diff --git ./src/main/webapp/admin/views/Performance/search.html ./src/main/webapp/admin/views/Performance/search.html
+index ef13770..b315edf 100644
+--- ./src/main/webapp/admin/views/Performance/search.html
++++ ./src/main/webapp/admin/views/Performance/search.html
+@@ -14,7 +14,7 @@
+
+-
+@@ -65,7 +65,7 @@
+
+
+
+
+- {{result.show.id}}
++ {{result.show.displayTitle}}
+ {{result.date| date:'yyyy-MM-dd HH:mm:ss Z'}}
+
+
+@@ -59,4 +59,4 @@
+
+
+
+-
+\ No newline at end of file
++
+diff --git ./src/main/webapp/admin/views/SectionAllocation/search.html ./src/main/webapp/admin/views/SectionAllocation/search.html
+index 820fdd5..b813ea8 100644
+--- ./src/main/webapp/admin/views/SectionAllocation/search.html
++++ ./src/main/webapp/admin/views/SectionAllocation/search.html
+@@ -20,7 +20,7 @@
+
+-
+@@ -40,7 +40,7 @@
+
+
+
+
+
+ {{result.occupiedCount}}
+- {{result.performance.date| date:'medium'}}
++ {{result.performance.displayTitle}}
+ {{result.section.name}}
+
+
+@@ -76,4 +76,4 @@
+
+
+
+-
+\ No newline at end of file
++
+diff --git ./src/main/webapp/admin/views/TicketPrice/search.html ./src/main/webapp/admin/views/TicketPrice/search.html
+index 2bf2648..4345e63 100644
+--- ./src/main/webapp/admin/views/TicketPrice/search.html
++++ ./src/main/webapp/admin/views/TicketPrice/search.html
+@@ -14,7 +14,7 @@
+
+-
+@@ -57,7 +57,7 @@
+
+
+
+
+- {{result.show.id}}
++ {{result.show.displayTitle}}
+ {{result.section.name}}
+ {{result.ticketCategory.description}}
+ {{result.price}}
+@@ -87,4 +87,4 @@
+
+
+
+-
+\ No newline at end of file
++
+diff --git ./src/main/webapp/admin/views/Venue/detail.html ./src/main/webapp/admin/views/Venue/detail.html
+index 5bb6383..77904e1 100644
+--- ./src/main/webapp/admin/views/Venue/detail.html
++++ ./src/main/webapp/admin/views/Venue/detail.html
+@@ -20,6 +20,8 @@
+
++
++![]()
+
+
+
+@@ -76,4 +78,4 @@
+
+
+
+-
+\ No newline at end of file
++
+diff --git ./src/main/webapp/admin/views/Venue/search.html ./src/main/webapp/admin/views/Venue/search.html
+index 57bc1ff..ff04b44 100644
+--- ./src/main/webapp/admin/views/Venue/search.html
++++ ./src/main/webapp/admin/views/Venue/search.html
+@@ -21,7 +21,7 @@
+
+-
+@@ -66,7 +66,7 @@
+
+
+ ++
+
+
+ {{result.name}}
+- {{result.mediaItem.mediaType}}
++ {{result.mediaItem.url}}
+ {{result.description}}
+ {{result.capacity}}
+ {{result.address.street}}
+@@ -111,4 +111,4 @@
+
+
+
+-
+\ No newline at end of file
++
diff --git a/demo/patches/admin_layer_graphics.patch b/demo/patches/admin_layer_graphics.patch
new file mode 100644
index 000000000..19a43970a
--- /dev/null
+++ b/demo/patches/admin_layer_graphics.patch
@@ -0,0 +1,61 @@
+diff --git ./src/main/webapp/admin/app.html ./src/main/webapp/admin/app.html
+index 2e27e40..4e1f843 100644
+--- ./src/main/webapp/admin/app.html
++++ ./src/main/webapp/admin/app.html
+@@ -4,25 +4,37 @@
+
+
+ Ticket-monster
++
+
+
+
++
+
+
+
+-
+@@ -88,7 +88,7 @@
+
+
+
+-