Экспериментальные атрибуты WebView

Каждое из свойств, сигналов и методов, предоставляемых WebView, относится к одной из трёх следующих категорий:

Стабильные атрибуты согласно документации типа WebView.
Дополнительные атрибуты.
Экспериментальные атрибуты.

В этой статье описаны экспериментальные атрибуты WebView. Маловероятно, что эти экспериментальные атрибуты будут использоваться подавляющим большинством разработчиков приложений, однако они позволяют разработчикам полностью контролировать то, как контент отображается в их приложении.

Разработчики WebView оставляют за собой право изменять или удалять любые из этих атрибутов в будущих версиях Sailfish.WebView.

Свойства

WebView::contentRect

Свойство типа rect только для чтения.

Прямоугольная ограничительная рамка, определяемая загруженным содержимым, отображаемым в области просмотра веб-представления.

Содержимое загруженной страницы, вероятно, заполнит область, намного большую, чем область просмотра веб-представления (таким образом, пользователю потребуется прокрутить область просмотра, чтобы увидеть содержимое дальше по странице и т. д.).

Свойство обеспечивает прямоугольную ограничительную рамку текущего окна просмотра для содержимого в пикселях CSS (то есть ещё не масштабированном с учётом коэффициента разрешения устройства). Положение x и y прямоугольника содержимого описывает верхний левый пиксель содержимого, отображаемого в области просмотра. Ширину и высоту прямоугольника содержимого можно комбинировать с позициями x и y, чтобы определить верхний правый, нижний левый и нижний правый пиксели содержимого, отображаемого в области просмотра.

Следует обратить внимание, что ширина содержимого и высота содержимого будут отличаться от ширины и высоты области просмотра, только если содержимое меньше, чем область просмотра, или если к области просмотра применяется некоторый коэффициент масштабирования из-за разрешения экрана устройства.

Для получения дополнительной информации об этих концепциях см. соответствующую документацию Mozilla о CSS-пикселях и окнах просмотра.

См. также: WebView::contentWidth, WebView::contentHeight, WebView::viewportWidth, WebView::viewportHeight, WebView::scrollableSize, WebView::resolution

WebView::contentWidth

Свойство типа real только для чтения.

Ширина (в пикселях CSS) прямоугольника ограничительной рамки, определяемая загруженным содержимым, отображаемым веб-просмотром.

См. также: WebView::contentRect

WebView::contentHeight

Свойство типа real только для чтения.

Высота (в пикселях CSS) прямоугольника ограничительной рамки, определяемая загруженным содержимым, отображаемым веб-просмотром.

См. также: WebView::contentRect

WebView::scrollableSize

Свойство типа size только для чтения.

Геометрический размер содержимого, отображаемого веб-представлением, в пикселях устройства.

Свойство содержит общий размер контента в пикселях устройства.

См. также: WebView::contentRect, WebView::scrollableOffset

WebView::scrollableOffset

Свойство типа point только для чтения.

Смещение (пикселей x и y) в прокручиваемый размер, который описывает верхний левый пиксель содержимого, отображаемого в области просмотра.

Значение этого свойства фактически равно значению x и y значений WebView::contentRect после применения соответствующего масштабирующего коэффициента resolution (для отображения из пиксельных CSS-координат в пиксельные координаты с разрешением устройства).

См. также: WebView::contentRect, WebView::scrollableSize, WebView::resolution

WebView::resolution

Свойство типа float только для чтения.

Масштабирующий коэффициент, который применяется к значениям contentRect (CSS-пиксель) для сопоставления с соответствующими пиксельными координатами разрешения устройства с учетом настройки веб-движка pixelRatio.

Значение этого свойства равно ширине экрана устройства, делённой на ширину contentRect. Таким образом, он будет обновляться, когда пользователь увеличивает или уменьшает масштаб (таким образом, изменяя ширину в пикселях CSS для contentRect), или если изменяется ориентация страницы (что приводит к изменению ориентации на альбомную с портретной или наоборот).

Следует обратить внимание, что в настоящее время сигнал об изменении этого свойства не испускается.

См. также: WebView::contentRect, WebEngineSettings::pixelRatio

WebView::horizontalScrollDecorator

Свойство типа QmlMozScrollDecorator только для чтения.

Горизонтальная полоса прокрутки.

Тип QmlMozScrollDecorator доступен из пространства имён Qt5Mozilla.

WebView::verticalScrollDecorator

Свойство типа QmlMozScrollDecorator только для чтения.

Вертикальная полоса прокрутки.

Тип QmlMozScrollDecorator доступен из пространства имён Qt5Mozilla.

WebView::painted

Свойство типа bool только для чтения.

Завершилась ли первая окраска.

WebView::parentId

Свойство типа int только для чтения.

Уникальный идентификатор родительского окна (экземпляра веб-представления), который запросил открытие этого местоположения.

WebView::uniqueId

Свойство типа int только для чтения.

Уникальный идентификатор этого экземпляра веб-представления.

Сигналы

WebView::imeNotification(int state, bool open, int cause, int focusChange, string type)

Испускается, когда представление получает уведомление о методе ввода.

Например, если пользователь устанавливает фокус на поле ввода или закрывает виртуальную панель и удаляет фокус с поля ввода, то будут отправлены уведомления о методе ввода.

Аргумент state будет 2, если поле ввода должно быть скрыто (например, при вводе пароля).

Аргумент open будет true, если виртуальная клавиатура уже открыта.

Аргумент cause будет установлен в соответствии с причиной отправки уведомления IME. Возможные причины: изменение фокуса, изменение выбора, обновление композиции, изменение текста, событие нажатия или изменение положения.

Аргумент focusChange будет установлен, если уведомление было отправлено из-за изменения фокуса между одним полем ввода и другим.

ПараметрАргументtype представляет собой строку, описывающую тип ожидаемых входных данных (например, "number", "tel", "email", "url", "date", "datetime" и т. д.).

Методы

WebView::setInputMethodHints(Qt.InputMethodHints hints)

Устанавливает подсказки метода ввода для веб-представления.

Результат влияет на то, как веб-представление интерпретирует события метода ввода (например, принудительное применение требований только к форматированным числам или только к набираемым символам, как указано в подсказках).

См. также: InputMethodHints