Браузер
16.05.2019
Браузер создаётся с использованием конструктора CreateWebView:
app.CreateWebView( float width, float height, ([str]) options, float zoom )
Параметры:
- width - ширина текстовой области
- height - высота текстовой области
- options:
- Опции действий:
- AllowZoom - разрешить жесты для масштабирования
- AutoZoom - автомасштабирование
- IgnoreErrors - игнорировать ошибки
- Fast - приоритет прорисовки контента
- ScrollFade - исчезающие полосы прокрутки
- Overview - загрузка страниц в полностью уменьбшенном масштабе
- UseBasicInput - выключает отображение строки ввода при отображении клавиатуры
- UseBrowser - для открытия ссылок использовать браузер по умолчанию
- Wide - включает поддержку метатега viewport. Широкая область просмотра используется при отсутствии метатега
- NoApp - запретить вызов методов вида app.*
- NoCors - запретить кроссдоменные вызовы
- NoLocate - отключить геолокацию (по умолчанию она включена)
- NoCapture- отключить захват видео/аудио (по умолчанию она включён)
- AllowCapture - разрешить использовать камеру и микрофон, а также WebRTC
- NoActionBar - предотвращает появление панели действий для копирования/вставки текста на странице
- GameView - не документировано
- Опции оформления опций:
- NoScrollBar- окно без полос прокрутки
- NoLongTouch - отключает реакцию на долгое касание
- Progress - отображает значок загрузки
- zoom - увеличение
Браузер имеет непрозрачный фон.
Базовый пример
Выполнить в DS
Методы:
- Back() - осуществляет переход на предыдущую в истории посещений страницу
Выполнить в DS
myObject.Back();
- CanGoBack():bool - сообщает, можно ли перейти на предыдущую страницу в истории посещений
Выполнить в DS
app.ShowPopup( myObject.CanGoBack() );
- CanGoForward():bool - сообщает, можно ли перейти на следующую страницу в истории посещений
Выполнить в DS
app.ShowPopup( myObject.CanGoForward() );
- Capture( str file ) - сохраняет снимок содержимого браузера в файл
Выполнить в DS
myObject.Capture( '/sdcard/myimage.jpeg' );
- ClearHistory() - очищает список посещённых страниц
Выполнить в DS
myObject.ClearHistory();
- Execute( str code,callback ) - выполняет код JavaScript в WebView
- Forward() - осуществляет переход на следующую в истории посещений страницу
Выполнить в DS
myObject.Forward();
- GetType():str - возвращает тип объекта
Выполнить в DS
app.ShowPopup( myObject.GetType() );
- GetUrl():str - возвращает адрес загруженной страницы
Выполнить в DS
app.ShowPopup( myObject.GetUrl() );
- LoadHtml( str html, str base, str options ) - загружает текст с html-разметкой в WebViewer. Возможны опции
- "autozoom" - автомасштабирование под ширину области браузера
- "wide" - включает поддержку метатегов области. Широкая область просмотра при отсутствии метатегов
- "nolongtouch" - отключает реакцию на долгое касание.
Выполнить в DS
myObject.LoadHtml( '
Page
');
- LoadUrl( str url, [(str)] options ) - загружает в WebViewer страницу по заданному адресу. Возможны опции
- "autozoom" - автомасштабирование под ширину области браузера
- "wide" - включает поддержку метатегов области. Широкая область просмотра при отсутствии метатегов
- "nolongtouch" - отключает реакцию на долгое касание.
Выполнить в DS
myObject.LoadUrl( 'http:\/\/www.google.com' );
- Print() - выводит страницу на печать
Выполнить в DS
myObject.Print();
- Reload() - перезагружает страницу
Выполнить в DS
myObject.Reload();
- SetOnConsole( callback( str message, str lineNum, str sourceFile, bool isError ) ) - определяет ФОВ для задания действия при выводе сообщения/ошибки в консоль
методами console.log/c
console.error
Выполнить в DS
myObject.SetOnConsole( function( message, lineNum, sourceFile, isError ){ app.ShowPopup( 'Сообщение: ' + message + ' номер строки: ' + lineNum + ' файл: ' + sourceFile +' это ошибка: ' + isError });
- SetOnError( callback( str errNum, str errMsg, str url ) ) - определяет ФОВ для задания действия при возникновении ошибки
Выполнить в DS
myObject.SetOnError( function( p_errNum, p_errMsg, p_url ){ app.ShowPopup( 'Произошла ошибка!' + p_errNum + p_errMsg + p_url ); });
- SetOnProgress( callback ) - определяет ФОВ для задания действия при загрузке страницы
Выполнить в DS
myObject.SetOnProgress( function(){ app.ShowPopup( 'Страница загружается' ); });
- SetOnTouch( callback ) - определяет ФОВ для задания действия при касании области браузера
Выполнить в DS
myObject.SetOnTouch( function(){ app.ShowPopup( 'Касание выполнено' ); });
- SetTouchMode( mode ) - определяет режим касания (не документировано)
- SetRedirect( str urlFrom, str urlTo) - задаёт перенаправление
Выполнить в DS
myObject.SetRedirect('http://mysite.ru/index.html','http://mysite.ru/index1.html');
- SetUserAgent( str agent ) - устанавливает идентифицирующую клиентское приложение строку. Можно использовать для анонимного входа
Выполнить в DS
myObject.SetUserAgent( navigator.userAgent );
- SetUserCreds( str name, str password ) - задаёт имя пользователя и пароль для авторизации
Выполнить в DS
myObject.SetUserCreds( 'myname', 'mypassword');
- SimulateKey( str keyName, str modifiers, int pause ) - эмулирует нажатие на клавишу в полях ввода
Выполнить в DS
myObject.SimulateKey('w' , 'SHIFT_LEFT_ON');