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

changeset 0
e8ccd40d0ef6
equal deleted inserted replaced
-1:000000000000 0:1883cee3a191
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`.

mercurial