Component pages

The HTML representation of a node within the repository may be added as an element to the a component container. A component container is any page, the editor of which supports this feature, currently either HTML page or virtual page. The feature is widely used by virtual pages, e.g. to include a description HTML text within a requirement.

Note, that the editor of the component, which shall be added to the component container, must support this feature as well. Currently this is supported by the HTML page editor, however support for virtual pages will be added soon.

This means, that both HTML pages and virtual pages may add other HTML pages. The component pages appear as a part of the embedding component container page.

They can be edited within the editor of the embedding component container page, but will be saved outside in the referenced component page. When the component page is selected in the embedding editor, the menu and the toolbar show the items of the component's editor and change back, once the component is left. In addition, the icon is added to the toolbar. It allows to edit the component page in separate frame.

HTML page component editor

The HTML component can add another component page by the "Paragraph >> Select a component page" action:

This will show a node selection dialog to choose the component node and add its HTML representation to the page, substituting the currently selected text. The component's editor will then be used to edit the element.

Virtual page component editor

The component page is added when creating the template. First, select a paragraph and map it to the type of the component, e.g. nodes:htmlDiv. Then select the element in the structure explorer dialog again, from the context menu choose "Map element to component page":

This will mark the element as a component. The virtual page editor for a the node will then use the component's editor to edit the element.