Тип QML WebView

Компонент для отображения веб-контента. Подробнее...

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

Свойства

• canGoBack : bool
• canGoForward : bool
• httpUserAgent : url
• loadProgress : int
• loading : bool
• title : string
• url : url

Сигналы

• loadingChanged(WebViewLoadRequest loadRequest)

Методы

• void goBack()
• void goForward()
• void loadHtml(string html, url baseUrl)
• void reload()
• void runJavaScript(string script, variant callback)
• void stop()

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

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

Для правильной работы модуля Qt WebView на всех платформах необходимо вызвать QtWebView::initialize() сразу после создания экземпляра QGuiApplication.

Примечание: Из-за ограничений платформы перекрытие WebView и других компонентов QML не поддерживается.

Документация по свойствам

[только для чтения] canGoBack : bool

Содержит true , если в настоящее время можно перейти назад в истории веб-страниц.

[только для чтения] canGoForward : bool

Содержит true , если в настоящее время можно перейти вперёд в истории веб-страниц.

httpUserAgent : url

Используемый пользовательский агент.

Примечание: в WinRT это свойство влияет на все WebView приложения.

Это свойство было добавлено в QtWebView 1.14.

[только для чтения] loadProgress : int

Текущая степень загрузки веб-контента, представленная целым числом от 0 до 100.

[только для чтения] loading : bool

Содержит true , если WebView в настоящее время загружает новый контент, false в противном случае.

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

[только для чтения] title : string

Заголовок текущей загруженной веб-страницы.

url : url

URL текущей загруженной веб-страницы. Изменение этого значения инициирует загрузку нового контента.

URL используется как есть. URL, полученные от пользователя, следует анализировать с помощью QUrl::fromUserInput().

Примечание: WebView не поддерживает загрузку контента через систему ресурсов Qt.

Документация по сигналам

loadingChanged(WebViewLoadRequest loadRequest)

Этот сигнал излучается при изменении состояния загрузки веб-контента. Обработка этого сигнала позволяет, например, реагировать на ошибки загрузки страниц.

Параметр loadRequest содержит url и status запроса, а также errorString с сообщением об ошибке для неудачного запроса.

Примечание: Соответствующий обработчик — onLoadingChanged.

См. также WebViewLoadRequest.

Документация по методам

void goBack()

Переходит назад в истории веб-страниц.

void goForward()

Переходит вперёд в истории веб-страниц.

void loadHtml(string html, url baseUrl)

Загружает указанный контент html в веб-представление.

Этот метод предлагает альтернативу более низкого уровня свойству url, которое ссылается на HTML-страницы через URL.

Внешние объекты, такие как таблицы стилей или изображения, упомянутые в HTML-документе, должны быть расположены относительно baseUrl. Например, если html получен из http://www.example.com/documents/overview.html, что является базовым URL, то изображение, на которое ссылается относительный URL diagram.png, должно находиться по адресу http://www.example.com/documents/diagram.png.

Примечание: WebView не поддерживает загрузку контента через систему ресурсов Qt.

См. также url.

void reload()

Перезагружает текущий url.

void runJavaScript(string script, variant callback)

Выполняет указанный JavaScript. Если предоставлена функция callback, она будет вызвана после завершения выполнения script.

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

void stop()

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