Please add the support for Outline to Headings Tag of Html's Conversion

[Xu]

Dear Telerik Developers,

 

Since the Xamarin Platform realize the Rich Text Editor by a webview control, I have to convert my Rtf files into html format before loading.

According to the Html Conversion document, headings ( h1 - h6 )  styles have nothing to do with the Outline Level,  and would be lost when exporting to other formats.

While in my scenario, the outline data of original Rtf document should be kept while converting back from html format to Rtf code.

My suggestion is adding a "EnableOutlineToHeadingsConversion" option to both HtmlImportSettings and  HtmlExportSettings classes, so that we can decide if the Outline level data should be converted into corresponding Headings Style ( for example, Outline Level 1 -> h1 ) and vice versa.

HtmlFormatProvider provider = new HtmlFormatProvider(); 
HtmlExportSettings exportSettings = new HtmlExportSettings(); 
  
exportSettings.BordersMinimalThickness = 1; 
exportSettings.DocumentExportLevel = DocumentExportLevel.Fragment; 
exportSettings.IndentDocument = true; 
exportSettings.EnableOutlineToHeadingsConversion = true;
 
provider.ExportSettings = exportSettings; 

 

I sincerely hope this could be taken into Telerik's developing consideration.

 

Regards,

Thank you very much. 

 

[Tanya]

Hi Xu,

We have already logged a task for this functionality on our public portal: WordsProcessing: Allow export and import of HTML heading tags (<h1>-<h6>) to and from paragraphs with Heading styles. Please, make sure to cast your vote for the implementation of the request. At this point, it is not scheduled for a particular release, thus I cannot say when it might be available. You can subscribe to track the status of the task using the Follow button on the linked item.

Hope this is useful.

Regards,
Tanya
Progress Telerik

[Xu]

Hello Tanya, 

Thank you for the information and I tracked and voted for the thread.

According to the documentation, "Headings" html tags are currently exported as styled paragraph. 

Is it possible to analyze the html code to find out the headings paragraphs by specific style?

 

[Tanya]

Hi Xu,

In the HTML, such paragraphs are exported with the TelerikHeadingN CSS class where N refers to the specific level.

However, if you would like to detect them after importing the HTML into a RadFlowDocument instance, these styles are resolved as local properties and you would need to check these properties and not the style name. Here is an example of how you could detect a heading paragraph according to the foreground applied to it:

System.Windows.Media.Color color = (System.Windows.Media.Color)System.Windows.Media.ColorConverter.ConvertFromString("#FF2F5496");
ThemableColor themableColor = new ThemableColor(color);
foreach (Paragraph paragraph in this.document.EnumerateChildrenOfType<Paragraph>())
{
    Telerik.Windows.Documents.Flow.Model.Styles.Core.IStyleProperty<ThemableColor> foregroundColor = paragraph.Properties.ParagraphMarkerProperties.ForegroundColor;
    if (foregroundColor.HasLocalValue && foregroundColor.LocalValue.Equals(themableColor))
    {
        // The paragraph has heading foreground
    }
}

Hope this will help you achieve the desired goal.

[Xu]

Thank you Tanya, for your outstanding explanation,

By your sample code , it seems that heading foreground can be detected, but levels can not.

But I guest writing a regex to replace TelerikHeadingNCSS with corresponding tag properties ( backgroundcolor might be a choice, from TelerikHeading1 - #FF2F5491  to  TelerikHeading6 - #FF2F5496), and detecting specified background colors after the conversion could be a solution.

I'll try it out.

 

Regards,

 

[Tanya]

Hi Xu,

I couldn't think of something that could potentially block you from doing that. I hope this approach will fit your needs.

[Xu]

Thank you Tanya, I accepted your reply as the answer and really appreciate it.

 

Regards

[Xu]

Hello Yana, to provide the best compatibility of multiplatform experience, I am using the original RichTextEditor for Uwp, and Telerik's Xamarin RichTextEditor to reading rtf format files.

After quite a lot of effort, I was able to covert the TelerikHeadingN class to RadFlowDocument with Outline levels, but found the outline data can only be saved for docx files, is there any possibility to keep the outline levels for rtf files ?

As we all know the rtf format does support outline levels.

[Tanya]

Hi Xu,

I have just tested to convert a DOCX document with heading styles to RTF and it seems like everything is converted as expected. The headings have been imported from the DOCX into a RadFlowDocument and successfully preserved in the RTF document. Can you share more details on the scenario you have? Is there something I am missing?