1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/Touchgui/plugins/org.apache.cordova.dialogs/doc/ru/index.md Thu Jun 04 14:50:33 2015 +0200
1.3 @@ -0,0 +1,247 @@
1.4 +<!---
1.5 + Licensed to the Apache Software Foundation (ASF) under one
1.6 + or more contributor license agreements. See the NOTICE file
1.7 + distributed with this work for additional information
1.8 + regarding copyright ownership. The ASF licenses this file
1.9 + to you under the Apache License, Version 2.0 (the
1.10 + "License"); you may not use this file except in compliance
1.11 + with the License. You may obtain a copy of the License at
1.12 +
1.13 + http://www.apache.org/licenses/LICENSE-2.0
1.14 +
1.15 + Unless required by applicable law or agreed to in writing,
1.16 + software distributed under the License is distributed on an
1.17 + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
1.18 + KIND, either express or implied. See the License for the
1.19 + specific language governing permissions and limitations
1.20 + under the License.
1.21 +-->
1.22 +
1.23 +# org.apache.cordova.dialogs
1.24 +
1.25 +Этот плагин обеспечивает доступ к некоторым элементам собственного диалогового окна пользовательского интерфейса.
1.26 +
1.27 +## Установка
1.28 +
1.29 + cordova plugin add org.apache.cordova.dialogs
1.30 +
1.31 +
1.32 +## Методы
1.33 +
1.34 +* `navigator.notification.alert`
1.35 +* `navigator.notification.confirm`
1.36 +* `navigator.notification.prompt`
1.37 +* `navigator.notification.beep`
1.38 +
1.39 +## navigator.notification.alert
1.40 +
1.41 +Показывает окно пользовательские оповещения или диалоговое окно. Большинство реализаций Cordova использовать диалоговое окно родной для этой функции, но некоторые платформы браузера `alert` функция, которая как правило менее настраивается.
1.42 +
1.43 + Navigator.Notification.Alert (сообщение, alertCallback, [название], [buttonName])
1.44 +
1.45 +
1.46 +* **сообщение**: сообщение диалога. *(Строка)*
1.47 +
1.48 +* **alertCallback**: обратного вызова для вызова, когда закрывается диалоговое окно оповещения. *(Функция)*
1.49 +
1.50 +* **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Alert`)
1.51 +
1.52 +* **buttonName**: имя кнопки. *(Строка)* (Опционально, по умолчанию`OK`)
1.53 +
1.54 +### Пример
1.55 +
1.56 + function alertDismissed() {
1.57 + // do something
1.58 + }
1.59 +
1.60 + navigator.notification.alert(
1.61 + 'You are the winner!', // message
1.62 + alertDismissed, // callback
1.63 + 'Game Over', // title
1.64 + 'Done' // buttonName
1.65 + );
1.66 +
1.67 +
1.68 +### Поддерживаемые платформы
1.69 +
1.70 +* Amazon Fire OS
1.71 +* Android
1.72 +* BlackBerry 10
1.73 +* Firefox OS
1.74 +* iOS
1.75 +* Tizen
1.76 +* Windows Phone 7 и 8
1.77 +* Windows 8
1.78 +
1.79 +### Особенности Windows Phone 7 и 8
1.80 +
1.81 +* Существует предупреждение не встроенный браузер, но можно привязать один следующим позвонить `alert()` в глобальной области действия:
1.82 +
1.83 + window.alert = navigator.notification.alert;
1.84 +
1.85 +
1.86 +* Оба `alert` и `confirm` являются не блокировка звонков, результаты которых доступны только асинхронно.
1.87 +
1.88 +### Firefox OS причуды:
1.89 +
1.90 +Как родной блокировка `window.alert()` и неблокирующий `navigator.notification.alert()` доступны.
1.91 +
1.92 +## navigator.notification.confirm
1.93 +
1.94 +Отображает диалоговое окно Настраиваемый подтверждения.
1.95 +
1.96 + navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
1.97 +
1.98 +
1.99 +* **сообщение**: сообщение диалога. *(Строка)*
1.100 +
1.101 +* **confirmCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)*
1.102 +
1.103 +* **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Confirm`)
1.104 +
1.105 +* **buttonLabels**: массив строк, указав названия кнопок. *(Массив)* (Не обязательно, по умолчанию [ `OK,Cancel` ])
1.106 +
1.107 +### confirmCallback
1.108 +
1.109 +`confirmCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне подтверждения.
1.110 +
1.111 +Аргументом функции обратного вызова `buttonIndex` *(номер)*, который является индекс нажатой кнопки. Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д.
1.112 +
1.113 +### Пример
1.114 +
1.115 + function onConfirm(buttonIndex) {
1.116 + alert('You selected button ' + buttonIndex);
1.117 + }
1.118 +
1.119 + navigator.notification.confirm(
1.120 + 'You are the winner!', // message
1.121 + onConfirm, // callback to invoke with index of button pressed
1.122 + 'Game Over', // title
1.123 + ['Restart','Exit'] // buttonLabels
1.124 + );
1.125 +
1.126 +
1.127 +### Поддерживаемые платформы
1.128 +
1.129 +* Amazon Fire OS
1.130 +* Android
1.131 +* BlackBerry 10
1.132 +* Firefox OS
1.133 +* iOS
1.134 +* Tizen
1.135 +* Windows Phone 7 и 8
1.136 +* Windows 8
1.137 +
1.138 +### Особенности Windows Phone 7 и 8
1.139 +
1.140 +* Нет встроенного браузера функция для `window.confirm` , но его можно привязать путем присвоения:
1.141 +
1.142 + window.confirm = navigator.notification.confirm;
1.143 +
1.144 +
1.145 +* Вызовы `alert` и `confirm` являются не блокируется, поэтому результат доступен только асинхронно.
1.146 +
1.147 +### Firefox OS причуды:
1.148 +
1.149 +Как родной блокировка `window.confirm()` и неблокирующий `navigator.notification.confirm()` доступны.
1.150 +
1.151 +## navigator.notification.prompt
1.152 +
1.153 +Отображает родной диалоговое окно более настраиваемый, чем в браузере `prompt` функции.
1.154 +
1.155 + navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
1.156 +
1.157 +
1.158 +* **сообщение**: сообщение диалога. *(Строка)*
1.159 +
1.160 +* **promptCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)*
1.161 +
1.162 +* **название**: диалоговое окно название *(String)* (опционально, по умолчанию`Prompt`)
1.163 +
1.164 +* **buttonLabels**: массив строк, указав кнопку этикетки *(массив)* (опционально, по умолчанию`["OK","Cancel"]`)
1.165 +
1.166 +* **defaultText**: по умолчанию textbox входное значение ( `String` ) (опционально, по умолчанию: пустая строка)
1.167 +
1.168 +### promptCallback
1.169 +
1.170 +`promptCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне приглашения. `results`Объект, переданный в метод обратного вызова содержит следующие свойства:
1.171 +
1.172 +* **buttonIndex**: индекс нажатой кнопки. *(Число)* Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д.
1.173 +
1.174 +* **INPUT1**: текст, введенный в диалоговом окне приглашения. *(Строка)*
1.175 +
1.176 +### Пример
1.177 +
1.178 + function onPrompt(results) {
1.179 + alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
1.180 + }
1.181 +
1.182 + navigator.notification.prompt(
1.183 + 'Please enter your name', // message
1.184 + onPrompt, // callback to invoke
1.185 + 'Registration', // title
1.186 + ['Ok','Exit'], // buttonLabels
1.187 + 'Jane Doe' // defaultText
1.188 + );
1.189 +
1.190 +
1.191 +### Поддерживаемые платформы
1.192 +
1.193 +* Amazon Fire OS
1.194 +* Android
1.195 +* Firefox OS
1.196 +* iOS
1.197 +* Windows Phone 7 и 8
1.198 +
1.199 +### Особенности Android
1.200 +
1.201 +* Android поддерживает максимум из трех кнопок и игнорирует больше, чем это.
1.202 +
1.203 +* На Android 3.0 и более поздних версиях кнопки отображаются в обратном порядке для устройств, которые используют тему холо.
1.204 +
1.205 +### Firefox OS причуды:
1.206 +
1.207 +Как родной блокировка `window.prompt()` и неблокирующий `navigator.notification.prompt()` доступны.
1.208 +
1.209 +## navigator.notification.beep
1.210 +
1.211 +Устройство воспроизводит звуковой сигнал звук.
1.212 +
1.213 + navigator.notification.beep(times);
1.214 +
1.215 +
1.216 +* **раз**: количество раз, чтобы повторить сигнал. *(Число)*
1.217 +
1.218 +### Пример
1.219 +
1.220 + // Beep twice!
1.221 + navigator.notification.beep(2);
1.222 +
1.223 +
1.224 +### Поддерживаемые платформы
1.225 +
1.226 +* Amazon Fire OS
1.227 +* Android
1.228 +* BlackBerry 10
1.229 +* iOS
1.230 +* Tizen
1.231 +* Windows Phone 7 и 8
1.232 +* Windows 8
1.233 +
1.234 +### Особенности Amazon Fire OS
1.235 +
1.236 +* Amazon Fire OS играет по умолчанию **Звук уведомления** , указанного на панели **параметров/дисплей и звук** .
1.237 +
1.238 +### Особенности Android
1.239 +
1.240 +* Android играет по умолчанию **уведомления рингтон** указанных в панели **настройки/звук и дисплей** .
1.241 +
1.242 +### Особенности Windows Phone 7 и 8
1.243 +
1.244 +* Опирается на общий звуковой файл из дистрибутива Кордова.
1.245 +
1.246 +### Особенности Tizen
1.247 +
1.248 +* Tizen реализует гудков, воспроизведении аудиофайла через СМИ API.
1.249 +
1.250 +* Звуковой файл должен быть коротким, должен быть расположен в `sounds` подкаталог корневого каталога приложения и должны быть названы`beep.wav`.
1.251 \ No newline at end of file
