QML-тип WebEngineSettings

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

Строка импорта: import Sailfish.WebEngine 1.0

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

Свойства

autoLoadImages : bool
cookieBehavior : enumeration
downloadDir : string
initialized : bool
javascriptEnabled : bool
pixelRatio : real
popupEnabled : bool
useDownloadDir : bool

Методы

setPreference(key, value, type)

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

Компонент WebEngineSettings — это синглтон, который обеспечивает доступ к глобальным настройкам веб-движка.

QML-тип WebEngineSettings предоставляется через импорт QML-модуля Sailfish.WebEngine.

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

 import QtQuick 2.0
 import Sailfish.Silica 1.0
 import Sailfish.WebView 1.0
 import Sailfish.WebEngine 1.0

 ApplicationWindow {
     id: root
     initialPage: Component {
         WebViewPage {
             WebView {
                 anchors.fill: parent
                 url: "https://auroraos.ru/"
             }

             Component.onCompleted: {
                 WebEngineSettings.autoLoadImages = false
                 WebEngineSettings.javascriptEnabled = false
             }
         }
     }
 }

См. также WebView и WebEngine.

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

autoLoadImages : bool

Следует ли автоматически загружать изображения.

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

Значение по умолчанию: true.

Свойство соответствует настройке gecko "permissions.default.image".

Установка значения false может помочь избежать отслеживания внешними серверами при отображении локального контента, но может помешать правильному отображению страницы.

cookieBehavior : enumeration

Устанавливает поведение cookie.

Поведение cookie может быть одним из следующих:

Константа	Описание
`WebEngineSettings.AcceptAll`	Принимать все cookie независимо от их происхождения, по умолчанию.
`WebEngineSettings.BlockThirdParty`	Принимать cookie, только если они принадлежат запрашиваемому домену.
`WebEngineSettings.BlockAll`	Не принимать cookie.

Свойство соответствует настройке gecko "network.cookie.cookieBehavior".

downloadDir : string

Устанавливает место для сохранения загруженных файлов.

Указывает абсолютный путь для сохранения загруженных файлов. Свойство применяется, только если для useDownloadDir установлено значение true.

Свойство соответствует настройке gecko "browser.download.downloadDir".

См. также useDownloadDir.

initialized : bool

Были ли инициализированы настройки движка.

Свойство возвращает значение true, если параметры ядра были инициализированы, и значение false в противном случае.

См. также WebEngine::initialized и WebEngine::initialize.

javascriptEnabled : bool

Будет ли JavaScript на странице выполняться автоматически.

При значении true JavaScript на странице будет выполняться. При значении false JavaScript не будет выполняться.

Значение по умолчанию: true.

Свойство соответствует настройке gecko "javascript.enabled".

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

pixelRatio : real

Определяет отношение устройства к логическому пикселю.

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

Следовательно, pixelRatio, равное 2, приведёт к тому, что элементы будут отображаться на экране в два раза больше (покрывая в четыре раза большую площадь), чем, например, pixelRatio, равное 1.

Свойство соответствует настройке gecko "layout.css.devPixelsPerPx".

Примечание. В отличие от десктопного Firefox, изменение данного значения изменит только отображение веб-контента; оно не влияет на масштабирование пользовательского интерфейса..

popupEnabled : bool

Разрешить ли открывать всплывающие окна во время загрузки страницы.

Если установлено значение true, любые всплывающие окна, которые страница запрашивает открыть во время загрузки, будут разрешены для открытия. Если установлено значение false, запросы всплывающих окон будут заблокированы.

Значение по умолчанию: false.

Свойство соответствует настройке gecko "dom.disable_open_during_load".

useDownloadDir : bool

Устанавливает, следует ли использовать место загрузки по умолчанию.

Если установлено значение true, загруженные файлы будут сохраняться в место загрузки по умолчанию, как указано в свойстве downloadDir. Если установлено значение false, пользователю будет предложено указать место для каждого загружаемого файла.

Свойство соответствует настройке gecko "browser.download.useDownloadDir".

См. также downloadDir.

Описание методов

setPreference(key, value, type)

Непосредственно задаёт настройки движка gecko.

Устанавливает настройке key значение value. type — необязательный аргумент, который по умолчанию равен QMozEngineSettings.UnknownPref.

type может быть одним из:

Константа	Описание
`WebEngineSettings.UnknownPref`	Неизвестный тип настройки, значение по умолчанию. `WebEngineSettings` интерпретирует значение с максимальной эффективностью
`WebEngineSettings.StringPref`	Настройка интерпретируется как строковый тип, также обычно используемый с `float`.
`WebEngineSettings.IntPref`	Настройка интерпретируется как тип `int`.
`WebEngineSettings.BoolPref`	Настройка интерпретируется как тип `bool` (`true` или `false`).

Это низкоуровневый API для настройки параметров движка. Предпочтительно использовать вызовы более высокого уровня, такие как API WebEngineSettings, WebEngine и WebView, когда это возможно.

См. документацию MDN для получения дополнительной информации о доступных настройках.