Тип 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.