michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.dialogs
michael@0: 
michael@0: 이 플러그인 몇 가지 기본 대화 상자 UI 요소에 액세스할 수 있습니다.
michael@0: 
michael@0: ## 설치
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.dialogs
michael@0:     
michael@0: 
michael@0: ## 메서드
michael@0: 
michael@0: *   `navigator.notification.alert`
michael@0: *   `navigator.notification.confirm`
michael@0: *   `navigator.notification.prompt`
michael@0: *   `navigator.notification.beep`
michael@0: 
michael@0: ## navigator.notification.alert
michael@0: 
michael@0: 사용자 지정 경고 또는 대화 상자를 보여 줍니다. 이 기능에 대 한 기본 대화 상자를 사용 하는 대부분의 코르도바 구현 하지만 일부 플랫폼 사용 브라우저의 `alert` 함수는 일반적으로 덜 사용자 정의할 수 있습니다.
michael@0: 
michael@0:     navigator.notification.alert(message, alertCallback, [title], [buttonName])
michael@0:     
michael@0: 
michael@0: *   **메시지**: 대화 메시지. *(문자열)*
michael@0: 
michael@0: *   **alertCallback**: 콜백을 호출할 때 경고 대화 기 각. *(기능)*
michael@0: 
michael@0: *   **제목**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Alert`)
michael@0: 
michael@0: *   **buttonName**: 단추 이름. *(문자열)* (옵션, 기본값:`OK`)
michael@0: 
michael@0: ### 예를 들어
michael@0: 
michael@0:     function alertDismissed() {
michael@0:         // do something
michael@0:     }
michael@0:     
michael@0:     navigator.notification.alert(
michael@0:         'You are the winner!',  // message
michael@0:         alertDismissed,         // callback
michael@0:         'Game Over',            // title
michael@0:         'Done'                  // buttonName
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### 지원 되는 플랫폼
michael@0: 
michael@0: *   아마존 화재 운영 체제
michael@0: *   안 드 로이드
michael@0: *   블랙베리 10
michael@0: *   Firefox 운영 체제
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7과 8
michael@0: *   윈도우 8
michael@0: 
michael@0: ### Windows Phone 7, 8 특수
michael@0: 
michael@0: *   아니 내장 브라우저 경고 하지만 다음과 같이 전화를 바인딩할 수 있습니다 `alert()` 전역 범위에서:
michael@0:     
michael@0:         window.alert = navigator.notification.alert;
michael@0:         
michael@0: 
michael@0: *   둘 다 `alert` 와 `confirm` 는 비차단 호출, 결과 비동기적으로 사용할 수 있습니다.
michael@0: 
michael@0: ### 파이어 폭스 OS 단점:
michael@0: 
michael@0: 두 기본 차단 `window.alert()` 및 비차단 `navigator.notification.alert()` 사용할 수 있습니다.
michael@0: 
michael@0: ## navigator.notification.confirm
michael@0: 
michael@0: 사용자 정의 확인 대화 상자가 표시 됩니다.
michael@0: 
michael@0:     navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
michael@0:     
michael@0: 
michael@0: *   **메시지**: 대화 메시지. *(문자열)*
michael@0: 
michael@0: *   **confirmCallback**: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. *(기능)*
michael@0: 
michael@0: *   **제목**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Confirm`)
michael@0: 
michael@0: *   **buttonLabels**: 단추 레이블을 지정 하는 문자열 배열입니다. *(배열)* (옵션, 기본값은 [ `OK,Cancel` ])
michael@0: 
michael@0: ### confirmCallback
michael@0: 
michael@0: `confirmCallback`사용자가 확인 대화 상자에서 단추 중 하나를 누를 때 실행 됩니다.
michael@0: 
michael@0: 콜백 인수 `buttonIndex` *(번호)를*누르면된 버튼의 인덱스입니다. 참고 인덱스에서는 인덱스 1부터 값은 `1` , `2` , `3` , 등등.
michael@0: 
michael@0: ### 예를 들어
michael@0: 
michael@0:     function onConfirm(buttonIndex) {
michael@0:         alert('You selected button ' + buttonIndex);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.confirm(
michael@0:         'You are the winner!', // message
michael@0:          onConfirm,            // callback to invoke with index of button pressed
michael@0:         'Game Over',           // title
michael@0:         ['Restart','Exit']     // buttonLabels
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### 지원 되는 플랫폼
michael@0: 
michael@0: *   아마존 화재 운영 체제
michael@0: *   안 드 로이드
michael@0: *   블랙베리 10
michael@0: *   Firefox 운영 체제
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7과 8
michael@0: *   윈도우 8
michael@0: 
michael@0: ### Windows Phone 7, 8 특수
michael@0: 
michael@0: *   에 대 한 기본 제공 브라우저 함수가 `window.confirm` , 그러나 할당 하 여 바인딩할 수 있습니다:
michael@0:     
michael@0:         window.confirm = navigator.notification.confirm;
michael@0:         
michael@0: 
michael@0: *   호출 `alert` 및 `confirm` 되므로 차단 되지 않은 결과만 비동기적으로 사용할 수 있습니다.
michael@0: 
michael@0: ### 파이어 폭스 OS 단점:
michael@0: 
michael@0: 두 기본 차단 `window.confirm()` 및 비차단 `navigator.notification.confirm()` 사용할 수 있습니다.
michael@0: 
michael@0: ## navigator.notification.prompt
michael@0: 
michael@0: 브라우저의 보다 더 많은 사용자 정의 기본 대화 상자 표시 `prompt` 기능.
michael@0: 
michael@0:     navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
michael@0:     
michael@0: 
michael@0: *   **메시지**: 대화 메시지. *(문자열)*
michael@0: 
michael@0: *   **promptCallback**: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. *(기능)*
michael@0: 
michael@0: *   **제목**: 제목 *(문자열)* (옵션, 기본값 대화 상자`Prompt`)
michael@0: 
michael@0: *   **buttonLabels**: 단추를 지정 하는 문자열의 배열 *(배열)* (옵션, 기본값은 레이블`["OK","Cancel"]`)
michael@0: 
michael@0: *   **defaultText**: 기본 텍스트 상자 입력 값 ( `String` ) (옵션, 기본값: 빈 문자열)
michael@0: 
michael@0: ### promptCallback
michael@0: 
michael@0: `promptCallback`사용자가 프롬프트 대화 상자에서 단추 중 하나를 누를 때 실행 됩니다. `results`콜백에 전달 된 개체에는 다음 속성이 포함 되어 있습니다:
michael@0: 
michael@0: *   **buttonIndex**: 눌려진된 버튼의 인덱스. *(수)* 참고 인덱스에서는 인덱스 1부터 값은 `1` , `2` , `3` , 등등.
michael@0: 
michael@0: *   **input1**: 프롬프트 대화 상자에 입력 한 텍스트. *(문자열)*
michael@0: 
michael@0: ### 예를 들어
michael@0: 
michael@0:     function onPrompt(results) {
michael@0:         alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.prompt(
michael@0:         'Please enter your name',  // message
michael@0:         onPrompt,                  // callback to invoke
michael@0:         'Registration',            // title
michael@0:         ['Ok','Exit'],             // buttonLabels
michael@0:         'Jane Doe'                 // defaultText
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### 지원 되는 플랫폼
michael@0: 
michael@0: *   아마존 화재 운영 체제
michael@0: *   안 드 로이드
michael@0: *   Firefox 운영 체제
michael@0: *   iOS
michael@0: *   Windows Phone 7과 8
michael@0: 
michael@0: ### 안 드 로이드 단점
michael@0: 
michael@0: *   안 드 로이드 최대 3 개의 단추를 지원 하 고 그것 보다는 더 이상 무시 합니다.
michael@0: 
michael@0: *   안 드 로이드 3.0 및 나중에, 단추는 홀로 테마를 사용 하는 장치에 대 한 반대 순서로 표시 됩니다.
michael@0: 
michael@0: ### 파이어 폭스 OS 단점:
michael@0: 
michael@0: 두 기본 차단 `window.prompt()` 및 비차단 `navigator.notification.prompt()` 사용할 수 있습니다.
michael@0: 
michael@0: ## navigator.notification.beep
michael@0: 
michael@0: 장치는 경고음 소리를 재생 합니다.
michael@0: 
michael@0:     navigator.notification.beep(times);
michael@0:     
michael@0: 
michael@0: *   **시간**: 경고음을 반복 하는 횟수. *(수)*
michael@0: 
michael@0: ### 예를 들어
michael@0: 
michael@0:     // Beep twice!
michael@0:     navigator.notification.beep(2);
michael@0:     
michael@0: 
michael@0: ### 지원 되는 플랫폼
michael@0: 
michael@0: *   아마존 화재 운영 체제
michael@0: *   안 드 로이드
michael@0: *   블랙베리 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7과 8
michael@0: *   윈도우 8
michael@0: 
michael@0: ### 아마존 화재 OS 단점
michael@0: 
michael@0: *   아마존 화재 운영 체제 기본 **설정/디스플레이 및 사운드** 패널에 지정 된 **알림 소리** 재생 됩니다.
michael@0: 
michael@0: ### 안 드 로이드 단점
michael@0: 
michael@0: *   안 드 로이드 기본 **알림 벨소리** **설정/사운드 및 디스플레이** 패널에서 지정 합니다.
michael@0: 
michael@0: ### Windows Phone 7, 8 특수
michael@0: 
michael@0: *   코르 도우 바 분포에서 일반 경고음 파일에 의존합니다.
michael@0: 
michael@0: ### Tizen 특수
michael@0: 
michael@0: *   Tizen은 미디어 API 통해 오디오 파일을 재생 하 여 경고음을 구현 합니다.
michael@0: 
michael@0: *   경고음 파일에 위치 해야 합니다, 짧은 해야 한 `sounds` 응용 프로그램의 루트 디렉터리의 하위 디렉터리 명명 해야 합니다`beep.wav`.