QML-тип PasswordManagerPopupInterface

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

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

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

Свойства

formData : var
messageBundle : var
notificationType : string

Сигналы

accepted()
rejected()

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

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

Клиенты, которые используют WebView в своём приложении, имеют возможность настроить внешний вид или поведение всплывающего окна диспетчера паролей.

Для этого нужно создать наследника PasswordManagerPopupInterface, а затем нужно указать WebView использовать новую реализацию через свойство popupProvider.

См. также custompopups.

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

formData : var

Данные формы, связанные с учётными данными, включая "displayUser" и "displayHost"

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

Например, formData["displayUser"] будет содержать имя пользователя, связанное с учётными данными, а formData["displayHost"] будет содержать имя сайта, для которого учётные данные действительны.

Если для notificationType установлено значение "password-update-multiuser", то существует несколько потенциальных имён пользователей, связанных с обновляемым паролем, и механизм не знает, какое обновить. В этом случае formData будет включать ключ usernames, содержащий массив имён пользователей. Они должны быть представлены пользователю, чтобы он мог выбрать имя для обновления.

messageBundle : var

Gecko-ключ локализации сообщения для отображения пользователю

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

Значение представляет собой строку или массив. Если это массив, то первым значением будет ключ локализации gecko, взятый из файла commonDialogs.properties. Остальные элементы массива — это значения параметров для замены %1, %2 и т. д. в строке.

Если значение представляет собой строку, то это будет ключ локализации gecko без параметров.

Можно найти этот файл в базе данных локализации Firefox Pontoon, указав соответствующий ключ.

Ключ может быть одним из следующих значений:

updatePasswordMsg;
updatePasswordMsgNoUser;
rememberPasswordMsg;
rememberPasswordMsgNoUsername;
passwordChangeTitle.

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

notificationType : string

Тип запрашиваемой операции с паролем для сайта

Значение будет одним из "password-save" (если учётные данные не были видны ранее; пользователя следует спросить, хочет ли он, чтобы веб-представление сохраняло для них учётные данные), "password-update" (если учётные данные изменились; пользователя следует спросить, хочет ли он, чтобы веб-представление обновило сохранённую версию учётных данных) или "password-update-multiuser" (если пароль обновляется, но есть несколько потенциальных логинов, и пользователь должен выбрать правильный для обновления).

Пользовательская реализация должна отображать пользователю различные информационные сообщения в зависимости от значения этого свойства, чтобы пользователь мог принять обоснованное решение о принятии или отклонении. Ключ локализации AuthPopupInterface::messageKey(messageKey} будет установлен для сообщения, соответствующее типу диалога.

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

accepted()

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

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

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

rejected()

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

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