New to Telerik UI for WinForms? Download free 30-day trial

HTML support

A major requirement for providing rich text editing capabilities is support for HTML. The RadRichTextEditor control is designed to offer import/export functionality for HTML out of the box – through the HtmlFormatProvider. However, as HTML is a diverse and complicated standard, supporting it comes with certain limitations. HtmlFormatProvider is designed to handle slightly malformed HTML (missing closing tags, missing quotes around attributes), however in this case correct parsing cannot be guaranteed. For best results we recommend importing valid XHTML content.

The purpose of this article is to outline which parts of the HTML are supported.

Importing

When the HtmlFormatProvider imports an HTML document, it parses it and converts the HTML element tree to a RadDocument. Importing is basically made up of two parts – content and styling.

Content

HTML content is mapped to several types of RadDocument elements – paragraphs, spans and tables.

Tags mapped to paragraphs are:

  • <p>

  • <h1> through <h6>

  • <ul>, <ol>, <li>

  • <tr>

Tags generating table content:

  • <table>

  • <tr>

  • <th>

  • <td>

The content of the <th> tags will be bold, as they are treated as table headers.

Tags mapped to spans are:

  • formatting tags, <span>, <font>

Additionally, line breaks are inserted between consequent block elements ( <div> ).

Styling

Styling is supported through CSS styles (classes or inline) and a number of formatting tags (including <font>). Although the <font> tag has been deprecated, legacy software and markup requires support for it.

Supported formatting tags are:

  • <b>, <strong> – turn on bold

  • <i>, <em> – turn on italic

  • <u> – turn on underline

  • <h1> through <h6> – apply heading

  • <sub> – turn on subscript

  • <sup> – turn on superscript

Supported CSS properties are:

  • text-align

  • margin-left

  • margin-right

  • color

  • background-color

  • font-family

  • font-size

  • font-style

  • font-weight

  • text-decoration (underline, line-through)

  • vertical-align (sub, super)

Supported <font> tag attributes are:

  • face – equivalent to CSS property font-family

  • size – equivalent to CSS property font-size

  • color – equivalent to CSS property color

Exporting

When exporting to HTML, the HtmlFormatProvider iterates through the RadDocument tree and generates HTML nodes. It is designed to generate valid XHTML document in order to preserve the formatting as much as possible. Styles are exported as CSS classes in the head of the document and used through the body. The structure of the HTML document closely resembles that of RadDocument – paragraphs and spans.

In this article