MozillaZine

DOM Inspector

From MozillaZine Knowledge Base

(Difference between revisions)
Revision as of 16:32, 22 January 2005
Asqueella (Talk | contribs)
(link to Development resources drectly)
<-- Previous diff
Revision as of 21:23, 18 February 2005
Asqueella (Talk | contribs)
(Getting the DOMi)
Next diff -->
Line 7: Line 7:
==Getting the DOMi== ==Getting the DOMi==
-The DOMi is included in Firefox builds [http://forums.mozillazine.org/viewtopic.php?t=34545 since Nov'03], but it is an option in the Windows installer.+===Firefox===
 +The DOMi is included in [[Firefox]] builds [http://forums.mozillazine.org/viewtopic.php?t=34545 since Nov'03], but it is an option in the Windows installer (you must choose ''Custom'' installation and select DOM Inspector in Additional components window).
-It was an installer option in Thunderbird builds since the end of March 2004, and in the 0.6 release, but was removed from installer for the 0.8 release "to keep download size small". There's no official XPI for Thunderbird yet as of Sept'04 ([https://bugzilla.mozilla.org/show_bug.cgi?id=254031 bug 254031]), but Chris Neale kindly made an [http://downloads.mozdev.org/cdn/insptb.xpi XPI package for Thunderbird] ([http://forums.mozillazine.org/viewtopic.php?t=106356 discussion thread]). Note that since it contains binary components for different OSes, Thunderbird may complain about .so/.dll/.dylib files at startup. Just delete the files it complains about from your [[Profile folder|profile]].+===Thunderbird===
 +DOMi was an installer option in [[Thunderbird]] builds since the end of March 2004, and in the 0.6 release, but was removed from installer for the 0.8 release "to keep download size small". There's no official XPI for Thunderbird yet as of Sept'04 ([https://bugzilla.mozilla.org/show_bug.cgi?id=254031 bug 254031]).
 +Chris Neale kindly made an [http://downloads.mozdev.org/cdn/insptb.xpi XPI package for Thunderbird] ([http://forums.mozillazine.org/viewtopic.php?t=106356 discussion thread]). Note that:
 +* Since it contains binary components for different OSes, Thunderbird may complain about .so/.dll/.dylib files at startup. Just delete the files it complains about from your [[Profile folder|profile]].
 +* As it was packaged some time ago, its [[Install.rdf|install manifest]] doesn't allow it to be installed in recent Thunderbird versions. To work around it, open the downloaded XPI file (it's a zip archive) and edit <tt>install.rdf</tt>, replacing <code><em:maxVersion>whatever version there is</em:maxVersion></code> with <code><em:maxVersion>1.0</em:maxVersion></code>.
 +
 +===Mozilla Suite===
The DOM Inspector is available in ''Complete'' Mozilla Suite installations or by selecting the Inspector component in a ''Custom'' setup type. The DOM Inspector is available in ''Complete'' Mozilla Suite installations or by selecting the Inspector component in a ''Custom'' setup type.
 +===Nvu===
 +There is an [[Nvu]] version of the DOMi [http://glazman.org/nvu/releases/extensions/ here].
 +
 +
 +===Related extensions===
Additionally, the [http://www.projectit.com/freestuff.html Inspector Widget extension] adds an '''Inspect''' toolbar button and the menu option '''Tools > Web Development > DOM Inspector'''. Selecting an element after clicking the Inspect button will launch the DOMi and inspect the element. Additionally, the [http://www.projectit.com/freestuff.html Inspector Widget extension] adds an '''Inspect''' toolbar button and the menu option '''Tools > Web Development > DOM Inspector'''. Selecting an element after clicking the Inspect button will launch the DOMi and inspect the element.

Revision as of 21:23, 18 February 2005

Contents

What is the DOMi?

The DOM Inspector is a Mozilla tool used to inspect, browse, and edit the Document Object Model of XML documents - usually web pages or XUL windows.

The article "Introduction to the DOM Inspector", by Ian Oeschger, provides a basic overview of the DOMi. It's a good place to orient yourself with the DOMi and learn how to use its features. The article has some Mozilla Suite-specific references, but most of the information still applies to DOMi in Firefox and other programs.

Mozilla.org's DOM Inspector FAQ has some additional information. The "Creating Applications with Mozilla" book hosted at mozdev.org also has a section about the DOMi.

Getting the DOMi

Firefox

The DOMi is included in Firefox builds since Nov'03, but it is an option in the Windows installer (you must choose Custom installation and select DOM Inspector in Additional components window).

Thunderbird

DOMi was an installer option in Thunderbird builds since the end of March 2004, and in the 0.6 release, but was removed from installer for the 0.8 release "to keep download size small". There's no official XPI for Thunderbird yet as of Sept'04 (bug 254031).

Chris Neale kindly made an XPI package for Thunderbird (discussion thread). Note that:

  • Since it contains binary components for different OSes, Thunderbird may complain about .so/.dll/.dylib files at startup. Just delete the files it complains about from your profile.
  • As it was packaged some time ago, its install manifest doesn't allow it to be installed in recent Thunderbird versions. To work around it, open the downloaded XPI file (it's a zip archive) and edit install.rdf, replacing whatever version there is with 1.0.

Mozilla Suite

The DOM Inspector is available in Complete Mozilla Suite installations or by selecting the Inspector component in a Custom setup type.

Nvu

There is an Nvu version of the DOMi here.


Related extensions

Additionally, the Inspector Widget extension adds an Inspect toolbar button and the menu option Tools > Web Development > DOM Inspector. Selecting an element after clicking the Inspect button will launch the DOMi and inspect the element.

Using the DOMi

The Using the DOM Inspector section in the "Introduction to the DOM Inspector" explains what you can do once you get the DOMi. The DOM Inspector is very handy tool for theme and extension developers, as it allows you to view various properties associated with any XUL element.

  • Browse the tree structure of interface elements
  • View an element's Box Model properties like border and padding
  • Find element names, IDs, and classes to select elements in CSS
  • Find out what files (CSS, images) are used to style an element
  • See what properties and methods of given element you can call from your Javascript

Issues with the DOMi

Warning! Changing themes while using the DOMi may cause the program to crash.