Rich text editor
Rich Text Editor is used by HTMLArea input type and for editing text component inside the Page Editor. It’s capable of formatting the text in many ways, pasting from Word and Google Docs, using macros to insert code snippets and iFrames, inserting tables, images and content links etc.
The toolbar contains buttons for various formatting options as well as inserting elements like pictures, links, special characters and more.
Style menu contains options for styles that can be applied to the entire paragraph, for example to create heading elements or snippets of code.
The next group of icons represent inline styles which can be combined in the same paragraph, for example bold, italic, strikethrough etc.
The next four icons can be used to change alignment of selected element: left-align, center, right-align or justify.
The next two icons will turn text into a bullet list or a numbered list. Pressing
Return will make a new list item and pressing it a second time will end the list. Use
Shift + Enter /
Shift + Return to make a new line within the list item. A sub-list can be created with the indent button.
|Right-click the list to change styling of its bullets or numbers.|
The next buttons will decrease and increase indent for the selected text. These buttons will also increase or decrease the level of a list item.
This button opens a menu with special characters. Selecting one will insert it at the cursor’s location.
Anchors enable pointing to a specfic position on a page via context link. If a link references an anchor on the same page then the page will scroll up or down to the location of the anchor. The anchor button in the toolbar opens the Insert Anchor dialog where the name of the anchor is entered. The anchor name will be used as the value of the “id” attribute, so it should be lower case without spaces.
This button opens the Insert Image dialog. An existing image content can be selected from the “Image” selector, or a new image can be uploaded using the upload button. Once an image is selected, additional formatting options will appear. The image can be floated to the left or right so that text wraps around it. The image can also be centered or set to full width. By checking off “Custom width” you will have an option to set relative width of the image. Additionally, there’s an option to apply custom image styles. A caption and alt text can be entered at the bottom of the modal dialog. A double click on an image inside the Editor will open the modal dialog for editing properties of the image.
This button opens the Insert Macro dialog, which contains a selector for choosing a macro. Macros allow all sorts of things to be inserted into the input, such as iframes, YouTube videos, Twitter Tweets, etc. There are two built-in macros and others can be added with applications. Once a macro is selected, a form appears with inputs for the macro’s configuration settings. A double click on a macro inside the Editor will open the modal dialog for editing properties of the macro.
This button opens the Insert Link dialog. You can select existing text in the HTML Area before opening the dialog or write it directly inside the dialog. You can link to a content item, external URL, relative URL on the same site, trigger media download or create a mailto link. A double click on a link inside the Editor will open the modal dialog for editing properties of the link.
Pressing this button will remove a link from an element.
This button expands a dropdown menu enabling you to insert a new table, manage table properties or add/delete columns/rows in existing table.
Paste text mode
This button allows toggling between "formatted text" (default setting) and "plain text" modes when pasting text into the editor.
This button will open a modal dialog allowing you to manually edit HTML source content of the text editor. For HTML Area input type this button will be placed in the footer of the editor, while for a Text component inside the Page Editor it’s part of the toolbar.
This button will open the editor in the full screen mode for more convenient user experience. Not available inside the text component editor.
Custom Image Styles
By default, XP comes with one built-in image style called “Original (no image processing)”. By applying this style to the image, you’ll make sure that the image won’t undergo any processing on the server and will be rendered “as is”.
Custom Image Styles can be defined in your application as described in the CMS section of XP docs.
Custom styles from all the applications added to the site (plus the "Original" style) will be combined into one list inside the dropdown of the Image modal dialog.