Rich text editor
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.
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 by clicking the upload button. Once an image is selected, additional formatting options 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 defined image styles to the image. Read how to define custom Image Styles below A caption and alt text can be entered at the bottom of the modal dialog.
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 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.
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, trigger download or a new email.
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.
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.
By default, Content Studio 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”.
You can define your own styles in your application which will be automatically shown inside the dropdown with image styles inside the Image modal dialog as described below.
Define a file called
styles.xml in the
site folder of your app. The example below represents a couple of styles applying different server processing, like
filter. As of now, only
filter are supported.
Unresolved directive in rich-text-editor.adoc - include::code/styles.xml
As you can see, the root
styles element in
styles.xml has an optional attribute called
css. By using it you can define client-side CSS styles and (optionally) combine them with server-side processing styles.
Define a file called
resources/assets folder. It has to match the path in the
css attribute of
styles element in
styles.xml. So, in case of
css="styles/styles.css" the file has to be located at
Unresolved directive in rich-text-editor.adoc - include::code/styles.css
|All custom styles (no matter if they define server-side processing or client-side processing or combine both) must be defined in