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:
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 StandardThe definition of 'Window.toolbar' in that specification. | Living Standard | |
HTML5The definition of 'Window.toolbar' in that specification. | Recommendation |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
toolbar
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox
Full support 1 |
IE
No support No |
Opera
Full support 15 |
Safari
Full support 3 |
WebView Android
Full support 1 |
Chrome Android
Full support 18 |
Firefox Android
Full support 4 |
Opera Android
Full support 14 |
Safari iOS
Full support 1 |
Samsung Internet Android
Full support 1.0 |
Legend
- Full support
- Full support
- No support
- No support
Window.toolbar by Mozilla Contributors is licensed under CC-BY-SA 2.5.