Introduction: Shielded HTML Viewer

You are here:

Visualise your HTML formatted content to add valuable context to your figures

Most business applications allow users to enrich the data by adding additional context. Often, this additional context (like comments and feedback) is stored as HTML formatted text. This allows the user to not only include the content, but also apply all kinds of formatting to the content (like Bold, Italic, lists, tables, etc.).
Being able to show this additional context adds value to reports and dashboard, as it helps the readers to better understand the presented figures.
The Shielded HTML Viewer will seamlessly display any HTML-5 formatted text next to other figures in your Power BI reports.
The Shielded HTML Viewer will only process and render HTML-tags and -attributes that are specified in our allow-list. This to mitigate potential security risks (such as inline scripting). Any tag or attribute not specified on the allow-list will be ignored.
The basic functionality of the Shielded HTML Viewer is available for free and will display the HTML formatted text. The licensed version contains additional features like changing the default font, default text-color and switching between single row and multi-row display. Interested in trying the licensed features? Just turn on the Paid Features option and they will be visible.

How to use: Fields

You need to specify one single field, being: HTML Data. Here you add the field containing the HTML data you want to display.

The Shielded HTML Viewer makes use of an allow-list to avoid unexpected results. The allow-list contains the following HTML5-elements:

  • Content sectioning: h1, h2, h3, h4, h5, h6
  • Text content: blockquote, dd, div, dl, dt, hr, li, ol, p, pre, ul
  • Inline text semantics: a, b, br, code, em, i, q, s, small, span, strong, sub, sup, wbr
  • Table content: caption, col, colgroup, table, tbody, td, tfoot, th, thead, tr

How to use: Format

Besides the standard Format Sections there are a number of additional Format Sections that allow you to change the default behaviour of the visual:

  • License: here you can switch on the Paid Features and fill your license details. The next two sections are only available when the Paid Features are turned on.
  • Display Mode: by default the Shielded HTML Viewer will parse all the HTML of the allow-list and show the formatted result. Here you can decide to Show the blocked tags, Show the content of the blocked tags or show multiple rows.
  • Style: the HTML you supply will probably contain most style options, but here you can change the default behaviour for those elements that do not have any specific style options specified.

For any questions or remarks about this Custom Visual, please contact us by email at Nova Silva Support.

Next Tutorial: how to use the Shielded HTML Viewer
Table of Contents