Тип WebView QML

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

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

Свойства

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

Сигналы

• loadingChanged(loadRequest)

Методы

• void goBack()
• void goForward()
• void loadHtml(html, url baseUrl)
• void reload()
• void runJavaScript(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 Resource system.

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

loadingChanged(loadRequest)

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

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

См. также WebViewLoadRequest.

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

void goBack()

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

void goForward()

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

void loadHtml(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 Resource system.

См. также url.

void reload()

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

void runJavaScript(script, variant callback)

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

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

void stop()

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