michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.dialogs
michael@0: 
michael@0: Этот плагин обеспечивает доступ к некоторым элементам собственного диалогового окна пользовательского интерфейса.
michael@0: 
michael@0: ## Установка
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.dialogs
michael@0:     
michael@0: 
michael@0: ## Методы
michael@0: 
michael@0: *   `navigator.notification.alert`
michael@0: *   `navigator.notification.confirm`
michael@0: *   `navigator.notification.prompt`
michael@0: *   `navigator.notification.beep`
michael@0: 
michael@0: ## navigator.notification.alert
michael@0: 
michael@0: Показывает окно пользовательские оповещения или диалоговое окно. Большинство реализаций Cordova использовать диалоговое окно родной для этой функции, но некоторые платформы браузера `alert` функция, которая как правило менее настраивается.
michael@0: 
michael@0:     Navigator.Notification.Alert (сообщение, alertCallback, [название], [buttonName])
michael@0:     
michael@0: 
michael@0: *   **сообщение**: сообщение диалога. *(Строка)*
michael@0: 
michael@0: *   **alertCallback**: обратного вызова для вызова, когда закрывается диалоговое окно оповещения. *(Функция)*
michael@0: 
michael@0: *   **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Alert`)
michael@0: 
michael@0: *   **buttonName**: имя кнопки. *(Строка)* (Опционально, по умолчанию`OK`)
michael@0: 
michael@0: ### Пример
michael@0: 
michael@0:     function alertDismissed() {
michael@0:         // do something
michael@0:     }
michael@0:     
michael@0:     navigator.notification.alert(
michael@0:         'You are the winner!',  // message
michael@0:         alertDismissed,         // callback
michael@0:         'Game Over',            // title
michael@0:         'Done'                  // buttonName
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 и 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Особенности Windows Phone 7 и 8
michael@0: 
michael@0: *   Существует предупреждение не встроенный браузер, но можно привязать один следующим позвонить `alert()` в глобальной области действия:
michael@0:     
michael@0:         window.alert = navigator.notification.alert;
michael@0:         
michael@0: 
michael@0: *   Оба `alert` и `confirm` являются не блокировка звонков, результаты которых доступны только асинхронно.
michael@0: 
michael@0: ### Firefox OS причуды:
michael@0: 
michael@0: Как родной блокировка `window.alert()` и неблокирующий `navigator.notification.alert()` доступны.
michael@0: 
michael@0: ## navigator.notification.confirm
michael@0: 
michael@0: Отображает диалоговое окно Настраиваемый подтверждения.
michael@0: 
michael@0:     navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
michael@0:     
michael@0: 
michael@0: *   **сообщение**: сообщение диалога. *(Строка)*
michael@0: 
michael@0: *   **confirmCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)*
michael@0: 
michael@0: *   **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Confirm`)
michael@0: 
michael@0: *   **buttonLabels**: массив строк, указав названия кнопок. *(Массив)* (Не обязательно, по умолчанию [ `OK,Cancel` ])
michael@0: 
michael@0: ### confirmCallback
michael@0: 
michael@0: `confirmCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне подтверждения.
michael@0: 
michael@0: Аргументом функции обратного вызова `buttonIndex` *(номер)*, который является индекс нажатой кнопки. Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д.
michael@0: 
michael@0: ### Пример
michael@0: 
michael@0:     function onConfirm(buttonIndex) {
michael@0:         alert('You selected button ' + buttonIndex);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.confirm(
michael@0:         'You are the winner!', // message
michael@0:          onConfirm,            // callback to invoke with index of button pressed
michael@0:         'Game Over',           // title
michael@0:         ['Restart','Exit']     // buttonLabels
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 и 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Особенности Windows Phone 7 и 8
michael@0: 
michael@0: *   Нет встроенного браузера функция для `window.confirm` , но его можно привязать путем присвоения:
michael@0:     
michael@0:         window.confirm = navigator.notification.confirm;
michael@0:         
michael@0: 
michael@0: *   Вызовы `alert` и `confirm` являются не блокируется, поэтому результат доступен только асинхронно.
michael@0: 
michael@0: ### Firefox OS причуды:
michael@0: 
michael@0: Как родной блокировка `window.confirm()` и неблокирующий `navigator.notification.confirm()` доступны.
michael@0: 
michael@0: ## navigator.notification.prompt
michael@0: 
michael@0: Отображает родной диалоговое окно более настраиваемый, чем в браузере `prompt` функции.
michael@0: 
michael@0:     navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
michael@0:     
michael@0: 
michael@0: *   **сообщение**: сообщение диалога. *(Строка)*
michael@0: 
michael@0: *   **promptCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)*
michael@0: 
michael@0: *   **название**: диалоговое окно название *(String)* (опционально, по умолчанию`Prompt`)
michael@0: 
michael@0: *   **buttonLabels**: массив строк, указав кнопку этикетки *(массив)* (опционально, по умолчанию`["OK","Cancel"]`)
michael@0: 
michael@0: *   **defaultText**: по умолчанию textbox входное значение ( `String` ) (опционально, по умолчанию: пустая строка)
michael@0: 
michael@0: ### promptCallback
michael@0: 
michael@0: `promptCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне приглашения. `results`Объект, переданный в метод обратного вызова содержит следующие свойства:
michael@0: 
michael@0: *   **buttonIndex**: индекс нажатой кнопки. *(Число)* Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д.
michael@0: 
michael@0: *   **INPUT1**: текст, введенный в диалоговом окне приглашения. *(Строка)*
michael@0: 
michael@0: ### Пример
michael@0: 
michael@0:     function onPrompt(results) {
michael@0:         alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.prompt(
michael@0:         'Please enter your name',  // message
michael@0:         onPrompt,                  // callback to invoke
michael@0:         'Registration',            // title
michael@0:         ['Ok','Exit'],             // buttonLabels
michael@0:         'Jane Doe'                 // defaultText
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Windows Phone 7 и 8
michael@0: 
michael@0: ### Особенности Android
michael@0: 
michael@0: *   Android поддерживает максимум из трех кнопок и игнорирует больше, чем это.
michael@0: 
michael@0: *   На Android 3.0 и более поздних версиях кнопки отображаются в обратном порядке для устройств, которые используют тему холо.
michael@0: 
michael@0: ### Firefox OS причуды:
michael@0: 
michael@0: Как родной блокировка `window.prompt()` и неблокирующий `navigator.notification.prompt()` доступны.
michael@0: 
michael@0: ## navigator.notification.beep
michael@0: 
michael@0: Устройство воспроизводит звуковой сигнал звук.
michael@0: 
michael@0:     navigator.notification.beep(times);
michael@0:     
michael@0: 
michael@0: *   **раз**: количество раз, чтобы повторить сигнал. *(Число)*
michael@0: 
michael@0: ### Пример
michael@0: 
michael@0:     // Beep twice!
michael@0:     navigator.notification.beep(2);
michael@0:     
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 и 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Особенности Amazon Fire OS
michael@0: 
michael@0: *   Amazon Fire OS играет по умолчанию **Звук уведомления** , указанного на панели **параметров/дисплей и звук** .
michael@0: 
michael@0: ### Особенности Android
michael@0: 
michael@0: *   Android играет по умолчанию **уведомления рингтон** указанных в панели **настройки/звук и дисплей** .
michael@0: 
michael@0: ### Особенности Windows Phone 7 и 8
michael@0: 
michael@0: *   Опирается на общий звуковой файл из дистрибутива Кордова.
michael@0: 
michael@0: ### Особенности Tizen
michael@0: 
michael@0: *   Tizen реализует гудков, воспроизведении аудиофайла через СМИ API.
michael@0: 
michael@0: *   Звуковой файл должен быть коротким, должен быть расположен в `sounds` подкаталог корневого каталога приложения и должны быть названы`beep.wav`.