QML-тип AuthPopupInterface

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

Строка импорта:	`import Sailfish.WebView.Popups 1.0`
Унаследован от:	UserPromptInterface

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

Свойства

hostname : string
messageBundle : var
passwordOnly : bool
passwordPrefillValue : string
passwordValue : string
privateBrowsing : bool
realm : string
rememberMessageKey : var
rememberPrefillValue : bool
rememberValue : bool
rememberVisible : bool
usernameAutofocus : bool
usernamePrefillValue : string
usernameValue : string
usernameVisible : bool

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

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

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

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

Ключ, назначенный acceptText, всегда будет «AcceptLogin», в то время как cancelText всегда будет назначена пустая строка.

См. также UserPromptInterface и custompopups.

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

hostname : string

Имя хоста сайта, запрашивающего учётные данные

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

messageBundle : var

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

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

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

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

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

EnterLoginForRealm3;
EnterLoginForProxy3;
EnterUserPasswordFor2;
EnterUserPasswordForCrossOrigin2;
EnterPasswordFor.

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

passwordOnly : bool

Будет true, если от пользователя не требуется имя.

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

Если значение usernameVisible равно false или passwordOnly равно true, то поле ввода имени пользователя не должно отображаться пользователю.

passwordPrefillValue : string

Значение, которое должно быть предварительно заполнено в поле ввода пароля

passwordValue : string

Значение, которое пользователь указал в поле пароля.

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

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

privateBrowsing : bool

Будет истинно, если пользователь находится в режиме приватного просмотра

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

Кроме того, в режиме приватного просмотра пользовательская реализация не должна спрашивать пользователя, хочет ли он, чтобы веб-представление запоминало его учётные данные, и поэтому она должна скрывать тумблер «запомнить».

realm : string

Область внутри сайта, для которой запрашиваются учётные данные

rememberMessageKey : var

Ключ локализации gecko в сообщении, отображаемом пользователю для переключателя «запомнить».

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

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

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

В настоящее время есть только одно значение, которое может принимать ключ:

rememberButton.

rememberPrefillValue : bool

Значение, которое должно быть предварительно введено в тумблер «запомнить».

rememberValue : bool

Значение тумблера «запомнить».

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

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

rememberVisible : bool

Должен ли тумблер «запомнить» быть показан пользователю

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

usernameAutofocus : bool

Должно ли поле ввода имени пользователя автоматически получать фокус при отображении всплывающего окна

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

usernamePrefillValue : string

Значение, которое должно быть предварительно заполнено в поле ввода имени пользователя.

usernameValue : string

Значение, которое пользователь указал в поле имени пользователя.

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

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

usernameVisible : bool

Должно ли поле ввода имени пользователя быть видимым