goober-ionic/plugins/cordova-plugin-inappbrowser/doc/ru/index.md

cordova-plugin-inappbrowser

Этот плагин обеспечивает представление веб-браузера, что показывает при вызовеwindow.open().

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

Примечание: InAppBrowser окно ведет себя как стандартный веб-браузер и не может доступ API Cordova.

Установка

cordova plugin add cordova-plugin-inappbrowser

window.open

Открывает URL-адрес в новом InAppBrowser например, текущий экземпляр браузера или браузера системы.

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

• ссылка: ссылка для InAppBrowser окно. (InAppBrowser)

• URL: URL-адрес для загрузки (String). Вызвать encodeURI() на это, если URL-адрес содержит символы Unicode.

• Цель: цель для загрузки URL-адреса, необязательный параметр, по умолчанию _self . (Строка)

  • _self: Открывается в Cordova WebView, если URL-адрес в белый список, в противном случае он открывается вInAppBrowser.
  • _blank: Открывает вInAppBrowser.
  • _system: Открывается в веб-браузера системы.

• опции: параметры для InAppBrowser . Необязательный параметр, виновная в: location=yes . (Строка)

  optionsСтрока не должна содержать каких-либо пустое пространство, и каждая функция пар имя/значение должны быть разделены запятой. Функция имена нечувствительны к регистру. Все платформы поддерживают исходное значение:

  • Расположение: равным yes или no превратить InAppBrowser в адресную строку или выключить.

  Только андроид:

  • closebuttoncaption: задайте строку для использования в качестве заголовка кнопки сделали .
  • скрытые: значение yes для создания браузера и загрузки страницы, но не показать его. Событие loadstop возникает, когда загрузка завершена. Опустить или набор no (по умолчанию), чтобы браузер открыть и загрузить нормально.
  • ClearCache: набор yes иметь браузера куки кэш очищен перед открытием нового окна
  • clearsessioncache: значение yes иметь кэш cookie сеанса очищается перед открытием нового окна

  только iOS:

  • closebuttoncaption: задайте строку для использования в качестве заголовка кнопки сделали . Обратите внимание, что вам нужно самостоятельно локализовать это значение.
  • disallowoverscroll: значение yes или no (по умолчанию no ). Включает/отключает свойство UIWebViewBounce.
  • скрытые: значение yes для создания браузера и загрузки страницы, но не показать его. Событие loadstop возникает, когда загрузка завершена. Опустить или набор no (по умолчанию), чтобы браузер открыть и загрузить нормально.
  • ClearCache: набор yes иметь браузера куки кэш очищен перед открытием нового окна
  • clearsessioncache: значение yes иметь кэш cookie сеанса очищается перед открытием нового окна
  • панели инструментов: набор yes или no для включения панели инструментов или выключить InAppBrowser (по умолчаниюyes)
  • enableViewportScale: значение yes или no для предотвращения просмотра, масштабирования через тег meta (по умолчаниюno).
  • mediaPlaybackRequiresUserAction: значение yes или no для предотвращения HTML5 аудио или видео от Автовоспроизведение (по умолчаниюno).
  • allowInlineMediaPlayback: значение yes или no чтобы разрешить воспроизведение мультимедиа HTML5 в строки, отображения в окне браузера, а не конкретного устройства воспроизведения интерфейс. HTML video элемент должен также включать webkit-playsinline атрибут (по умолчаниюno)
  • keyboardDisplayRequiresUserAction: значение yes или no чтобы открыть клавиатуру, когда формы элементы получают фокус через JavaScript в focus() вызов (по умолчаниюyes).
  • suppressesIncrementalRendering: значение yes или no ждать, пока все новое содержание представление получено до визуализации (по умолчаниюno).
  • presentationstyle: набор pagesheet , formsheet или fullscreen чтобы задать стиль презентации (по умолчаниюfullscreen).
  • transitionstyle: набор fliphorizontal , crossdissolve или coververtical чтобы задать стиль перехода (по умолчаниюcoververtical).
  • toolbarposition: значение top или bottom (по умолчанию bottom ). Вызывает панели инструментов, чтобы быть в верхней или нижней части окна.

  Windows только:

  • скрытые: значение yes для создания браузера и загрузки страницы, но не показать его. Событие loadstop возникает, когда загрузка завершена. Опустить или набор no (по умолчанию), чтобы браузер открыть и загрузить нормально.

Поддерживаемые платформы

• Amazon Fire OS
• Android
• BlackBerry 10
• Firefox OS
• iOS
• Windows 8 и 8.1
• 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');

Особенности Firefox OS

Как плагин не применять любой дизайн есть необходимость добавить некоторые правила CSS, если открыт с target='_blank' . Правила может выглядеть как эти

 css
.inAppBrowserWrap {
  background-color: rgba(0,0,0,0.75);
  color: rgba(235,235,235,1.0);
}
.inAppBrowserWrap menu {
  overflow: auto;
  list-style-type: none;
  padding-left: 0;
}
.inAppBrowserWrap menu li {
  font-size: 25px;
  height: 25px;
  float: left;
  margin: 0 10px;
  padding: 3px 10px;
  text-decoration: none;
  color: #ccc;
  display: block;
  background: rgba(30,30,30,0.50);
}
.inAppBrowserWrap menu li.disabled {
    color: #777;
}

Внутренний браузер

Объект, возвращаемый из вызоваwindow.open.

Методы

• addEventListener
• removeEventListener
• close
• show
• executeScript
• insertCSS

addEventListener

Добавляет прослушиватель для события отInAppBrowser.

ref.addEventListener(eventname, callback);

• ссылка: ссылка для InAppBrowser окно (InAppBrowser)

• EventName: событие для прослушивания (String)

  • loadstart: событие возникает, когда InAppBrowser начинает для загрузки URL-адреса.
  • loadstop: событие возникает, когда InAppBrowser завершит загрузку URL-адреса.
  • loaderror: событие возникает, когда InAppBrowser обнаруживает ошибку при загрузке URL-адреса.
  • выход: возникает событие, когда InAppBrowser окно закрыто.

• обратного вызова: функция, которая выполняется, когда возникает событие. Функция передается InAppBrowserEvent объект в качестве параметра.

InAppBrowserEvent свойства

• тип: eventname, либо loadstart , loadstop , loaderror , или exit . (Строка)

• URL: URL-адрес, который был загружен. (Строка)

• код: код ошибки, только в случае loaderror . (Число)

• сообщение: сообщение об ошибке, только в случае loaderror . (Строка)

Поддерживаемые платформы

• Amazon Fire OS
• Android
• iOS
• Windows 8 и 8.1
• Windows Phone 7 и 8

Краткий пример

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

метод removeEventListener

Удаляет прослушиватель для события отInAppBrowser.

ref.removeEventListener(eventname, callback);

• ссылка: ссылка для InAppBrowser окно. (InAppBrowser)

• EventName: событие прекратить прослушивание. (Строка)

  • loadstart: событие возникает, когда InAppBrowser начинает для загрузки URL-адреса.
  • loadstop: событие возникает, когда InAppBrowser завершит загрузку URL-адреса.
  • loaderror: событие возникает, когда InAppBrowser обнаруживает ошибку загрузки URL-адреса.
  • выход: возникает событие, когда InAppBrowser окно закрывается.

• обратного вызова: функция, выполняемая когда это событие наступает. Функция передается InAppBrowserEvent объект.

Поддерживаемые платформы

• Amazon Fire OS
• Android
• iOS
• Windows 8 и 8.1
• Windows Phone 7 и 8

Краткий пример

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

close

Закрывает InAppBrowser окно.

Ref.Close();

• ссылка: ссылка на InAppBrowser окно (InAppBrowser)

Поддерживаемые платформы

• Amazon Fire OS
• Android
• Firefox OS
• iOS
• Windows 8 и 8.1
• Windows Phone 7 и 8

Краткий пример

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

show

Отображается окно InAppBrowser, был открыт скрытые. Вызов это не имеет эффекта при InAppBrowser уже был виден.

Ref.Show();

• ссылка: ссылка на окно (InAppBrowserInAppBrowser)

Поддерживаемые платформы

• Amazon Fire OS
• Android
• iOS
• Windows 8 и 8.1

Краткий пример

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

executeScript

Вставляет код JavaScript в InAppBrowser окно

ref.executeScript(details, callback);

• ссылка: ссылка на InAppBrowser окно. (InAppBrowser)

• injectDetails: подробности сценария для запуска, указав либо file или code ключ. (Объект)

  • файл: URL-адрес сценария вставки.
  • код: текст сценария для вставки.

• обратного вызова: функция, которая выполняет после вводят JavaScript-код.

  • Если введенный скрипт имеет тип code , обратный вызов выполняется с одним параметром, который является возвращаемое значение сценария, завернутые в Array . Для многострочных сценариев это возвращаемое значение последнего оператора, или последнее вычисленное выражение.

Поддерживаемые платформы

• Amazon Fire OS
• Android
• iOS
• Windows 8 и 8.1

Краткий пример

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

insertCSS

Внедряет CSS в InAppBrowser окно.

ref.insertCSS(details, callback);

• ссылка: ссылка на InAppBrowser окно (InAppBrowser)

• injectDetails: детали сценария для запуска, указав либо file или code ключ. (Объект)

  • файл: URL-адрес таблицы стилей для вставки.
  • код: текст таблицы стилей для вставки.

• обратного вызова: функция, которая выполняет после вводят CSS.

Поддерживаемые платформы

• Amazon Fire OS
• Android
• iOS

Краткий пример

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