Тип WebView QML

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

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

Свойства

• 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 и статус запроса, а также 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.