Touchgui/plugins/org.apache.cordova.dialogs/doc/ja/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 このプラグインはいくつかのネイティブのダイアログの UI 要素へのアクセスを提供します。
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 カスタムの警告またはダイアログ ボックスが表示されます。 ほとんどコルドバ ネイティブ] ダイアログ ボックスの使用この機能がいくつかのプラットフォームを使用して、ブラウザーの `alert` 関数は、通常より少なくカスタマイズ可能です。
michael@0 39
michael@0 40 navigator.notification.alert(message, alertCallback, [title], [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 * アマゾン火 OS
michael@0 68 * アンドロイド
michael@0 69 * ブラックベリー 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 * 組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます `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 ベースのインデックス化、ので、値は `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 * アマゾン火 OS
michael@0 127 * アンドロイド
michael@0 128 * ブラックベリー 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 * **タイトル**: *(文字列)* (省略可能、既定値のタイトル] ダイアログ`Prompt`)
michael@0 160
michael@0 161 * **buttonLabels**: ボタンを指定する文字列の配列*(配列)* (省略可能、既定値のラベル`["OK","Cancel"]`)
michael@0 162
michael@0 163 * **これら**: 既定テキスト ボックスの入力値 ( `String` ) (省略可能、既定: 空の文字列)
michael@0 164
michael@0 165 ### promptCallback
michael@0 166
michael@0 167 `promptCallback`プロンプト ダイアログ ボックス内のボタンのいずれかを押したときに実行されます。`results`コールバックに渡されるオブジェクトに、次のプロパティが含まれています。
michael@0 168
michael@0 169 * **buttonIndex**: 押されたボタンのインデックス。*(数)*メモこと、インデックスを使用して 1 ベースのインデックス化、ので、値は `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 * アマゾン火 OS
michael@0 191 * アンドロイド
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 は最大 3 つのボタンをサポートしているし、それ以上無視します。
michael@0 199
michael@0 200 * アンドロイド 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 * アマゾン火 OS
michael@0 224 * アンドロイド
michael@0 225 * ブラックベリー 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 ### アマゾン火 OS 癖
michael@0 232
michael@0 233 * アマゾン火 OS デフォルト**設定/表示 & サウンド**パネルの下に指定した**通知音**を果たしています。
michael@0 234
michael@0 235 ### Android の癖
michael@0 236
michael@0 237 * アンドロイド デフォルト**通知着信音****設定/サウンド & ディスプレイ**パネルの下に指定を果たしています。
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`.

mercurial