InAppBrowser

InAppBrowser를 호출할 때 응용 프로그램에서 표시 하는 웹 브라우저입니다window.open.

var ref = window.open('http://apache.org', '_blank', 'location=yes');

설명

호출에서 반환 하는 개체window.open.

메서드

기능 액세스

버전 3.0, 코르도바 플러그인으로 장치 수준 Api를 구현합니다. CLI의 사용 plugin 명령 설명에 명령줄 인터페이스를 추가 하거나 프로젝트에 대 한이 기능을 제거 하려면:

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git
    $ cordova plugin rm org.apache.cordova.core.inappbrowser

이 명령은 모든 타겟된 플랫폼에 적용 하지만 플랫폼 관련 구성 설정을 아래에 설명 된 수정:

(안 드 로이드app/res/xml/config.xml)

<feature name="InAppBrowser">
    <param name="android-package" value="org.apache.cordova.InAppBrowser" />
</feature>

(iOSconfig.xml)

<feature name="InAppBrowser">
    <param name="ios-package" value="CDVInAppBrowser" />
</feature>

Windows Phone 7과 (8config.xml)
```
<feature name="InAppBrowser" />
```

일부 플랫폼은 특별 한 구성이 필요 없이이 기능을 지원할 수 있습니다. 플랫폼 지원에 대 한 참조.

addEventListener

이벤트에 대 한 수신기를 추가 합니다InAppBrowser.

ref.addEventListener(eventname, callback);

심판:에 대 한 참조는 InAppBrowser 창 (InAppBrowser)
eventname: (문자열)를 수신 하도록 이벤트
- loadstart: 이벤트 발생 때는 InAppBrowser URL 로드를 시작 합니다.
- loadstop: 이벤트가 발생 시기는 InAppBrowser URL 로드 완료.
- loaderror: 이벤트 발생 때는 InAppBrowser URL을 로드할 때 오류가 발생 합니다.
- 종료: 이벤트가 발생 시기는 InAppBrowser 창이 닫힙니다.
콜백: 이벤트가 발생 될 때 실행 되는 함수. 함수는 전달 된 InAppBrowserEvent 개체를 매개 변수로 합니다.

지원 되는 플랫폼

안 드 로이드
블랙베리
iOS
Windows Phone 7과 8

빠른 예제

var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstart', function() { alert(event.url); });

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>InAppBrowser.addEventListener Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
         var ref = window.open('http://apache.org', '_blank', 'location=yes');
         ref.addEventListener('loadstart', function(event) { alert('start: ' + event.url); });
         ref.addEventListener('loadstop', function(event) { alert('stop: ' + event.url); });
         ref.addEventListener('loaderror', function(event) { alert('error: ' + event.message); });
         ref.addEventListener('exit', function(event) { alert(event.type); });
    }

    </script>
  </head>
  <body>
  </body>
</html>

removeEventListener

이벤트에 대 한 수신기를 제거 합니다InAppBrowser.

ref.removeEventListener(eventname, callback);

심판:에 대 한 참조는 InAppBrowser 창. (InAppBrowser)
eventname: 이벤트 수신 대기를 중지 합니다. (문자열)
- loadstart: 이벤트 발생 때는 InAppBrowser URL 로드를 시작 합니다.
- loadstop: 이벤트가 발생 시기는 InAppBrowser URL 로드 완료.
- loaderror: 이벤트 발생 때는 InAppBrowser URL 로드 오류가 발생 합니다.
- 종료: 이벤트가 발생 시기는 InAppBrowser 창이 닫힙니다.
콜백: 이벤트가 발생 하면 실행할 함수. 함수는 전달 된 InAppBrowserEvent 개체.

지원 되는 플랫폼

안 드 로이드
블랙베리
iOS
Windows Phone 7과 8

빠른 예제

var ref = window.open('http://apache.org', '_blank', 'location=yes');
var myCallback = function() { alert(event.url); }
ref.addEventListener('loadstart', myCallback);
ref.removeEventListener('loadstart', myCallback);

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>InAppBrowser.removeEventListener Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Global InAppBrowser reference
    var iabRef = null;

    function iabLoadStart(event) {
        alert(event.type + ' - ' + event.url);
    }

    function iabLoadStop(event) {
        alert(event.type + ' - ' + event.url);
    }

    function iabLoadError(event) {
        alert(event.type + ' - ' + event.message);
    }

    function iabClose(event) {
         alert(event.type);
         iabRef.removeEventListener('loadstart', iabLoadStart);
         iabRef.removeEventListener('loadstop', iabLoadStop);
         iabRef.removeEventListener('loaderror', iabLoadError);
         iabRef.removeEventListener('exit', iabClose);
    }

    // device APIs are available
    //
    function onDeviceReady() {
         iabRef = window.open('http://apache.org', '_blank', 'location=yes');
         iabRef.addEventListener('loadstart', iabLoadStart);
         iabRef.addEventListener('loadstop', iabLoadStop);
         iabRef.removeEventListener('loaderror', iabLoadError);
         iabRef.addEventListener('exit', iabClose);
    }

    </script>
  </head>
  <body>
  </body>
</html>

닫기

종료는 InAppBrowser 창.

ref.close();

심판:에 대 한 참조는 InAppBrowser 창 (InAppBrowser)

지원 되는 플랫폼

안 드 로이드
블랙베리
iOS
Windows Phone 7과 8

빠른 예제

var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.close();

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>InAppBrowser.close Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
         var ref = window.open('http://apache.org', '_blank', 'location=yes');
         // close InAppBrowser after 5 seconds
         setTimeout(function() {
             ref.close();
         }, 5000);
    }

    </script>
  </head>
  <body>
  </body>
</html>

보기

숨겨진 열은 한 InAppBrowser 창을 표시 합니다. 전화는 InAppBrowser가 이미 보이는 경우는 효과가 없습니다.

ref.show();

ref: InAppBrowser 창 (참조InAppBrowser)

지원 되는 플랫폼

안 드 로이드
블랙베리
iOS

빠른 예제

var ref = window.open('http://apache.org', '_blank', 'hidden=yes');
ref.show();

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>InAppBrowser.show Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for Cordova to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Cordova is ready
    //
    function onDeviceReady() {
         var ref = window.open('http://apache.org', '_blank', 'hidden=yes');
         ref.addEventListener('loadstop', function(event) {
             alert('background window loaded'); 
         });
         // close InAppBrowser after 5 seconds
         setTimeout(function() {
             ref.close();
         }, 5000);
    }

    </script>
  </head>
  <body>
  </body>
</html>

executeScript

에 자바 스크립트 코드를 삽입는 InAppBrowser 창

ref.executeScript(details, callback);

심판:에 대 한 참조는 InAppBrowser 창. (InAppBrowser)
injectDetails: 스크립트 실행의 세부 사항 중 하나를 지정 하는 file 또는 code 키. (개체)
- 파일: 삽입 하는 스크립트의 URL.
- 코드: 스크립트 텍스트를 삽입 합니다.
콜백: 자바 스크립트 코드를 주입 후 실행 기능.
- 삽입 된 스크립트 유형의 경우 code , 스크립트의 반환 값은 단일 매개 변수는 콜백 실행에 싸여 있는 Array . 여러 줄 스크립트에 대 한 마지막 문 또는 평가 마지막 식의 반환 값입니다.

지원 되는 플랫폼

안 드 로이드
블랙베리
iOS

빠른 예제

var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
    ref.executeSript({file: "myscript.js"});
});

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>InAppBrowser.executeScript Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Global InAppBrowser reference
    var iabRef = null;

    // Inject our custom JavaScript into the InAppBrowser window
    //
    function replaceHeaderImage() {
        iabRef.executeScript({
            code: "var img=document.querySelector('#header img'); img.src='http://cordova.apache.org/images/cordova_bot.png';"
        }, function() {
            alert("Image Element Successfully Hijacked");
        }
    }

    function iabClose(event) {
         iabRef.removeEventListener('loadstop', replaceHeaderImage);
         iabRef.removeEventListener('exit', iabClose);
    }

    // device APIs are available
    //
    function onDeviceReady() {
         iabRef = window.open('http://apache.org', '_blank', 'location=yes');
         iabRef.addEventListener('loadstop', replaceHeaderImage);
         iabRef.addEventListener('exit', iabClose);
    }

    </script>
  </head>
  <body>
  </body>
</html>

insertCSS

주사로 CSS는 InAppBrowser 창.

ref.insertCSS(details, callback);

심판:에 대 한 참조는 InAppBrowser 창 (InAppBrowser)
injectDetails: 스크립트 실행의 세부 사항 중 하나를 지정 하는 file 또는 code 키. (개체)
- 파일: 삽입 하는 스타일 시트의 URL.
- 코드: 삽입 하는 스타일 시트의 텍스트.
콜백: CSS 주입 후 실행 기능.

지원 되는 플랫폼

안 드 로이드
블랙베리
iOS

빠른 예제

var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
    ref.insertCSS({file: "mystyles.css"});
});

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>InAppBrowser.insertCSS Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Global InAppBrowser reference
    var iabRef = null;

    // Inject our custom CSS into the InAppBrowser window
    //
    function changeBackgroundColor() {
        iabRef.insertCSS({
            code: "body { background: #ffff00"
        }, function() {
            alert("Styles Altered");
        }
    }

    function iabClose(event) {
         iabRef.removeEventListener('loadstop', changeBackgroundColor);
         iabRef.removeEventListener('exit', iabClose);
    }

    // device APIs are available
    //
    function onDeviceReady() {
         iabRef = window.open('http://apache.org', '_blank', 'location=yes');
         iabRef.addEventListener('loadstop', changeBackgroundColor);
         iabRef.addEventListener('exit', iabClose);
    }

    </script>
  </head>
  <body>
  </body>
</html>

InAppBrowserEvent

콜백 함수에 전달 되는 개체는 addEventListener 에 InAppBrowser 개체.

속성

유형: eventname, 중 loadstart , loadstop , loaderror , 또는 exit . (문자열)
url: URL 로드 된. (문자열)
코드: 오류 코드의 경우에만 loaderror . (수)
메시지: 오류 메시지의 경우에만 loaderror . (문자열)

window.open

새 URL을 엽니다 InAppBrowser 인스턴스, 현재 브라우저 인스턴스 또는 시스템 브라우저.

var ref = window.open(url, target, options);

심판:에 대 한 참조는 InAppBrowser 창. (InAppBrowser)
url: (문자열)를로드 하는 URL. 전화 encodeURI() 이 경우에는 URL 유니코드 문자를 포함 합니다.
대상: 대상 URL, 기본적으로 선택적 매개 변수를 로드 하는 _self . (문자열)
- _self: URL 화이트 리스트에 있으면 코르도바 WebView에서 열리고, 그렇지 않으면 열에InAppBrowser.
- _blank: 준공에InAppBrowser.
- _system: 시스템의 웹 브라우저에서 엽니다.
옵션: 옵션은 InAppBrowser . 선택적, 디폴트에: location=yes . (문자열)

options문자열 텅 빈 어떤 스페이스 포함 해서는 안 그리고 쉼표 각 기능의 이름/값 쌍을 구분 합니다. 기능 이름은 대/소문자입니다. 모든 플랫폼 지원 아래 값:
- 위치: 설정 yes 또는 no 설정 하는 InAppBrowser 의 위치 표시줄 켜거나 끕니다.
  
  안 드 로이드만
- closebuttoncaption -것입니다 "완료" 버튼에 대 한 캡션 문자열을 설정 합니다.
- 숨겨진 -'예'를 만들고 브라우저에서 페이지를 로드할 준비가 있지만 그것을 보여주지. Load 이벤트는 로드가 완료 되 면 발생 합니다. 생략 또는 브라우저를 열고 정상적으로 로드 '아니오' (기본값)으로 설정 합니다.
- clearcache -브라우저의 쿠키 캐시 새 창을 열기 전에 허가를 '예'로 설정
- clearsessioncache -새 창 열기 전에 해제 세션 쿠키 캐시를 '예'로 설정
  
  iOS만
- closebuttoncaption -것입니다 "완료" 버튼에 대 한 캡션 문자열을 설정 합니다. 참고 직접이 값을 지역화 해야 합니다.
- 숨겨진 -'예'를 만들고 브라우저에서 페이지를 로드할 준비가 있지만 그것을 보여주지. Load 이벤트는 로드가 완료 되 면 발생 합니다. 생략 또는 브라우저를 열고 정상적으로 로드 '아니오' (기본값)으로 설정 합니다.
- 도구 모음 -'예' 또는 '아니요'를 InAppBrowser (기본값은 '예')에 대 한 도구 모음 설정 또는 해제 설정
- enableViewportScale: 설정 yes 또는 no 뷰포트 메타 태그 (기본값:를 통해 확장을 방지 하기 위해no).
- mediaPlaybackRequiresUserAction: 설정 yes 또는 no HTML5 오디오 또는 비디오 자동 재생 (기본값에서에서 방지 하기 위해no).
- allowInlineMediaPlayback: 설정 yes 또는 no 장치 전용 재생 인터페이스 보다는 브라우저 창 내에서 표시 하는 인라인 HTML5 미디어 재생 허용. HTML의 video 요소가 포함 되어야 합니다는 webkit-playsinline 특성 (기본값:no)
- keyboardDisplayRequiresUserAction: 설정 yes 또는 no 양식 요소는 자바 스크립트를 통해 포커스를 받을 때 키보드를 열고 focus() 전화 (기본값:yes).
- suppressesIncrementalRendering: 설정 yes 또는 no (기본값을 렌더링 하기 전에 모든 새로운 보기 콘텐츠를 받을 때까지 기다려야no).
- presentationstyle: 설정 pagesheet , formsheet 또는 fullscreen 프레 젠 테이 션 스타일 (기본값을 설정 하려면fullscreen).
- transitionstyle: 설정 fliphorizontal , crossdissolve 또는 coververtical 전환 스타일 (기본값을 설정 하려면coververtical).

지원 되는 플랫폼

안 드 로이드
블랙베리
iOS
Windows Phone 7과 8

빠른 예제

var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref2 = window.open(encodeURI('http://ja.m.wikipedia.org/wiki/ハングル'), '_blank', 'location=yes');

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>window.open Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        // external url
        var ref = window.open(encodeURI('http://apache.org'), '_blank', 'location=yes');
        // relative document
        ref = window.open('next.html', '_self');
    }

    </script>
  </head>
  <body>
  </body>
</html>

Apache Cordova Documentation

InAppBrowser

가이드

API 참조

InAppBrowser

설명

메서드

기능 액세스

addEventListener

지원 되는 플랫폼

빠른 예제

전체 예제

removeEventListener

지원 되는 플랫폼

빠른 예제

전체 예제

닫기

지원 되는 플랫폼

빠른 예제

전체 예제

보기

지원 되는 플랫폼

빠른 예제

전체 예제

executeScript

지원 되는 플랫폼

빠른 예제

전체 예제

insertCSS

지원 되는 플랫폼

빠른 예제

전체 예제

InAppBrowserEvent

속성

window.open

안 드 로이드만

iOS만

지원 되는 플랫폼

빠른 예제

전체 예제