|
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 |
|
9 |
|
10 http://www.apache.org/licenses/LICENSE-2.0 |
|
11 |
|
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 --> |
|
19 |
|
20 # org.apache.cordova.dialogs |
|
21 |
|
22 このプラグインはいくつかのネイティブのダイアログの UI 要素へのアクセスを提供します。 |
|
23 |
|
24 ## インストール |
|
25 |
|
26 cordova plugin add org.apache.cordova.dialogs |
|
27 |
|
28 |
|
29 ## メソッド |
|
30 |
|
31 * `navigator.notification.alert` |
|
32 * `navigator.notification.confirm` |
|
33 * `navigator.notification.prompt` |
|
34 * `navigator.notification.beep` |
|
35 |
|
36 ## navigator.notification.alert |
|
37 |
|
38 カスタムの警告またはダイアログ ボックスが表示されます。 ほとんどコルドバ ネイティブ] ダイアログ ボックスの使用この機能がいくつかのプラットフォームを使用して、ブラウザーの `alert` 関数は、通常より少なくカスタマイズ可能です。 |
|
39 |
|
40 navigator.notification.alert(message, alertCallback, [title], [buttonName]) |
|
41 |
|
42 |
|
43 * **メッセージ**: ダイアログ メッセージ。*(文字列)* |
|
44 |
|
45 * **alertCallback**: 警告ダイアログが閉じられたときに呼び出すコールバック。*(機能)* |
|
46 |
|
47 * **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Alert`) |
|
48 |
|
49 * **buttonName**: ボタンの名前。*(文字列)*(省略可能、既定値は`OK`) |
|
50 |
|
51 ### 例 |
|
52 |
|
53 function alertDismissed() { |
|
54 // do something |
|
55 } |
|
56 |
|
57 navigator.notification.alert( |
|
58 'You are the winner!', // message |
|
59 alertDismissed, // callback |
|
60 'Game Over', // title |
|
61 'Done' // buttonName |
|
62 ); |
|
63 |
|
64 |
|
65 ### サポートされているプラットフォーム |
|
66 |
|
67 * アマゾン火 OS |
|
68 * アンドロイド |
|
69 * ブラックベリー 10 |
|
70 * Firefox の OS |
|
71 * iOS |
|
72 * Tizen |
|
73 * Windows Phone 7 と 8 |
|
74 * Windows 8 |
|
75 |
|
76 ### Windows Phone 7 と 8 癖 |
|
77 |
|
78 * 組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます `alert()` 、グローバル スコープで。 |
|
79 |
|
80 window.alert = navigator.notification.alert; |
|
81 |
|
82 |
|
83 * 両方の `alert` と `confirm` は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。 |
|
84 |
|
85 ### Firefox OS 互換: |
|
86 |
|
87 両方のネイティブ ブロック `window.alert()` ノン ブロッキングと `navigator.notification.alert()` は利用できます。 |
|
88 |
|
89 ## navigator.notification.confirm |
|
90 |
|
91 カスタマイズ可能な確認のダイアログ ボックスが表示されます。 |
|
92 |
|
93 navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) |
|
94 |
|
95 |
|
96 * **メッセージ**: ダイアログ メッセージ。*(文字列)* |
|
97 |
|
98 * **confirmCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す (0) なしに解雇されたときに呼び出すコールバック。*(機能)* |
|
99 |
|
100 * **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Confirm`) |
|
101 |
|
102 * **buttonLabels**: ボタンのラベルを指定する文字列の配列。*(配列)*(省略可能、既定値は [ `OK,Cancel` ]) |
|
103 |
|
104 ### confirmCallback |
|
105 |
|
106 `confirmCallback`の確認ダイアログ ボックスでボタンを押したときに実行されます。 |
|
107 |
|
108 コールバック引数 `buttonIndex` *(番号)*は、押されたボタンのインデックス。 メモこと、インデックスを使用して 1 ベースのインデックス化、ので、値は `1` 、 `2` 、 `3` 、等。 |
|
109 |
|
110 ### 例 |
|
111 |
|
112 function onConfirm(buttonIndex) { |
|
113 alert('You selected button ' + buttonIndex); |
|
114 } |
|
115 |
|
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 ); |
|
122 |
|
123 |
|
124 ### サポートされているプラットフォーム |
|
125 |
|
126 * アマゾン火 OS |
|
127 * アンドロイド |
|
128 * ブラックベリー 10 |
|
129 * Firefox の OS |
|
130 * iOS |
|
131 * Tizen |
|
132 * Windows Phone 7 と 8 |
|
133 * Windows 8 |
|
134 |
|
135 ### Windows Phone 7 と 8 癖 |
|
136 |
|
137 * 組み込みブラウザーの機能はありません `window.confirm` が割り当てることによってバインドすることができます。 |
|
138 |
|
139 window.confirm = navigator.notification.confirm; |
|
140 |
|
141 |
|
142 * 呼び出しを `alert` と `confirm` では非ブロッキング、結果は非同期的にのみ使用できます。 |
|
143 |
|
144 ### Firefox OS 互換: |
|
145 |
|
146 両方のネイティブ ブロック `window.confirm()` ノン ブロッキングと `navigator.notification.confirm()` は利用できます。 |
|
147 |
|
148 ## navigator.notification.prompt |
|
149 |
|
150 ブラウザーのより詳細にカスタマイズはネイティブのダイアログ ボックスが表示されます `prompt` 関数。 |
|
151 |
|
152 navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) |
|
153 |
|
154 |
|
155 * **メッセージ**: ダイアログ メッセージ。*(文字列)* |
|
156 |
|
157 * **promptCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す (0) なしに解雇されたときに呼び出すコールバック。*(機能)* |
|
158 |
|
159 * **タイトル**: *(文字列)* (省略可能、既定値のタイトル] ダイアログ`Prompt`) |
|
160 |
|
161 * **buttonLabels**: ボタンを指定する文字列の配列*(配列)* (省略可能、既定値のラベル`["OK","Cancel"]`) |
|
162 |
|
163 * **これら**: 既定テキスト ボックスの入力値 ( `String` ) (省略可能、既定: 空の文字列) |
|
164 |
|
165 ### promptCallback |
|
166 |
|
167 `promptCallback`プロンプト ダイアログ ボックス内のボタンのいずれかを押したときに実行されます。`results`コールバックに渡されるオブジェクトに、次のプロパティが含まれています。 |
|
168 |
|
169 * **buttonIndex**: 押されたボタンのインデックス。*(数)*メモこと、インデックスを使用して 1 ベースのインデックス化、ので、値は `1` 、 `2` 、 `3` 、等。 |
|
170 |
|
171 * **input1**: プロンプト ダイアログ ボックスに入力したテキスト。*(文字列)* |
|
172 |
|
173 ### 例 |
|
174 |
|
175 function onPrompt(results) { |
|
176 alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); |
|
177 } |
|
178 |
|
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 ); |
|
186 |
|
187 |
|
188 ### サポートされているプラットフォーム |
|
189 |
|
190 * アマゾン火 OS |
|
191 * アンドロイド |
|
192 * Firefox の OS |
|
193 * iOS |
|
194 * Windows Phone 7 と 8 |
|
195 |
|
196 ### Android の癖 |
|
197 |
|
198 * Android は最大 3 つのボタンをサポートしているし、それ以上無視します。 |
|
199 |
|
200 * アンドロイド 3.0 と後、ホロのテーマを使用するデバイスを逆の順序でボタンが表示されます。 |
|
201 |
|
202 ### Firefox OS 互換: |
|
203 |
|
204 両方のネイティブ ブロック `window.prompt()` ノン ブロッキングと `navigator.notification.prompt()` は利用できます。 |
|
205 |
|
206 ## navigator.notification.beep |
|
207 |
|
208 デバイス サウンドをビープ音を再生します。 |
|
209 |
|
210 navigator.notification.beep(times); |
|
211 |
|
212 |
|
213 * **回**: ビープ音を繰り返す回数。*(数)* |
|
214 |
|
215 ### 例 |
|
216 |
|
217 // Beep twice! |
|
218 navigator.notification.beep(2); |
|
219 |
|
220 |
|
221 ### サポートされているプラットフォーム |
|
222 |
|
223 * アマゾン火 OS |
|
224 * アンドロイド |
|
225 * ブラックベリー 10 |
|
226 * iOS |
|
227 * Tizen |
|
228 * Windows Phone 7 と 8 |
|
229 * Windows 8 |
|
230 |
|
231 ### アマゾン火 OS 癖 |
|
232 |
|
233 * アマゾン火 OS デフォルト**設定/表示 & サウンド**パネルの下に指定した**通知音**を果たしています。 |
|
234 |
|
235 ### Android の癖 |
|
236 |
|
237 * アンドロイド デフォルト**通知着信音****設定/サウンド & ディスプレイ**パネルの下に指定を果たしています。 |
|
238 |
|
239 ### Windows Phone 7 と 8 癖 |
|
240 |
|
241 * コルドバ分布からジェネリック ビープ音ファイルに依存します。 |
|
242 |
|
243 ### Tizen の癖 |
|
244 |
|
245 * Tizen は、メディア API 経由でオーディオ ファイルを再生してビープ音を実装します。 |
|
246 |
|
247 * ビープ音ファイルする必要があります短いである必要があります、 `sounds` 、アプリケーションのルート ディレクトリのサブディレクトリと命名する必要があります`beep.wav`. |