Thu, 04 Jun 2015 14:50:33 +0200
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`. |