Element: web_window.pre_navigate { }

Type

callback

Description

The command procedure to be executed when web_window is about to visit a new page. This may happen as a result of a link navigation or after the value of window.url has changed.

When a pre_navigate procedure is executed, the window identifier is passed to the procedure as its first parameter. The url of the new page is also passed as the second parameter in the form of a string value.

Within the procedure the url of the window may be changed to override the page to be visited. This is usually done by setting the value of window.url, although calls to the procedures window.go_back, window.go_forward and window.go_home can be used. Such changes to the url are not reflected in the window until the procedure has exited.

Setting window.url, or calling the window.stop procedure, within the callback will prevent the url being visited.

New windows have a pre_navigate procedure of null.

Parameters

window.pre_navigate (<window>,<url>)

Examples

window mywin = wweb
mywin.pre_navigate = {
    args w=window, url=string
    tell <'Loading',url,'...'>
}

See Also