<oXygen/> XML Editor User Guide

XML editor specific actions

<oXygen/> offers a group of actions for working on single XML elements. They are available from the Document menu and the context menu of the main editor panel.

Select actions

  • Document+Select->Select element: Selects the entire current element;

  • Document+Select->Select content: Selects the current element, excluding the start tag and end tag;

  • Document+Select->Select attributes: Selects all the attributes of the current element;

[Note]Note

The Select actions are enabled when the caret is positioned inside a tag name.

Source actions

  • Document+Source+ ->Locks / Unlocks the XML Tags: Disable / Enable editing of XML tags

  • Document+Source+ ->Shift Right (Tab): Shifts the selected block to the right;

  • Document+Source+ ->Shift Left (Shift+Tab): Shifts the selected block to the left;

  • Document+Source+ ->Sélection d'échappement ... :Escapes a range of characters by replacing them with the corresponding character entities.

  • Document+Source+ ->Unescape Selection ...: Replaces the character entities with the corresponding characters;

  • Document+Source+ ->Indenter la sélection : Corrects the indentation of the selected block of lines.

  • Document+Source+ ->Pretty-Print Element: Pretty prints the element that surrounds the caret position;

  • Document+Source+ ->Sélection non-commentée : Retire les crochets de commentaire <!-- --> du commentaire actuellement sélectionné.

  • Document+Source+ ->Commenter la sélection : Place des crochets de commentaire <!-- --> autour de la sélection actuelle ou à la position du curseur.

  • Document+Source+ ->Import entities list : Shows a dialog that allows you to select a list of files as sources for external entities. The DOCTYPE section of your document will be updated with the chosen entities. For instance, if choosing the file chapter1.xml, and chapter2.xml, the following section is inserted in the DOCTYPE:

    <!ENTITY chapter1 SYSTEM "chapter1.xml">
    <!ENTITY chapter2 SYSTEM "chapter2.xml">
  • Triple click on an element or processing instruction.: Selects the entire element or processing instruction that was triple clicked on.

XML document actions

  • Document+Document XML->Copier XPath (Ctrl+Shift+G): Copy XPath expression of current element from current editor to clipboard.

  • Document+Document XML+ ->Aller à la balise correspondante (Ctrl+Shift+G) : Déplace le curseur jusqu'à la balise de fermeture qui correspond à celle d'ouverture, ou vice versa.

XML Refactoring actions

  • Document+XML Refactoring+ ->Entourer avec balise... (Ctrl+E): Le texte sélectionné dans l'éditeur est entouré par une balise d'ouverture et une balise de fermeture.

  • Document+XML Refactoring+ ->Entourer avec <balise> (Ctrl+/): Le texte sélectionné dans l'éditeur est marqué avec les balises d'ouverture et de fermeture de la dernière action 'Entourer'.

  • Document+XML Refactoring+ ->Renommer élément (Alt+Shift+R) : l'élément à la position du curseur et les élément ayant le même nom peuvent être renommés suivant les options dans le dialogue Renommer.

  • Document+XML Refactoring+ ->Rename prefix (Alt+Shift+P): The prefix of the element from the caret position and the elements that have the same prefix as the current element can be renamed according with the options from the Rename dialog.

    Figure 4.39. Rename Prefix Dialog

    Rename Prefix Dialog

    Selecting the "Rename current element prefix" option the application will recursively traverse the current element and all its children.

    For example, to change the xmlns:p1="ns1" association existing in the current element to xmlns:p5="ns1" just select this option and press OK. If the association xmlns:p1="ns1" is applied on the parent of the current element, then <oXygen/> will introduce a new declaration xmlns:p5="ns1" in the current element and will change the prefix from p1 to p5. If p5 is already associated in the current element with another namespace, let's say ns5, then a dialog showing the conflict will be displayed. Pressing the OK button, the prefix will be modified from p1 to p5 without inserting a new declaration xmlns:p5="ns1". On Cancel no modification is made.

    Selecting the "Rename current prefix in all document" option the application will apply the change on the entire document.

  • Document+XML Refactoring+ ->Diviser élément (Ctrl+Alt+D) : divise l'élément à la position du curseur en deux éléments identiques. Le curseur doit se trouver dans l'élément.

  • Document+XML Refactoring+ ->Joindre les éléments (Ctrl+Alt+J) : joint les éléments à gauche et à droite du curseur. Les éléments doivent avoir les mêmes nom, attributs et valeurs d'attribut.

  • Document+XML Refactoring+ ->Effacement les étiquettes (Ctrl+Alt+X): Efface l'étiquette de début et étiquette d'extrémité de l'élément courant

XML Schema actions

  • Document+Schema->Show definition (Ctrl + Shift + ENTER): Move the cursor to the definition of the referenced XML Schema item - element, group, simple or complex type.

[Note]Note

The Select actions are enabled when the caret is positioned inside a tag name.