Content Completion Assistant
Edit online

Oxygen XML Web Author includes a useful feature called the Content Completion Assistant to help you insert valid XML content. It offers a list of elements, attributes, attribute values, and other options that are valid at the current location. It tries to determine the most logical choice in the current editing context and displays that proposal at the beginning of the list.

Figure 1. Content Completion Assistant in Web Author

It also shows elements that are invalid at the current location, but they are rendered in a lighter shade of gray, italicized, and appear after the valid proposals. You can use the search field at the top of the Content Completion Assistant to quickly navigate to the desired element and it dynamically displays proposals that begin with the characters entered in the search field.

Figure 2. Content Completion Assistant - Search Field

Using the Content Completion Assistant

To activate the feature, tap or press Enter.

On mobile devices, you can swipe up or down to scroll through the list and a proposal can be selected by simply tapping it.

On desktop devices, you can navigate through the list of proposals by using the Up and Down arrow keys and to insert the selection, simply press Enter.

Examples of How the Content Completion Assistant Works

To illustrate how the feature works, consider the following examples for certain contexts:

  • If the cursor is positioned at the beginning or at the end of an element, the first item offered is a New <Element> item. Selecting this item will insert an empty element.

    Figure 3. New Element

  • If the cursor is positioned somewhere inside the element, the first entry is a Split <Element> item. In most cases, you can only split the closest block element to the cursor position, but if it is inside a list item, the list item will also be proposed for split.

    Figure 4. Split Element

  • If the cursor is positioned inside a space-preserved element (for example, a <codeblock>), the first choice is Enter and it will insert a new line in the content of the element.

    Figure 5. ENTER New Line