WebView

Представляет экземпляр WebView, который отображает веб-страницы. Подробнее...

Подключение:

#include <webview.h>

Диаграмма наследования для Aurora::WebView::WebView:

Сигналы

void	urlChanged (QString url) Сигнал о смене URL-адреса. Подробнее...
void	titleChanged (QString title) Сигнал о смене заголовка. Подробнее...
void	loadingChanged (bool status) Сигнал об изменении состояния загрузки. Подробнее...
void	loadingProgressChanged (double progress) Испускается при изменении хода загрузки. Подробнее...
void	loadStart () Сигнал о начале загрузки основного кадра.
void	documentAvailable () Сигнал о доступности основного фрейма документа.
void	loadFinished (int httpStatusCode) Сигнал о завершении загрузки. Подробнее...
void	loadError (QString url, int errorCode) Сигнал об ошибке загрузки. Подробнее...
void	recvAsyncMessage (const QString name, const QVariant data) Сигнал о получении асинхронного сообщения от кода JavaScript. Подробнее...
void	userAgentChanged () Сигнал об изменении User-Agent.
void	formFactorChanged () Сигнал об изменении форм-фактора устройства.
void	userAgentOverrideChanged () Сигнал об изменении режима переопределения User-Agent.
void	findResultAvailable (int identifier, int count, QRect selectionRect, int activeMatchOrdinal, bool finalUpdate) Посылает сигнал, сообщающий о результатах поиска. Подробнее...
void	scrollOffsetXChanged () Испускается при изменении смещения прокрутки по оси X.
void	scrollOffsetYChanged () Испускается при изменении смещения прокрутки по оси Y.
void	fullscreenModeChanged (bool fullscreen) Испускается при активации или деактивации полноэкранного режима. Подробнее…
void	pwaManifestChanged (QString manifestUrl) Испускается при обновлении url манифеста PWA. Подробнее....
void	closing () Испускается, когда WebView запрашивается на закрытие.

Публичные функции-члены

	WebView (QObject *parent=Q_NULLPTR, bool isPrivate=false, bool isPopup=false) Экземпляр станет функциональным только после инициализации WebEngineContext.
Q_INVOKABLE void	reload () override Перезагружает открытый URL.
Q_INVOKABLE void	stopLoad () override Останавливает загрузку URL, если загрузка идёт.
Q_INVOKABLE void	startRender () override Продолжает рендеринг.
Q_INVOKABLE void	stopRender () override Приостаналивает рендеринг (изображение станет неподвижным, использование ресурсов устройства уменьшится).
Q_INVOKABLE void	find (const QString &text, bool forward, bool matchCase, bool findNext) override Ищет текст на веб-странице. Подробнее...
Q_INVOKABLE void	stopFinding (bool clearSelection) override Отменяет все активные в данный момент поиски. Подробнее...
Q_INVOKABLE bool	canGoBack () override Возвращает true, если WebView может перемещаться в обратном направлении.
Q_INVOKABLE void	goBack () override Переход к предыдущей странице в истории WebView.
Q_INVOKABLE bool	canGoForward () override Возвращает true, если WebView может перемещаться вперёд.
Q_INVOKABLE void	goForward () override Переход на следующую страницу в истории WebView.
int	id () const override Уникальный идентификатор.
bool	isValid () const override true, если WebView является действительным.
QString	url () const override URL-адрес загруженного в данный момент.
void	setUrl (const QString &url) override Сеттер свойств URL.
QString	title () const override Текущий заголовок загруженной веб-страницы.
bool	loading () const override Проверяет, загружает ли экземпляр WebView веб-страницу.
double	loadingProgress () const override Текущий прогресс загрузки, диапазон от 0,0 до 1,0.
QString	userAgent () const override Пользовательский агент.
void	setUserAgent (const QString &userAgent) override
qreal	DPR () const override Коэффициент пикселей устройства.
void	setDPR (qreal DRP) override Устанавливает DPR. Нужно перезагрузить, чтобы применить новое значение.
QRect	renderRect () const override Область для отображения контента.
void	setRenderRect (QRect renderRect) override Область для отображения контента.
void	setOrientation (int orientation) override
void	updateSize (const QRectF rect) override
double	scrollOffsetX () const override Текущее смещение прокрутки по оси X.
double	scrollOffsetY () const override Текущее смещение прокрутки по оси Y.
int	formFactor () const override Форм-фактор устройства.
void	setFormFactor (int mode) override Устанавливает форм-фактор устройства.
bool	userAgentOverride () const override Режим переопределения User-Agent.
QString	pwaManifest () override Получает URL-адрес PWA манифеста текущего сайта (если он есть). Подробнее...
Q_INVOKABLE void	setInsets (int top, int right, int bottom, int left) override
Q_INVOKABLE void	loadHtml (const QString &html) override Загружает необработанный HTML-текст.
Q_INVOKABLE void	clearTextSelection () override Очищает выделение текста.
Q_INVOKABLE void	runJavaScript (const QString &script, const QJSValue &callback, const QJSValue &errorCallback) override
Q_INVOKABLE void	sendAsyncMessage (const QString &name, const QVariant &data) override
Q_INVOKABLE void	addMessageListener (const QString &name) override Регистрирует прослушиватель асинхронных сообщений с указанным name.
Q_INVOKABLE void	exitFullscreenMode () override Выходит из полноэкранного режима.
IRendering *	renderingExtension () const override
IInputExtension *	inputExtension () const override
ITextExtension *	textExtension () const override
IContextMenuExtension *	contextMenuExtension () const override
IPdfPrint *	pdfPrintExtension () const override
IMediaPlaybackExtension *	mediaPlaybackExtension () const override
IOverscrollExtension *	overscrollExtension () const override
ILoadRequestExtension *	loadRequestExtension () const override
IPopupExtension *	popupExtension () const override
IFaviconExtension *	faviconExtension () const override
IConnectionInfoExtension *	connectionInfoExtension () const override
IJavaScriptExtension *	javaScriptExtension () const override

Свойства

int	id Уникальный идентификатор текущего устройства.
QString	url
QString	title Заголовок загруженного URL (веб-страницы). Может быть пустым.
bool	loading Возвращает true, когда экземпляр WebView загружает URL.
double	loadingProgress Текущий прогресс загрузки, диапазон от 0,0 до 1,0.
QString	userAgent
qreal	dpr Коэффициент пикселей устройства.
QRect	renderRect Область для отображения контента.
double	scrollOffsetX Текущее значение смещения прокрутки только для чтения по оси x.
double	scrollOffsetY Текущее значение смещения прокрутки только для чтения по оси y.
int	formFactor
bool	userAgentOverride
QString	pwaManifest URL к манифесту PWA приложения (будет пустым если манифеста нет или сайт еще загружается).

Подробное описание

Представляет экземпляр WebView, который отображает веб-страницы.

WebView — это основной класс библиотеки WebView. Он отображает веб-страницы и предоставляет для них механизмы взаимодействия.

Можно создать несколько WebView для одновременного отображения различных веб-страниц.

Например, вкладки веб-браузера могут быть реализованы как отдельные экземпляры WebView.

Описание функций-членов

find()

Q_INVOKABLE void Aurora::WebView::WebView::find (const QString & text, bool forward, bool matchCase, bool findNext)

override

Поиск текста на веб-странице.

Параметры

text	Текст для поиска.
forward	Указывает, следует ли выполнять поиск вперёд или назад на странице.
matchCase	Указывает, следует ли учитывать регистр при поиске.
findNext	Указывает, следует ли переходить к следующему найденному элементу и выделять его или нет.

Пример использования

findResultAvailable

void Aurora::WebView::WebView::findResultAvailable (int identifier, int count, QRect selectionRect, int activeMatchOrdinal, bool finalUpdate)

signal

Отправляется сигнал для сообщения результатов поиска.

Для каждого вызова функции CEF Find функция FindHandler вызывается один или несколько раз. Если элемент не найден, будет выполнен только один вызов FindHandler с параметром finalUpdate, установленным как true. Если найдено несколько элементов, FindHandler вызывается несколько раз. Последний вызов FindHandler имеет параметр finalUpdate, установленный как true.

Параметры

identifier	Идентификатор текущего уведомления о поиске.
count	Количество совпадений, определённых в данный момент.
selectionRect	Местоположение, где было найдено совпадение (в координатах окна).
activeMatchOrdinal	Порядковый номер этой позиции в результатах поиска.
finalUpdate	Истинно, если это последний вызов FindHandler для данного запроса Find.

fullscreenModeChanged

void Aurora::WebView::WebView::fullscreenModeChanged (bool fullscreen)

signal

Испускается при активации или деактивации полноэкранного режима.

Параметры

fullscreen

true, если был активирован полноэкранный режим.

loadError

void Aurora::WebView::WebView::loadError (QString url, int errorCode)

signal

Сигнал об ошибке загрузки.

Параметры

url	URL, который привёл к ошибке.
errorCode	Код ошибки. См. NetError.

loadFinished

void Aurora::WebView::WebView::loadFinished (int httpStatusCode)

signal

Сигнал об окончании нагрузки.

Параметры

httpStatusCode

Код состояния, возвращаемый сервером.

loadingChanged

void Aurora::WebView::WebView::loadingChanged (bool status)

signal

Испускается при изменении статуса загрузки.

Параметры

status

Статус загрузки. true, если загружается URL.

loadingProgressChanged

void Aurora::WebView::WebView::loadingProgressChanged (double progress)

signal

Испускается при изменении хода загрузки.

Параметры

progress

Определяет прогресс загрузки страницы, диапазон от 0,0 до 1,0.

pwaManifest()

QString Aurora::WebView::WebView::pwaManifest ()

override

Получает URL-адрес PWA манифеста текущего сайта (если он есть).

Возвращает URL-адрес манифеста (пустой, если не существует).

pwaManifestChanged

void Aurora::WebView::WebView::pwaManifestChanged (QString manifestUrl)

signal

Испускается при обновлении url манифеста PWA.

Обновление url манифеста PWA происходит при обнаружении PWA на текущем сайте или при изменении url текущего веб-просмотра.

Параметры

manifestUrl

url для манифест PWA, может быть пустой, если PWA недоступен или если страница еще загружается.

recvAsyncMessage

void Aurora::WebView::WebView::recvAsyncMessage (const QString name, const QVariant data)

signal

Сигнал о получении асинхронного сообщения из кода JavaScript.

Параметры

name	Название сообщения.
data	Данные сообщения.

runJavaScript()

Q_INVOKABLE void Aurora::WebView::WebView::runJavaScript (const QString & script, const QJSValue & callback, const QJSValue & errorCallback)

override

Запускает фрагмент JavaScript в контексте загруженного документа.

Пример использования

sendAsyncMessage()

Q_INVOKABLE void Aurora::WebView::WebView::sendAsyncMessage (const QString & name, const QVariant & data)

override

Отправляет асинхронное сообщение с указанными name и data.

Пример использования

setInsets()

Q_INVOKABLE void Aurora::WebView::WebView::setInsets (int top, int right, int bottom, int left)

override

Устанавливает значения отступов.

Значения определяют прямоугольник по его верхнему, правому, нижнему и левому отступам от края области просмотра, в который можно безопасно помещать содержимое, не рискуя, что оно будет обрезано формой непрямоугольного дисплея. Глобальные переменные CSS (safe-area-inset-*) принимают соответственно эти значения. Значения вступают в силу только в полноэкранном режиме. Чтобы сбросить отступы, следует передать обнулённые параметры отступа.

setUserAgent()

void Aurora::WebView::WebView::setUserAgent (const QString & userAgent)

override

Устанавливает User-Agent. Для применения нового значения требуется перезагрузка страницы.

Пустая строка отключает режим переопределения и устанавливает значение по умолчанию.

stopFinding()

Q_INVOKABLE void Aurora::WebView::WebView::stopFinding (bool clearSelection)

override

Отменяет все активные в данный момент поиски.

Параметры

clearSelection

Очистить текущий выбор.

titleChanged

void Aurora::WebView::WebView::titleChanged (QString title)

signal

Сигнал об изменении названия.

Параметры

title

Заголовок веб-страницы.

urlChanged

void Aurora::WebView::WebView::urlChanged (QString url)

signal

Сигнал об изменении URL.

Параметры

url	Загруженный URL.

Описание свойств

formFactor

int Aurora::WebView::WebView::formFactor

read write

Подсказка по форм-фактору устройства. Используются значения из DeviceMode::FormFactor.

Имеет эффект только когда userAgent — значение по умолчанию.

Пример использования

url

QString Aurora::WebView::WebView::url

read write

URL загруженной веб-страницы.

Установка этого свойства приводит к загрузке новой веб-страницы.

При успешной загрузке испускается сигнал loadFinished(), при неудаче испускается сигнал loadError().

userAgent

QString Aurora::WebView::WebView::userAgent

read write

User-Agent.

При установке значения userAgentOverride становится true.

formFactor действует только когда userAgent имеет значение по умолчанию.

Следует установить пустое значение, чтобы сбросить userAgent до значения по умолчанию.

Пример использования

userAgentOverride

bool Aurora::WebView::WebView::userAgentOverride

read

true, если свойству userAgent присвоено некоторое пользовательское значение, в противном случае false.

Пример использования