Тип QML WebView

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

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

Свойства

• canGoBack : bool
• canGoForward : bool
• 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, если в настоящее время можно перейти вперёд в истории веб-страниц.

[только для чтения] 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 с сообщением об ошибке для неудачного запроса.

См. также 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.