• file
• revisions
• annotate
• diff
• comparison
• raw

Touchgui/plugins/org.apache.cordova.dialogs/doc/ru/index.md@e8ccd40d0ef6 (annotated)

Touchgui/plugins/org.apache.cordova.dialogs/doc/ru/index.md

Thu, 04 Jun 2015 14:50:33 +0200

author

Michael Schloh von Bennewitz <michael@schloh.com>

date

Thu, 04 Jun 2015 14:50:33 +0200

changeset 0

e8ccd40d0ef6

permissions

-rw-r--r--

Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.

michael@0	1	<!---
michael@0	2	Licensed to the Apache Software Foundation (ASF) under one
michael@0	3	or more contributor license agreements. See the NOTICE file
michael@0	4	distributed with this work for additional information
michael@0	5	regarding copyright ownership. The ASF licenses this file
michael@0	6	to you under the Apache License, Version 2.0 (the
michael@0	7	"License"); you may not use this file except in compliance
michael@0	8	with the License. You may obtain a copy of the License at
michael@0	9
michael@0	10	http://www.apache.org/licenses/LICENSE-2.0
michael@0	11
michael@0	12	Unless required by applicable law or agreed to in writing,
michael@0	13	software distributed under the License is distributed on an
michael@0	14	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0	15	KIND, either express or implied. See the License for the
michael@0	16	specific language governing permissions and limitations
michael@0	17	under the License.
michael@0	18	-->
michael@0	19
michael@0	20	# org.apache.cordova.dialogs
michael@0	21
michael@0	22	Этот плагин обеспечивает доступ к некоторым элементам собственного диалогового окна пользовательского интерфейса.
michael@0	23
michael@0	24	## Установка
michael@0	25
michael@0	26	cordova plugin add org.apache.cordova.dialogs
michael@0	27
michael@0	28
michael@0	29	## Методы
michael@0	30
michael@0	31	* `navigator.notification.alert`
michael@0	32	* `navigator.notification.confirm`
michael@0	33	* `navigator.notification.prompt`
michael@0	34	* `navigator.notification.beep`
michael@0	35
michael@0	36	## navigator.notification.alert
michael@0	37
michael@0	38	Показывает окно пользовательские оповещения или диалоговое окно. Большинство реализаций Cordova использовать диалоговое окно родной для этой функции, но некоторые платформы браузера `alert` функция, которая как правило менее настраивается.
michael@0	39
michael@0	40	Navigator.Notification.Alert (сообщение, alertCallback, [название], [buttonName])
michael@0	41
michael@0	42
michael@0	43	* **сообщение**: сообщение диалога. *(Строка)*
michael@0	44
michael@0	45	* **alertCallback**: обратного вызова для вызова, когда закрывается диалоговое окно оповещения. *(Функция)*
michael@0	46
michael@0	47	* **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Alert`)
michael@0	48
michael@0	49	* **buttonName**: имя кнопки. *(Строка)* (Опционально, по умолчанию`OK`)
michael@0	50
michael@0	51	### Пример
michael@0	52
michael@0	53	function alertDismissed() {
michael@0	54	// do something
michael@0	55	}
michael@0	56
michael@0	57	navigator.notification.alert(
michael@0	58	'You are the winner!', // message
michael@0	59	alertDismissed, // callback
michael@0	60	'Game Over', // title
michael@0	61	'Done' // buttonName
michael@0	62	);
michael@0	63
michael@0	64
michael@0	65	### Поддерживаемые платформы
michael@0	66
michael@0	67	* Amazon Fire OS
michael@0	68	* Android
michael@0	69	* BlackBerry 10
michael@0	70	* Firefox OS
michael@0	71	* iOS
michael@0	72	* Tizen
michael@0	73	* Windows Phone 7 и 8
michael@0	74	* Windows 8
michael@0	75
michael@0	76	### Особенности Windows Phone 7 и 8
michael@0	77
michael@0	78	* Существует предупреждение не встроенный браузер, но можно привязать один следующим позвонить `alert()` в глобальной области действия:
michael@0	79
michael@0	80	window.alert = navigator.notification.alert;
michael@0	81
michael@0	82
michael@0	83	* Оба `alert` и `confirm` являются не блокировка звонков, результаты которых доступны только асинхронно.
michael@0	84
michael@0	85	### Firefox OS причуды:
michael@0	86
michael@0	87	Как родной блокировка `window.alert()` и неблокирующий `navigator.notification.alert()` доступны.
michael@0	88
michael@0	89	## navigator.notification.confirm
michael@0	90
michael@0	91	Отображает диалоговое окно Настраиваемый подтверждения.
michael@0	92
michael@0	93	navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
michael@0	94
michael@0	95
michael@0	96	* **сообщение**: сообщение диалога. *(Строка)*
michael@0	97
michael@0	98	* **confirmCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)*
michael@0	99
michael@0	100	* **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Confirm`)
michael@0	101
michael@0	102	* **buttonLabels**: массив строк, указав названия кнопок. *(Массив)* (Не обязательно, по умолчанию [ `OK,Cancel` ])
michael@0	103
michael@0	104	### confirmCallback
michael@0	105
michael@0	106	`confirmCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне подтверждения.
michael@0	107
michael@0	108	Аргументом функции обратного вызова `buttonIndex` *(номер)*, который является индекс нажатой кнопки. Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д.
michael@0	109
michael@0	110	### Пример
michael@0	111
michael@0	112	function onConfirm(buttonIndex) {
michael@0	113	alert('You selected button ' + buttonIndex);
michael@0	114	}
michael@0	115
michael@0	116	navigator.notification.confirm(
michael@0	117	'You are the winner!', // message
michael@0	118	onConfirm, // callback to invoke with index of button pressed
michael@0	119	'Game Over', // title
michael@0	120	['Restart','Exit'] // buttonLabels
michael@0	121	);
michael@0	122
michael@0	123
michael@0	124	### Поддерживаемые платформы
michael@0	125
michael@0	126	* Amazon Fire OS
michael@0	127	* Android
michael@0	128	* BlackBerry 10
michael@0	129	* Firefox OS
michael@0	130	* iOS
michael@0	131	* Tizen
michael@0	132	* Windows Phone 7 и 8
michael@0	133	* Windows 8
michael@0	134
michael@0	135	### Особенности Windows Phone 7 и 8
michael@0	136
michael@0	137	* Нет встроенного браузера функция для `window.confirm` , но его можно привязать путем присвоения:
michael@0	138
michael@0	139	window.confirm = navigator.notification.confirm;
michael@0	140
michael@0	141
michael@0	142	* Вызовы `alert` и `confirm` являются не блокируется, поэтому результат доступен только асинхронно.
michael@0	143
michael@0	144	### Firefox OS причуды:
michael@0	145
michael@0	146	Как родной блокировка `window.confirm()` и неблокирующий `navigator.notification.confirm()` доступны.
michael@0	147
michael@0	148	## navigator.notification.prompt
michael@0	149
michael@0	150	Отображает родной диалоговое окно более настраиваемый, чем в браузере `prompt` функции.
michael@0	151
michael@0	152	navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
michael@0	153
michael@0	154
michael@0	155	* **сообщение**: сообщение диалога. *(Строка)*
michael@0	156
michael@0	157	* **promptCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)*
michael@0	158
michael@0	159	* **название**: диалоговое окно название *(String)* (опционально, по умолчанию`Prompt`)
michael@0	160
michael@0	161	* **buttonLabels**: массив строк, указав кнопку этикетки *(массив)* (опционально, по умолчанию`["OK","Cancel"]`)
michael@0	162
michael@0	163	* **defaultText**: по умолчанию textbox входное значение ( `String` ) (опционально, по умолчанию: пустая строка)
michael@0	164
michael@0	165	### promptCallback
michael@0	166
michael@0	167	`promptCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне приглашения. `results`Объект, переданный в метод обратного вызова содержит следующие свойства:
michael@0	168
michael@0	169	* **buttonIndex**: индекс нажатой кнопки. *(Число)* Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д.
michael@0	170
michael@0	171	* **INPUT1**: текст, введенный в диалоговом окне приглашения. *(Строка)*
michael@0	172
michael@0	173	### Пример
michael@0	174
michael@0	175	function onPrompt(results) {
michael@0	176	alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
michael@0	177	}
michael@0	178
michael@0	179	navigator.notification.prompt(
michael@0	180	'Please enter your name', // message
michael@0	181	onPrompt, // callback to invoke
michael@0	182	'Registration', // title
michael@0	183	['Ok','Exit'], // buttonLabels
michael@0	184	'Jane Doe' // defaultText
michael@0	185	);
michael@0	186
michael@0	187
michael@0	188	### Поддерживаемые платформы
michael@0	189
michael@0	190	* Amazon Fire OS
michael@0	191	* Android
michael@0	192	* Firefox OS
michael@0	193	* iOS
michael@0	194	* Windows Phone 7 и 8
michael@0	195
michael@0	196	### Особенности Android
michael@0	197
michael@0	198	* Android поддерживает максимум из трех кнопок и игнорирует больше, чем это.
michael@0	199
michael@0	200	* На Android 3.0 и более поздних версиях кнопки отображаются в обратном порядке для устройств, которые используют тему холо.
michael@0	201
michael@0	202	### Firefox OS причуды:
michael@0	203
michael@0	204	Как родной блокировка `window.prompt()` и неблокирующий `navigator.notification.prompt()` доступны.
michael@0	205
michael@0	206	## navigator.notification.beep
michael@0	207
michael@0	208	Устройство воспроизводит звуковой сигнал звук.
michael@0	209
michael@0	210	navigator.notification.beep(times);
michael@0	211
michael@0	212
michael@0	213	* **раз**: количество раз, чтобы повторить сигнал. *(Число)*
michael@0	214
michael@0	215	### Пример
michael@0	216
michael@0	217	// Beep twice!
michael@0	218	navigator.notification.beep(2);
michael@0	219
michael@0	220
michael@0	221	### Поддерживаемые платформы
michael@0	222
michael@0	223	* Amazon Fire OS
michael@0	224	* Android
michael@0	225	* BlackBerry 10
michael@0	226	* iOS
michael@0	227	* Tizen
michael@0	228	* Windows Phone 7 и 8
michael@0	229	* Windows 8
michael@0	230
michael@0	231	### Особенности Amazon Fire OS
michael@0	232
michael@0	233	* Amazon Fire OS играет по умолчанию **Звук уведомления** , указанного на панели **параметров/дисплей и звук** .
michael@0	234
michael@0	235	### Особенности Android
michael@0	236
michael@0	237	* Android играет по умолчанию **уведомления рингтон** указанных в панели **настройки/звук и дисплей** .
michael@0	238
michael@0	239	### Особенности Windows Phone 7 и 8
michael@0	240
michael@0	241	* Опирается на общий звуковой файл из дистрибутива Кордова.
michael@0	242
michael@0	243	### Особенности Tizen
michael@0	244
michael@0	245	* Tizen реализует гудков, воспроизведении аудиофайла через СМИ API.
michael@0	246
michael@0	247	* Звуковой файл должен быть коротким, должен быть расположен в `sounds` подкаталог корневого каталога приложения и должны быть названы`beep.wav`.