Thu, 04 Jun 2015 14:50:33 +0200
Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.
1 <!---
2 Licensed to the Apache Software Foundation (ASF) under one
3 or more contributor license agreements. See the NOTICE file
4 distributed with this work for additional information
5 regarding copyright ownership. The ASF licenses this file
6 to you under the Apache License, Version 2.0 (the
7 "License"); you may not use this file except in compliance
8 with the License. You may obtain a copy of the License at
10 http://www.apache.org/licenses/LICENSE-2.0
12 Unless required by applicable law or agreed to in writing,
13 software distributed under the License is distributed on an
14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 KIND, either express or implied. See the License for the
16 specific language governing permissions and limitations
17 under the License.
18 -->
20 # org.apache.cordova.dialogs
22 このプラグインはいくつかのネイティブのダイアログの UI 要素へのアクセスを提供します。
24 ## インストール
26 cordova plugin add org.apache.cordova.dialogs
29 ## メソッド
31 * `navigator.notification.alert`
32 * `navigator.notification.confirm`
33 * `navigator.notification.prompt`
34 * `navigator.notification.beep`
36 ## navigator.notification.alert
38 カスタムの警告またはダイアログ ボックスが表示されます。 ほとんどコルドバ ネイティブ] ダイアログ ボックスの使用この機能がいくつかのプラットフォームを使用して、ブラウザーの `alert` 関数は、通常より少なくカスタマイズ可能です。
40 navigator.notification.alert(message, alertCallback, [title], [buttonName])
43 * **メッセージ**: ダイアログ メッセージ。*(文字列)*
45 * **alertCallback**: 警告ダイアログが閉じられたときに呼び出すコールバック。*(機能)*
47 * **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Alert`)
49 * **buttonName**: ボタンの名前。*(文字列)*(省略可能、既定値は`OK`)
51 ### 例
53 function alertDismissed() {
54 // do something
55 }
57 navigator.notification.alert(
58 'You are the winner!', // message
59 alertDismissed, // callback
60 'Game Over', // title
61 'Done' // buttonName
62 );
65 ### サポートされているプラットフォーム
67 * アマゾン火 OS
68 * アンドロイド
69 * ブラックベリー 10
70 * Firefox の OS
71 * iOS
72 * Tizen
73 * Windows Phone 7 と 8
74 * Windows 8
76 ### Windows Phone 7 と 8 癖
78 * 組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます `alert()` 、グローバル スコープで。
80 window.alert = navigator.notification.alert;
83 * 両方の `alert` と `confirm` は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。
85 ### Firefox OS 互換:
87 両方のネイティブ ブロック `window.alert()` ノン ブロッキングと `navigator.notification.alert()` は利用できます。
89 ## navigator.notification.confirm
91 カスタマイズ可能な確認のダイアログ ボックスが表示されます。
93 navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
96 * **メッセージ**: ダイアログ メッセージ。*(文字列)*
98 * **confirmCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す (0) なしに解雇されたときに呼び出すコールバック。*(機能)*
100 * **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Confirm`)
102 * **buttonLabels**: ボタンのラベルを指定する文字列の配列。*(配列)*(省略可能、既定値は [ `OK,Cancel` ])
104 ### confirmCallback
106 `confirmCallback`の確認ダイアログ ボックスでボタンを押したときに実行されます。
108 コールバック引数 `buttonIndex` *(番号)*は、押されたボタンのインデックス。 メモこと、インデックスを使用して 1 ベースのインデックス化、ので、値は `1` 、 `2` 、 `3` 、等。
110 ### 例
112 function onConfirm(buttonIndex) {
113 alert('You selected button ' + buttonIndex);
114 }
116 navigator.notification.confirm(
117 'You are the winner!', // message
118 onConfirm, // callback to invoke with index of button pressed
119 'Game Over', // title
120 ['Restart','Exit'] // buttonLabels
121 );
124 ### サポートされているプラットフォーム
126 * アマゾン火 OS
127 * アンドロイド
128 * ブラックベリー 10
129 * Firefox の OS
130 * iOS
131 * Tizen
132 * Windows Phone 7 と 8
133 * Windows 8
135 ### Windows Phone 7 と 8 癖
137 * 組み込みブラウザーの機能はありません `window.confirm` が割り当てることによってバインドすることができます。
139 window.confirm = navigator.notification.confirm;
142 * 呼び出しを `alert` と `confirm` では非ブロッキング、結果は非同期的にのみ使用できます。
144 ### Firefox OS 互換:
146 両方のネイティブ ブロック `window.confirm()` ノン ブロッキングと `navigator.notification.confirm()` は利用できます。
148 ## navigator.notification.prompt
150 ブラウザーのより詳細にカスタマイズはネイティブのダイアログ ボックスが表示されます `prompt` 関数。
152 navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
155 * **メッセージ**: ダイアログ メッセージ。*(文字列)*
157 * **promptCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す (0) なしに解雇されたときに呼び出すコールバック。*(機能)*
159 * **タイトル**: *(文字列)* (省略可能、既定値のタイトル] ダイアログ`Prompt`)
161 * **buttonLabels**: ボタンを指定する文字列の配列*(配列)* (省略可能、既定値のラベル`["OK","Cancel"]`)
163 * **これら**: 既定テキスト ボックスの入力値 ( `String` ) (省略可能、既定: 空の文字列)
165 ### promptCallback
167 `promptCallback`プロンプト ダイアログ ボックス内のボタンのいずれかを押したときに実行されます。`results`コールバックに渡されるオブジェクトに、次のプロパティが含まれています。
169 * **buttonIndex**: 押されたボタンのインデックス。*(数)*メモこと、インデックスを使用して 1 ベースのインデックス化、ので、値は `1` 、 `2` 、 `3` 、等。
171 * **input1**: プロンプト ダイアログ ボックスに入力したテキスト。*(文字列)*
173 ### 例
175 function onPrompt(results) {
176 alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
177 }
179 navigator.notification.prompt(
180 'Please enter your name', // message
181 onPrompt, // callback to invoke
182 'Registration', // title
183 ['Ok','Exit'], // buttonLabels
184 'Jane Doe' // defaultText
185 );
188 ### サポートされているプラットフォーム
190 * アマゾン火 OS
191 * アンドロイド
192 * Firefox の OS
193 * iOS
194 * Windows Phone 7 と 8
196 ### Android の癖
198 * Android は最大 3 つのボタンをサポートしているし、それ以上無視します。
200 * アンドロイド 3.0 と後、ホロのテーマを使用するデバイスを逆の順序でボタンが表示されます。
202 ### Firefox OS 互換:
204 両方のネイティブ ブロック `window.prompt()` ノン ブロッキングと `navigator.notification.prompt()` は利用できます。
206 ## navigator.notification.beep
208 デバイス サウンドをビープ音を再生します。
210 navigator.notification.beep(times);
213 * **回**: ビープ音を繰り返す回数。*(数)*
215 ### 例
217 // Beep twice!
218 navigator.notification.beep(2);
221 ### サポートされているプラットフォーム
223 * アマゾン火 OS
224 * アンドロイド
225 * ブラックベリー 10
226 * iOS
227 * Tizen
228 * Windows Phone 7 と 8
229 * Windows 8
231 ### アマゾン火 OS 癖
233 * アマゾン火 OS デフォルト**設定/表示 & サウンド**パネルの下に指定した**通知音**を果たしています。
235 ### Android の癖
237 * アンドロイド デフォルト**通知着信音****設定/サウンド & ディスプレイ**パネルの下に指定を果たしています。
239 ### Windows Phone 7 と 8 癖
241 * コルドバ分布からジェネリック ビープ音ファイルに依存します。
243 ### Tizen の癖
245 * Tizen は、メディア API 経由でオーディオ ファイルを再生してビープ音を実装します。
247 * ビープ音ファイルする必要があります短いである必要があります、 `sounds` 、アプリケーションのルート ディレクトリのサブディレクトリと命名する必要があります`beep.wav`.