Window.toolbar

The Window.toolbar property returns the toolbar object, whose visibility can be toggled in the window.

Syntax

objRef = window.toolbar

Example

The following complete HTML example shows way that the visible property of the various "bar" objects is used, and also the change to the privileges necessary to write to the visible property of any of the bars on an existing window. Due to deprecation of enablePrivilege this functionality can not be used in web pages. EnablePrivilege is disabled in Firefox 15 and will be removed in Firefox 17.

<!DOCTYPE html>
<html>
<head>
<title>Various DOM Tests</title>
<script>

// changing bar states on the existing window
netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserWrite");
window.toolbar.visible=!window.toolbar.visible;

</script>
</head>

<body>
  <p>Various DOM Tests</p>
</body>
</html>

Notes

When you load the example page above, the browser displays the following dialog: Image:Modify_any_open_window_dialog.png

To toggle the visibility of these bars, you must either sign your scripts or enable the appropriate privileges, as in the example above. Also be aware that dynamically updating the visibilty of the various toolbars can change the size of the window rather dramatically, and may affect the layout of your page.

See also: window.locationbar, window.menubar, window.personalbar, window.scrollbars, window.statusbar

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'Window.toolbar' in that specification.
Living Standard
HTML5
The definition of 'Window.toolbar' in that specification.
Recommendation

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
toolbarChrome Full support YesEdge Full support 12Firefox Full support YesIE ? Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support
Full support
Compatibility unknown
Compatibility unknown