MozillaZine

Chrome URLs

From MozillaZine Knowledge Base

(Difference between revisions)
Revision as of 07:04, 10 September 2017
Johnduncan (Talk | contribs)
(Add chrome URLs that have been replaced since Mozilla Suite 1.0/1.1 era)
<-- Previous diff
Revision as of 19:39, 12 September 2017
Johnduncan (Talk | contribs)
(Add Download Manager to 'modern seamonkey' table, populate 'Dev:' table with internal chrome URLs)
Next diff -->
Line 155: Line 155:
{| border="1" cellpadding="5" rules="all" {| border="1" cellpadding="5" rules="all"
! Function !! URL ! Function !! URL
 +|-
 +| Error Console || chrome://communicator/content/console/console.xul
|- |-
| Preferences || chrome://communicator/content/pref/preferences.xul | Preferences || chrome://communicator/content/pref/preferences.xul
 +|-
 +| Downloads || chrome://mozapps/content/downloads/downloads.xul
 +|-
 +| Add-ons || chrome://mozapps/content/extensions/extensions.xul
|- |-
| Saved Passwords || chrome://passwordmgr/content/passwordManager.xul | Saved Passwords || chrome://passwordmgr/content/passwordManager.xul
|- |-
-| Error Console || chrome://communicator/content/console/console.xul+| Calendar (requires [https://addons.mozilla.org/en-US/seamonkey/addon/lightbird/ Lightbird] extension) || chrome://lightbird/content/sunbird/calendar.xul
 +|}
 + 
 +=== Dev: modern SeaMonkey ===
 +{| border="1" cellpadding="5" rules="all"
 +! Function !! URL
 +|-
 +| Ok/Cancel Dialog || chrome://global/content/commonDialog.xul
 +|-
 +| 'Customize...' nav-bar dialog || chrome://global/content/customizeToolbar.xul
 +|-
 +| Edit Menu options || chrome://global/content/editMenuOverlay.xul
 +|-
 +| Find in This Page || chrome://global/content/finddialog.xul
 +|-
 +| Listbox w/ Ok/Cancel || chrome://global/content/selectDialog.xul
 +|-
 +| Blank overlay || chrome://global/content/globalOverlay.xul
 +|-
 +| Ok/Cancel Dialog overlay || chrome://global/content/dialogOverlay.xul
 +|-
 +| File Picker || chrome://global/content/filepicker.xul
 +|-
 +| Print Dialog || chrome://global/content/printdialog.xul
 +|-
 +| Print Setup || chrome://global/content/printPageSetup.xul
 +|-
 +| Print Preview progress || chrome://global/content/printPreviewProgress.xul
 +|-
 +| Print Progress || chrome://global/content/printProgress.xul
 +|-
 +| about:config || chrome://global/content/config.xul
 +|-
 +| View Source || chrome://global/content/viewSource.xul
 +|-
 +| View Source (selected text) || chrome://global/content/viewPartialSource.xul
 +|-
 +| Alert Notification || chrome://global/content/alerts/alert.xul
 +|-
 +| Help Dialog overlay || chrome://help/content/helpContextOverlay.xul
 +|-
 +| Create Profile Wizard || chrome://mozapps/content/profile/createProfileWizard.xul
 +|-
 +| Profile Manager || chrome://mozapps/content/profile/profileSelection.xul
 +|-
 +| Add-on Install confirmation || chrome://mozapps/content/xpinstall/xpinstallConfirm.xul
 +|-
 +| Open with/Save as dialog || chrome://mozapps/content/downloads/unknownContentType.xul
 +|-
 +| About Extension dialog || chrome://mozapps/content/extensions/about.xul
 +|-
 +| Change Master Password || chrome://pippki/content/changepassword.xul
 +|-
 +| Reset Master Password || chrome://pippki/content/resetpassword.xul
 +|-
 +| SSL/TLS/Encryption prefs || chrome://pippki/content/pref-ssl.xul
 +|-
 +| Certificate prefs || chrome://pippki/content/pref-certs.xul
 +|-
 +| Trust CA dialog || chrome://pippki/content/downloadcert.xul
 +|-
 +| Certificate Manager || chrome://pippki/content/certManager.xul
 +|-
 +| Security Device certificates || chrome://pippki/content/CAOverlay.xul
 +|-
 +| Server certificates || chrome://pippki/content/WebSitesOverlay.xul
 +|-
 +| People certificates || chrome://pippki/content/OthersOverlay.xul
 +|-
 +| 'You' certificates || chrome://pippki/content/MineOverlay.xul
 +|-
 +| Certificate details || chrome://pippki/content/viewCertDetails.xul
 +|-
 +| Edit a Certificate || chrome://pippki/content/editcacert.xul
 +|-
 +| Delete a Certificate || chrome://pippki/content/deletecert.xul
 +|-
 +| Certificate Backup password || chrome://pippki/content/setp12password.xul
 +|-
 +| Client Authentication Certificate || chrome://pippki/content/clientauthask.xul
 +|-
 +| Specific Certificate Details || chrome://pippki/content/certpicker.xul
 +|-
 +| Certificate Details || chrome://pippki/content/certViewer.xul
 +|-
 +| Certificate Information Dump || chrome://pippki/content/certDump.xul
 +|-
 +| Device Manager || chrome://pippki/content/device_manager.xul
 +|-
 +| Load a Device || chrome://pippki/content/load_device.xul
 +|-
 +| SSL Warning/Choose Token || chrome://pippki/content/choosetoken.xul
|- |-
-| Calendar || chrome://lightbird/content/sunbird/calendar.xul+| Master Password pref || chrome://pippki/content/pref-masterpass.xul
|- |-
-| Add-ons || chrome://mozapps/content/extensions/extensions.xul+| Certificate Key Generation || chrome://pippki/content/createCertInfo.xul
|} |}

Revision as of 19:39, 12 September 2017

To overlay an existing XUL element, you first need the URL of its chrome.

Contents

Finding Chrome URLs not listed below

If you can open the desired chrome element in its own window or popup, make sure you have the DOM Inspector extension installed (it comes bundled with some applications, not with others), then:

  • Open your chrome element's window
  • Start the DOM Inspector via the appropriate submenu or sub-submenu of the Tools menu (its exact location varies between applications, and with the presence or absence of some other extensions), or by hitting Ctrl+Shift+I
  • In the DOM Inspector window, use the "File => Inspect Chrome Document" menuitem to select your chrome element's window
  • The desired chrome URL should appear in the DOM Inspector's URL bar.

Search for chrome content

You can also use a Mozilla code search tool such as MXR to find the source files for chrome content by searching for text in the content. Note that toolkit code assembles much of the text you see from smaller bits of text to ease localization. For example, if you see "Welcome to SeaMonkey Help", the chrome content is actually "Welcome to &brandShortName; Help". So if you don't get a search result try searching for something smaller.

Chrome URLs map to file locations

However, note that toolkit code maps chrome URLs to locale-specific directories, for example SeaMonkey's chrome://locale/communicator/help/welcome_help.xhtml maps to the file /chrome/en-US/locale/en-US/help/firefox_welcome.xhtml (for someone with the U.S. English build of SeaMonkey).

Look in omni.ja

In 2011 and later versions of Firefox and SeaMonkey, most built-in chrome content is packaged inside the single large file omni.ja. This is a JAR file which uses a special variant of the ZIP file compression format. So you can explore this with most "unzip" tools to look at its contents. The compression variant is optimized for read ahead access.

jar: to look at ZIP content in the browser

Firefox and SeaMonkey support the "jar:" URL protocol to access content in ZIP files. If you load a chrome URL, then view its URL or choose Page Info, you may see the URL transform to something like

jar:file:///path/to/seamonkey program/omni.ja!/chrome/en-US/locale/en-US/help/firefox_welcome.xhtml

An expert user can edit these URLs to investigate the contents of omni.ja (or in fact any locale zip file), although the user interface is quirky and error handling non-existent.

All Toolkit applications

Firefox, Thunderbird, Sunbird, SeaMonkey (2.0a1pre and later), ...
 

 
 This section is incomplete. If you know what's missing, please fill it in.
 

 

Function URL
Add-ons chrome://mozapps/content/extensions/extensions.xul
DOM Inspector chrome://inspector/content/inspector.xul

Firefox

Function URL
Main Window chrome://browser/content/browser.xul
Options chrome://browser/content/preferences/preferences.xul
Firefox 1.5: chrome://browser/content/pref/pref.xul
Library chrome://browser/content/places/places.xul
Firefox 1.5: chrome://browser/content/bookmarks/bookmarksManager.xul
Bookmark Panel chrome://browser/content/bookmarks/bookmarksPanel.xul
History Panel chrome://browser/content/history/history-panel.xul
Downloads chrome://mozapps/content/downloads/downloads.xul
Clear Private Data chrome://browser/content/sanitize.xul
Saved Passwords chrome://passwordmgr/content/passwordManager.xul
Error Console chrome://global/content/console.xul
Manage Cookies chrome://browser/content/preferences/cookies.xul


Firefox Help Links

Function URL
Mozilla Firefox Help chrome://help/locale/firefox_welcome.xhtml
Using the Help Window chrome://help/locale/welcome.xhtml
Using Mozilla Firefox chrome://help/locale/using_firebird.xhtml
Using the Download Manager chrome://help/locale/download_manager.xhtml
Customization chrome://help/locale/customization.xhtml
Options (Preferences) chrome://help/locale/prefs.xhtml
Controlling Popups chrome://help/locale/popup.xhtml
Managing Cookies chrome://help/locale/cookies.xhtml
Tabbed Browsing chrome://help/locale/tabbed_browsing.xhtml
Keyboard Shortcuts chrome://help/locale/shortcuts.xhtml
Mouse Shortcuts chrome://help/locale/mouse_shortcuts.xhtml
Menu Reference chrome://help/locale/menu_reference.xhtml
Help for Internet Explorer Users chrome://help/locale/forieusers.xhtml
Glossary chrome://help/locale/glossary.xhtml

Thunderbird

 

 
 Please fill in.
 

SeaMonkey 2.0 and later

Most "2.0 and later" URLs are missing: Please complete.

 

Function URL
Main help chrome://help/content/help.xul

early Mozilla Suite and SeaMonkey 1.0/1.1

Function URL
Main Window chrome://navigator/content/navigator.xul
Search Panel chrome://communicator/content/search/search-panel.xul
Bookmark Panel chrome://communicator/content/bookmarks/bm-panel.xul
History Panel chrome://communicator/content/history/history-panel.xul
Addressbook Panel chrome://messenger/content/addressbook/addressbook-panel.xul
Bookmark Manager chrome://communicator/content/bookmarks/bookmarksManager.xul
History Window chrome://communicator/content/history/history.xul
Manage Cookies chrome://communicator/content/permissions/cookieViewer.xul
Image Permissions chrome://communicator/content/permissions/permissionsManager.xul
Manage Popups chrome://communicator/content/permissions/permissionsManager.xul
Preferences chrome://communicator/content/pref/pref.xul
Saved Passwords chrome://communicator/content/wallet/SignonViewer.xul
Error Console chrome://global/content/console.xul
DOM Inspector chrome://inspector/content/inspector.xul
Mail & News chrome://messenger/content/messenger.xul
Address Book chrome://messenger/content/addressbook/addressbook.xul
Composer chrome://editor/content/editor.xul
Chatzilla chrome://chatzilla/content/chatzilla.xul
Calendar chrome://calendar/content/calendar.xul

modern SeaMonkey

Function URL
Error Console chrome://communicator/content/console/console.xul
Preferences chrome://communicator/content/pref/preferences.xul
Downloads chrome://mozapps/content/downloads/downloads.xul
Add-ons chrome://mozapps/content/extensions/extensions.xul
Saved Passwords chrome://passwordmgr/content/passwordManager.xul
Calendar (requires Lightbird extension) chrome://lightbird/content/sunbird/calendar.xul

Dev: modern SeaMonkey

Function URL
Ok/Cancel Dialog chrome://global/content/commonDialog.xul
'Customize...' nav-bar dialog chrome://global/content/customizeToolbar.xul
Edit Menu options chrome://global/content/editMenuOverlay.xul
Find in This Page chrome://global/content/finddialog.xul
Listbox w/ Ok/Cancel chrome://global/content/selectDialog.xul
Blank overlay chrome://global/content/globalOverlay.xul
Ok/Cancel Dialog overlay chrome://global/content/dialogOverlay.xul
File Picker chrome://global/content/filepicker.xul
Print Dialog chrome://global/content/printdialog.xul
Print Setup chrome://global/content/printPageSetup.xul
Print Preview progress chrome://global/content/printPreviewProgress.xul
Print Progress chrome://global/content/printProgress.xul
about:config chrome://global/content/config.xul
View Source chrome://global/content/viewSource.xul
View Source (selected text) chrome://global/content/viewPartialSource.xul
Alert Notification chrome://global/content/alerts/alert.xul
Help Dialog overlay chrome://help/content/helpContextOverlay.xul
Create Profile Wizard chrome://mozapps/content/profile/createProfileWizard.xul
Profile Manager chrome://mozapps/content/profile/profileSelection.xul
Add-on Install confirmation chrome://mozapps/content/xpinstall/xpinstallConfirm.xul
Open with/Save as dialog chrome://mozapps/content/downloads/unknownContentType.xul
About Extension dialog chrome://mozapps/content/extensions/about.xul
Change Master Password chrome://pippki/content/changepassword.xul
Reset Master Password chrome://pippki/content/resetpassword.xul
SSL/TLS/Encryption prefs chrome://pippki/content/pref-ssl.xul
Certificate prefs chrome://pippki/content/pref-certs.xul
Trust CA dialog chrome://pippki/content/downloadcert.xul
Certificate Manager chrome://pippki/content/certManager.xul
Security Device certificates chrome://pippki/content/CAOverlay.xul
Server certificates chrome://pippki/content/WebSitesOverlay.xul
People certificates chrome://pippki/content/OthersOverlay.xul
'You' certificates chrome://pippki/content/MineOverlay.xul
Certificate details chrome://pippki/content/viewCertDetails.xul
Edit a Certificate chrome://pippki/content/editcacert.xul
Delete a Certificate chrome://pippki/content/deletecert.xul
Certificate Backup password chrome://pippki/content/setp12password.xul
Client Authentication Certificate chrome://pippki/content/clientauthask.xul
Specific Certificate Details chrome://pippki/content/certpicker.xul
Certificate Details chrome://pippki/content/certViewer.xul
Certificate Information Dump chrome://pippki/content/certDump.xul
Device Manager chrome://pippki/content/device_manager.xul
Load a Device chrome://pippki/content/load_device.xul
SSL Warning/Choose Token chrome://pippki/content/choosetoken.xul
Master Password pref chrome://pippki/content/pref-masterpass.xul
Certificate Key Generation chrome://pippki/content/createCertInfo.xul

Sunbird

 

 
 Please fill in.
 

Camino

 

 
 Please fill in.
 

Using the chrome URL

Once you've got your chrome URL you can load it (by typing it in the location bar), and use the DOM inspector's click-to-select tool to locate the element and get its ID.

See Also

External Links