Navigator - Another Supported Documents

Author: Jindrich Dinga
Version: First draft
Last update: 09/19/05

Content

1. XML/XSL/TLD/WSDL files
2. Special cases of XML files
3. HTML files
4. JSP files
5. Contextual menu
6. Other realated links
7. Open issues

1. XML/XSL/TLD/WSDL files

In a XML/XSL/TLD/WSDL file, structure of its code is displayed (figure 1). The nodes are expanded to the first level by default. If a user double clicks on a node in the Navigator, this node is selected and highlighted in the Source Editor (this includes its children). The attributes are displayed in a table, the content (PCDATA) are displayed behind the node's name with 10 points size. Comments are not displayed. Focus is available only on nodes.

figure 1 - Navigator for XML/XSD file

Filters (toggle buttons with mouse over effect)

• independent toggle buttons

  1. Show attributes (pressed state by default) - shows tag's attributes, displays "Show attributes" tooltip
  2. Show content (PCDATA) (pressed state by default) - shows tag's content, displays "Show content" tooltip

Nodes, which contain an error, have a badge.

2. Special cases of XML files

Special cases of xml files are web.xml (figure 2a) and ejb-jar.xml (figure 2b). web.xml and ejb-jar.xml files have two views: first one is Logical view (figure 2a,b) and the second one is XML view (similar to previous picture). All nodes are expanded by default. If a user double clicks (or press Enter) on a node in the Navigator, the appropriate node is displayed in the appropriate view. On the other hand, if a node in a view is selected, the appropriate node is selected in the Navigator.

figure 2a - web.xml	figure 2b - ejb-jar.xml
Note: get rid of the combobox in the toolbar

3. HTML files

Navigator for HTML file displays structure of its code (figure 3). The nodes are expanded to the first level by default. If there are some unclosed tags (e.g. <br>, <hr>, <li>, <p> in figure 3) these tags as well as comments are not shown in the Navigator. If a user double clicks on a node in the Navigator, this node is selected and highlighted in the Source Editor (this includes its children). The attributes are displayed in a table, the content (PCDATA) are displayed behind the node's name with 10 points size. Focus is available only on nodes.

figure 3 - Navigator for HTML file

Filters (toggle buttons with mouse over effect)

• independent toggle buttons

  1. Show attributes (pressed state by default) - shows tag's attributes, displays "Show attributes" tooltip
  2. Show content (PCDATA) (pressed state by default) - shows tag's content, displays "Show content" tooltip

Nodes, which contain an error, have a badge.

4. JSP files

In these types of files a structure of code is displayed in Navigator. The nodes are expanded to the first level by default. If there are some unclosed tags (e.g. <br>, <hr>, <li> in figure 4) these tags as well as comments are not shown in the Navigator. If a user double clicks on a node in the Navigator, this node is selected and highlighted in the Source Editor (this includes its children). Focus is available only on nodes.

figure 4 - Navigator for JSP file

Filters (toggle buttons with mouse over effect)

• independent toggle buttons

  1. Show attributes (pressed state by default) - shows tag's attributes, displays "Show attributes" tooltip
  2. Show content (PCDATA) (pressed state by default) - shows tag's content, displays "Show content" tooltip

Nodes, which contain an error, have a badge.

Tool tip

Declarations, expressions and scriptlets show their content in the Tool tip.

5. Contextual menu

On whole Navigator's area a contextual menu (see figure 5) is invokable by right mouse click or by using Shift+F10 shortcut.

figure 5 - Contextual menu on Mac L&F

6. Other related links

Other related links:

1. UI specification
2. Navigator improvements

7. Open issues

In this section, there is a proposal which documents would be supported in next release.

7.1. Form file

When a form file is selected in Projects or Files view, Navigator displays Component view by default. The root node is not shown and the name of the file is displayed in the title bar of Navigator (figure 6).

figure 6 - Navigator for form file

Navigator is context sensitive, it means that Component view is selected when the user works in "Design mode" and Members view while working in "Source mode".

7.2. Image files

When an image file is selected, Navigator displays its preview (figure 7). A user can perform these actions by pressing the toggle buttons (exclusive):

1. 1:1 - actual size (by default)
2. "+" - zoom in
3. "-" - zoom out
4. fit to window

figure 7 - Navigator for image file

7.3. Another files

Properties, JDNC, JDBC, DTD, XSD and UML files.