Text View Features

www.altova.com Print this Topic Previous Page Up One Level Next page

Home >  Common Tasks > Working with Mappings >

Text View Features

The Output pane, the XSLT pane, as well as the XQuery pane have multiple visual aids to make the display of text easier. These include:

 

Line Numbers
Syntax Coloring
Bookmarks
Source Folding
Indentation Guides
End-of-Line and Whitespace Markers
Zooming
Pretty-printing
Word wrapping
Text highlighting

 

Where applicable, you can toggle or customize the features above from the Text View Settings dialog box. Settings in the Text View Settings dialog box apply to the entire application—not only to the active document.

mf_dlg_text_view_settings

Text View Settings dialog box

To open the Text View settings dialog box, do one of the following:

 

On the Output menu, select Text View Settings.
Click the Text View Settings mf_ic_text_view_settings toolbar button.
Right-click the Output pane, and select Text View Settings from the context menu.

 

Some of the navigation aids can also be toggled from the Text View toolbar, the application menu, or keyboard shortcuts.

mf_text_view_toolbar

Text View toolbar

For reference to all applicable shortcuts, see the "Key Map" section of the Text View Settings dialog box illustrated above.

 

Line numbers

Line numbers are displayed in the line numbers margin, which can be toggled on and off in the Text View Settings dialog box. When a section of text is collapsed, the line numbers of the collapsed text are also hidden.

 

Syntax coloring

Syntax coloring is applied according to the semantic value of the text. For example, in XML documents, depending on whether the XML node is an element, attribute, content, CDATA section, comment, or processing instruction, the node name (and in some cases the node's content) is colored differently.

 

Bookmarks

Lines in the document can be bookmarked for quick reference and access. If the bookmarks margin is toggled on, bookmarks are displayed in the bookmarks margin.

mf_bookmarks_01

Otherwise, bookmarked lines are highlighted in cyan.

mf_bookmarks_02

The bookmarks margin can be toggled on or off in the Text View Settings dialog box.

 

You can edit and navigate bookmarks using the following commands:

 

mf_ic_bookmark_insert

Insert/Remove Bookmark (Ctrl + F2)

mf_ic_bookmark_next

Go to Next Bookmark (F2)

mf_ic_bookmark_prev

Go to Previous Bookmark (Shift + F2)

mf_ic_bookmark_delete

Delete All Bookmarks (Ctrl + Shift + F2)

 

The commands above are available in the Output menu. Bookmark commands are also available through the context menu, when you right-click the Output (or XSLT, or XQuery) pane.

 

Source folding

Source folding refers to the ability to expand and collapse nodes and is displayed in the source folding margin. The margin can be toggled on and off in the Text View Settings dialog box. To expand or collapse portions of text, click the "+" and "-" nodes at the left side of the window. Any portions of collapsed code are displayed with an ellipsis symbol. To preview the collapsed code without expanding it, move the mouse cursor over the ellipsis. This opens a tooltip that displays the code being previewed, as shown in the image below. Note that, if the previewed text is too big to fit in the tooltip, an additional ellipsis appears at the end of the tooltip.

mf_source_folding

 

Indentation guides

Indentation guides are vertical dotted lines that indicate the extent of a line's indentation. They can be toggled on and off in the Text View Settings dialog box.

 

Note:        The Insert tabs and Insert spaces options take effect when you use the Output | Pretty-Print XML text option.

 

End-of-line markers, whitespace markers

End-of-line (EOL) markers and whitespace markers can be toggled on in the Text View Settings dialog box. The image below shows a document where both end-of-line and whitespace markers are visible. An arrow represents a tab character, a "CR" is a carriage return, and a dot represents a space character.

mf_markers

 

Zooming in and out

You can zoom in and out by scrolling (with the scroll-wheel of the mouse) while holding the Ctrl key pressed. Alternatively, press the "-" or "+" keys while holding the Ctrl key pressed.

 

Pretty-printing

The Pretty-Print XML Text command reformats the active XML document in Text View to give a structured display of the document. By default, each child node is offset from its parent by four space characters. This can be customized from the Text View Settings dialog box.

 

To pretty-print an XML document, select the Output | Pretty-Print XML Text menu command, or click the Pretty Print mf_ic_pretty_print toolbar button.

 

Word wrapping

To toggle word wrapping in the currently active document, select the Output | Word Wrap menu command, or click the Word Wrap mf_ic_word_wrap toolbar button.

 

Text highlighting

When you select text, all matches in the document of the text selection that you make are highlighted automatically. The selection is highlighted in pale blue, and matches are highlighted in pale orange. The selection and its matches are indicated in the scroll bar by gray marker-squares. The current cursor position is given by the blue cursor-marker in the scroll bar.

 

To switch text highlighting on, select Enable auto-highlighting in the Text View Settings dialog box. A selection can be defined to be an entire word or a fixed number of characters. You can also specify whether casing should be taken into account or not.

 

For a character selection, you can specify the minimum number of characters that must match, starting from the first character in the selection. For example, you can choose to match two or more characters. In this case, one-character selections will not be matched, but a selection consisting of two or more characters will be matched. So, in this case, if you select t, then no matches will be shown; selecting ty will show all ty matches; selecting typ will show all typ matches; and so on.

 

For word searches, the following are considered to be separate words: element names (without angular brackets), the angular brackets of element tags, attribute names, and attribute values without quotes.


© 2019 Altova GmbH