Spec-Zone.ru › Qt 5.9

Тип QML WebEngineScript

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

Заявление об импорте: import QtWebEngine 1.5
С момента: QtWebEngine 1.1
Создаёт экземпляр: QQuickWebEngineScript
  • Список всех членов, включая унаследованные

Свойства

  • injectionPoint : перечисление
  • name : строка
  • runOnSubframes : целое число
  • sourceCode : строка
  • sourceUrl : url
  • worldId : перечисление

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

Тип WebEngineScript позволяет программно вставлять так называемые пользовательские скрипты в движок JavaScript в разные моменты, определяемые свойством injectionPoint, во время загрузки веб-содержимого.

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

Следующие атрибуты Greasemonkey поддерживаются начиная с Qt 5.8: @exclude, @include, @name, @match, и @run-at.

Используйте свойство WebEngineView.userScripts для доступа к списку скриптов, прикрепленных к представлению веб-страницы.

Документация по свойствам

injectionPoint : перечисление

Точка в процессе загрузки, в которой будет выполняться скрипт. Значение по умолчанию равно Deferred.

Постоянная Описание
WebEngineScript.DocumentCreation Скрипт будет выполнен, как только документ будет создан. Это не подходит для операций с DOM.
WebEngineScript.DocumentReady Скрипт выполнится, как только DOM будет готов. Это эквивалентно срабатыванию события DOMContentLoaded в JavaScript.
WebEngineScript.Deferred Скрипт выполнится при завершении загрузки страницы или через 500 мс после того, как документ будет готов, в зависимости от того, что произойдет раньше.

name : строка

Имя скрипта. Может быть полезно для извлечения определенного скрипта из WebEngineView.userScripts.

runOnSubframes : целое число

Установите это свойство в значение true если скрипт выполняется на каждой фрейме на странице или в значение false если он выполняется только для основной фреймы. Значение по умолчанию равно false.

sourceCode : строка

Это свойство содержит исходный код JavaScript пользовательского скрипта.

См. также sourceUrl.

sourceUrl : url

Это свойство содержит удаленное расположение источника пользовательского скрипта (если таковое имеется).

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

Установка этого свойства изменит sourceCode скрипта.

Примечание: В настоящее время поддерживаются только источники на основе файлов.

См. также sourceCode.

worldId : перечисление

Идентификатор мира, определяющий, в каком изолированном мире выполняется скрипт.

Постоянная Описание
WebEngineScript.MainWorld Мир, используемый веб-содержимым страницы. Это может быть полезно для экспонирования пользовательской функциональности веб-содержимому в определенных сценариях.
WebEngineScript.ApplicationWorld Основной изолированный мир, используемый для функциональности на уровне приложения, реализованной на JavaScript.
WebEngineScript.UserWorld Первый изолированный мир, используемый скриптами, заданными пользователями, если приложение не использует больше миров. Как правило, если эта функциональность предоставляется пользователям приложения, каждый отдельный скрипт, вероятно, должен получить свой собственный изолированный мир.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtwebengine-webenginescript.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API