Sitecore 8.2 Rich Text Editor drop down items

Question

In the RTE in Sitecore 8.2 Update 6, I can see one of the definitions for a drop down in the Core database is for "FormatBlock" which displays a set of css classes in a drop down box.

Can anyone point me to where the css class styles displayed in this drop down are defined so I can add my own classes?

Answer 1

FormatBlock

For your question, you can find the values for the FormatBlock under the item /sitecore/system/Settings/Html Editor Profiles/Rich Text Full/Paragraphs. Out of the box, Sitecore's formatting is pretty boring. But you can add some styling to the selections to make them look better. Similar to the class drop down.

See this link to find out more about styling the formatblock values.

Using the style drop down

I have found it a lot easier to define explicitly the classes that show up in the RTE. It first starts with your custom RTE css file which you set with the setting WebStylesheet.

<settings>
      <setting name="WebStylesheet" value="/styles/rte.min.css" />
</settings>

Then in the ToolsFile.xml, located in the folder \sitecore\shell\Controls\Rich Text Editor\ToolsFile.xml, you can define exactly which classes you want in your RTE classes dropdown and what they are called. I find this a lot better than having to name the class to help the editor.

<root>
    <classes>
        <class name="Red Button" value="a.btn-danger" />
        <class name="Blue Button" value="a.btn-blue" />
        <class name="Sitecore Light Blue" value=".light-blue" />
    </classes>
</root>

Answer 2

Sitecore's default editor configuration class loads the style sheet specified by the WebStylesheet setting. This is /default.css by default. It also loads /sitecore/shell/Controls/Rich Text Editor/Editor.css. You can modify one of these or change the WebStylesheet setting to point at a custom style sheet.

Another option which enables more advanced customization is to create a class that inherits from Sitecore.Shell.Controls.RichTextEditor.EditorConfiguration and override the SetupStylesheets method. For example:

public class MyEditorConfiguration : Sitecore.Shell.Controls.RichTextEditor.EditorConfiguration
{
    public MyEditorConfiguration(Item profile) : base(profile) {}

    protected override void SetupStylesheets()
    {
        Item stylesheetsFolder = Profile.Children["Stylesheets"];
        if (stylesheetsFolder != null)
        {
            foreach (Item child in stylesheetsFolder.Children)
            {
                Editor.CssFiles.Add(child["Stylesheet Path"]);
            }
        }

        Item classesFolder = Profile.Children["Classes"];
        if (classesFolder != null)
        {
            foreach (Item child in classesFolder.Children)
            {
                Editor.CssClasses.Add(child["Label"], child["Selector"]);
            }
        }
    }
}

This code was adapted from a blog post I wrote years ago with the premise that I wanted to add items under the profile definition to control what style sheets were loaded and what classes appeared in the dropdown.

Once this code is deployed, you will need to set the Type field on the Configuration Type item under the editor profile to the type signature of your class.