WebNavigationRequest

#include <bb/cascades/WebNavigationRequest>

A utility class for the bb::cascades::WebView::navigationRequested signal.

This class contains information about the requested navigation, like URL and navigation type, and it is possible to decide the response action to the request by setting the action property. You can also call WebNavigationRequest::ignore() to reject the request.

Here's a simple QML example snippet demonstrating the use of a WebNavigationRequest:

onNavigationRequested: {
    console.log("NavigationRequested: " + request.url + " navigationType=" + request.navigationType)
    if (shouldAcceptNavigationToUrl(request.url)) {
        request.action = WebNavigationRequestAction.Accept
    } else {
        request.action = WebNavigationRequestAction.Ignore
    }
}

See:

bb::cascades::WebView::navigationRequested(bb::cascades::WebNavigationRequest*)

Since:

BlackBerry 10.0.0

QML properties

url	: QUrl [read-only]
action	: bb::cascades::WebNavigationRequestAction::Type
navigationType	: bb::cascades::WebNavigationType::Type [read-only]

QML signals

onActionChanged

: {}

Properties Index

QUrl	url [read-only]
bb::cascades::WebNavigationRequestAction::Type	action
bb::cascades::WebNavigationType::Type	navigationType [read-only]

Public Functions Index

	WebNavigationRequest (const QUrl &url, bb::cascades::WebNavigationType::Type navigationType, QObject *parent=0)
	~WebNavigationRequest ()
QUrl	url () const
bb::cascades::WebNavigationType::Type	navigationType () const
bb::cascades::WebNavigationRequestAction::Type	action () const
void	setAction (bb::cascades::WebNavigationRequestAction::Type action)
void	accept ()
void	ignore ()

Signals Index

void	actionChanged (bb::cascades::WebNavigationRequestAction::Type action)

Properties

QUrl url[read-only]

The URL of the navigation request.

Since:

BlackBerry 10.0.0

bb::cascades::WebNavigationRequestAction::Type action

The response action to the navigation request.

This will default to WebNavigationRequestAction::Accept which means that the navigation will proceed if nothing is changed. To block the navigation request, change this to WebNavigationRequestAction::Ignore.

See:

bb::cascades::WebNavigationRequestAction

Since:

BlackBerry 10.0.0

bb::cascades::WebNavigationType::Type navigationType[read-only]

The type of navigation that caused this navigation request.

See:

bb::cascades::WebNavigationType

Since:

BlackBerry 10.0.0

Public Functions