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