QML-тип UserPromptInterface

Компонент, определяющий базовый интерфейс для всех всплывающих окон для взаимодействия с пользователем. Подробнее...

Строка импорта:	`import Sailfish.WebView.Popups 1.0`
Наследники:	AlertPopupInterface, AuthPopupInterface, ConfirmPopupInterface, LocationPopupInterface, PromptPopupInterface и SelectorPopupInterface

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

Свойства

acceptText : string
cancelText : string
preventDialogsPrefillValue : bool
preventDialogsValue : bool
preventDialogsVisible : bool
title : string

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

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

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

См. также custompopups.

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

acceptText : string

Ключ текста для отображения действия принятия, если он применим

Возможные ключи, которые могут быть предоставлены:

"OK";
"Cancel";
"Yes";
"No";
"Save";
"DontSave";
"Revert";
"AcceptLogin";
"" (пустая строка).

Например, во всплывающем окне подтверждения с параметрами "OK" и "Cancel" будет передан acceptText со значением "OK". Метка на кнопке принятия должна быть подходящим переводом этого ключа.

Кроме "AcceptLogin", эти ключи взяты из файла локализации gecko commonDialogs.properties. Можно найти этот файл в базе данных локализации Firefox Pontoon, а затем указать соответствующий ключ для соответствующих переводов.

Это зависит от реализации, чтобы обеспечить подходящие переводы; ключи перевода gecko не должны использоваться напрямую.

Возможные ключи могут измениться с будущими обновлениями движка.

cancelText : string

Ключ текста для отображения действия отмены, если он применим

Возможные ключи, которые могут быть предоставлены:

"OK";
"Cancel";
"Yes";
"No";
"Save";
"DontSave";
"Revert";
"" (пустая строка).

Например, во всплывающем окне подтверждения с параметрами "OK" и "Cancel" будет передан cancelText со значением "Cancel". Метка на кнопке отклонения должна быть подходящим переводом этого ключа.

Эти ключи взяты из файла локализации gecko commonDialogs.properties. Можно найти этот файл в базе данных локализации Firefox Pontoon, а затем указать соответствующий ключ для соответствующих переводов.

Возможные ключи могут измениться с будущими обновлениями движка.

preventDialogsPrefillValue : bool

Должен ли переключатель, показанный в подсказке, который позволяет пользователю запретить этому сайту показывать всплывающие окна в будущем, быть предварительно заполнен значением true или false.

Пользовательская реализация должна привязать свойство checked своего переключателя к значению этого свойства.

preventDialogsValue : bool

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

Пользовательская реализация должна связать это свойство со свойством checked своего тумблера.

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

preventDialogsVisible : bool

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

Пользовательская реализация должна привязать свойство visible своего переключателя к значению этого свойства.

title : string

Текст, отображаемый в качестве заголовка подсказки.

Пользовательская реализация должна связать свойство text своего заголовка или метки со значением этого свойства.

Описание сигналов

accepted()

Сигнал испускается всплывающим окном, если пользователь принимает предложение.

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

После отправки этого сигнала всплывающее окно должно выполнить соответствующий переход, чтобы сделать себя невидимым и недоступным для взаимодействия (например, для всплывающего окна, производного от элемента, может произойти анимированный переход для свойства непрозрачности, а затем установить visible как false после завершения анимации).

rejected()

Сигнал испускается всплывающим окном, если пользователь отклоняет предложение.

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