Sailfish Webview
API DocumentationBlockedTabPopupInterface QML Type
A component which defines the interface for the blocked popup More...
Import Statement: | import Sailfish.WebView.Popups 1.0 |
Properties
- host : string
- rememberValue : string
Signals
Detailed Description
The BlockedTabPopupInterface
QML type is exposed through the Sailfish.WebView.Popups
QML import namespace.
Clients who use a WebView in their application may wish to customize the appearance or behavior of the blocked popup prompt in their application.
To do so, their implementation must extend the BlockedTabPopupInterface
, and then they must tell the WebView to use their implementation via the popupProvider
property.
This popup is shown to the user when the site they are accessing attempts to open a new tab, and this is blocked by the web browser. The blocked tab popup is then shown to the user, to ask them whether they would like to continue to block, or alternatively allow, the site to open new tabs in future.
See also UserPromptInterface and custompopups.
Property Documentation
The url of the page which is attempting to open a new tab
A custom implementation should include the host
property value in the string label which describes to the user that the site is attempting to open a popup.
This label will describe to the user which site is attempting to open a popup, allowing the user to make an informed acceptance or rejection decision.
Whether the user wishes the browser to remember their decision for this site
A custom implementation should bind the checked
value of their toggle switch or checkbox, to the rememberValue
.
After the accepted
or rejected
signal is emitted, the value of this property will be used to determine whether to save the decision in the permission manager.
Signal Documentation
This signal is emitted by the popup if the user wishes to allow the site to open new tabs in future.
After emitting this signal, the popup should perform an appropriate transition to make itself invisible and non-interactable (e.g. for an item-derived popup, an animated opacity transition, and then setting visible
to false
once the animation is complete).
This signal is emitted by the popup if the user wishes to disallow the site from opening new tabs for this session.
After emitting this signal, the popup should perform an appropriate transition to make itself invisible and non-interactable (e.g. for an item-derived popup, an animated opacity transition, and then setting visible
to false
once the animation is complete).