QML-тип WebView

Компонент для добавления веб-контента на страницу. Подробнее…

Строка импорта:

import .

Список всех членов класса, включая унаследованные

Свойства

active : bool
canGoBack : bool
canGoForward : bool
httpUserAgent : string
loadProgress : int
loaded : bool
loading : bool
popupProvider : PopupProvider
privateMode : bool
security : QMozSecurity
title : QString
url : QUrl
webViewPage : WebViewPage

Сигналы

contentOrientationChanged(Qt::ScreenOrientation orientation)
linkClicked(string url)
loadRedirect()
viewDestroyed()

Методы

clearSelection()
goBack()
goForward()
load(string url)
loadHtml(string html, url baseUrl)
loadText(string text, string mimeType)
reload()
runJavaScript(string script, variant callback, variant errorCallback)
stop()

Подробное описание

Компонент WebView позволяет добавлять веб-контент на QML-страницу.

QML-тип WebView предоставляется через импорт QML-модуля Sailfish.WebView.

Пример использования:

 import QtQuick 2.0
 import Sailfish.Silica 1.0
 import Sailfish.WebView 1.0

 ApplicationWindow {
     id: root
     initialPage: Component {
         WebViewPage {
             WebView {
                 anchors.fill: parent
                 url: "https://auroraos.ru/"
             }
         }
     }
 }

Опытные пользователи могут использовать дополнительные атрибуты или экспериментальные атрибуты.

См. также WebViewPage.

Описание свойств

active : bool

Свойство имеет значение true, когда WebView активно оценивает или отображает содержимое.

Если оно имеет противоположное значение, то компонент не будет отображать никакого контента.

Свойство active зависит от видимости приложения и статуса WebViewPage, если оно не установлено явно. Когда приложение или WebView скрыты для конечного пользователя, значение active должно быть false.

Прикосновение к содержимому переводит WebView в активное состояние.

Обычно разработчикам приложений не нужно изменять поведение по умолчанию.

[read-only] canGoBack : bool

Доступно ли действие навигации «назад».

Если пользователь перешёл на другую страницу, нажав на ссылку или установив свойство url, тогда будет доступна обратная навигация.

См. также goBack().

[read-only] canGoForward : bool

Доступно ли действие навигации «вперёд».

Если пользователь переместился назад (через goBack()) без последующей загрузки новой страницы, нажав на ссылку или установив свойство url, тогда будет доступна навигация вперёд.

См. также goForward().

httpUserAgent : string

Строка пользовательского агента, которая будет использоваться для запросов http/https.

Нужно установить это значение, чтобы переопределить строку пользовательского агента, которая будет использоваться для запросов http и https. Она будет отправлена в поле заголовка "User-Agent".

Установка этого значения переопределяет все остальные конфигурации пользовательского агента.

Если строка оставлена пустой или очищена, она будет установлена на фактическую строку пользовательского агента, используемую в начале каждого запроса. Если настроены переопределения домена, значение может зависеть от домена, к которому осуществляется доступ, и поэтому может снова измениться при будущих запросах.

Изменение значения в середине запроса не изменит поведение текущего запроса, но повлияет на любые будущие запросы.

По умолчанию это пустая строка.

[read-only] loadProgress : int

Ход загрузки (в процентах) текущей страницы.

Когда веб-представление начинает загружать новую страницу, это значение будет установлено на 1 (в процентах), а затем будет обновляться по мере загрузки большего количества контента. Когда загрузка будет завершена, это значение будет установлено на 100 (процентов).

loaded : bool

Успешно ли завершена загрузка содержимого веб-представления.

См. также load().

[read-only] loading : bool

Загружает ли веб-представление в настоящее время содержимое страницы.

См. также loadProgress and loaded.

popupProvider : PopupProvider

Поставщик пользовательских компонентов взаимодействия с пользователем

Клиентские приложения могут определять свои собственные пользовательские компоненты взаимодействия с пользователем, которые расширяют различные типы интерфейсов, определённые в пространстве имён Sailfish.WebView.Popups.

Для того, чтобы эти пользовательские компоненты использовались WebView, клиент должен зарегистрировать экземпляр PopupProvider (в котором указаны различные пользовательские компоненты, которые следует использовать) в WebView через данное свойство.

Это необязательное свойство.

См. также Popup Customization, PopupProvider и custompopups.

privateMode : bool

Находится ли веб-представление в режиме приватного просмотра.

Если включён приватный режим, история не будет храниться на устройстве.

Примечание. Значение этого свойства должно быть установлено при инициализации веб-представления. Любая попытка установить значение данного свойства после создания экземпляра веб-представления не будет иметь никакого эффекта.

[read-only] security : QMozSecurity

Предоставляет состояние TLS и возможности безопасного соединения с сайтом.

Тип QMozSecurity доступен в пространстве имён Qt5Mozilla.

[read-only] title : QString

Заголовок страницы текущего загруженного местоположения.

url : QUrl

URL-адрес загружается и отображается в веб-просмотре.

Клиенты могут установить данное свойство для перехода к новому местоположению. Если веб-представление перенаправлено, значение этого свойства будет автоматически обновлено.

См. также load().

webViewPage : WebViewPage

WebViewPage, в который встроен WebView.

Описание сигналов

contentOrientationChanged(Qt::ScreenOrientation orientation)

Сигнал испускается, когда изменяется ориентация экрана визуального содержимого.

linkClicked(string url)

Сигнал испускается, когда пользователь выбирает ссылку на странице.

При отправке значение url будет установленно как выбранная ссылка.

loadRedirect()

Испускается, если load() привела к перенаправлению.

viewDestroyed()

Испускается при уничтожении представления.

Описание методов

clearSelection()

Очищает любой активный в данный момент диапазон выделения текста.

goBack()

Возвращается к предыдущему местоположению в истории.

См. также canGoBack и goForward().

goForward()

Переходит к следующему местоположению в истории.

См. также canGoForward и goBack().

load(string url)

Загружает указанный url.

Это идентично установке свойства url на указанный url.

См. также url.

loadHtml(string html, url baseUrl)

Загружает указанный контент html, выполняя разрешение символов из заданного baseUrl.

loadText(string text, string mimeType)

Загружает указанный контент text, отображая его соответствующим образом для указанного mimeType.

reload()

Перезагружает текущий URL-адрес или содержимое.

runJavaScript(string script, variant callback, variant errorCallback)

Запускает фрагмент JavaScript в контексте загруженного документа DOM.

Когда script возвращает значение, вызывается callback-функция с единственным аргументом, который является возвращаемым значением. Аргумент callback является необязательным, если установлено значение undefined (по умолчанию), и возвращаемое значение будет отброшено.

Если функция не работает, вызывается errorCallback с единственным аргументом, содержащим строку ошибки. Аргумент errorCallback является необязательным, если установлено значение undefined (по умолчанию), любые ошибки молча игнорируются.

 runJavaScript("return document.title", function(result) { console.log("Document title is", result); });

Примечание: script должен иметь явный оператор return.

Примечание: в качестве возвращаемых значений script поддерживаются только базовые типы данных, а асинхронная функция или Promise для script не поддерживаются.

stop()

Останавливает загрузку текущего URL-адреса или контента.