Тип WebView QML

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

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

Свойства

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

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(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.

См. также url.

void reload()

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

void runJavaScript(script, variant callback)

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

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

void stop()

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