Additional <HEAD> Content

This setting allows additional HTML content to be added to the <head> element of the dashboard HTML. Examples of such content include HTML tags used for loading custom styles, fonts, or scripts.

Dashboards are loaded with additional <HEAD> Content specified by merging the <HEAD> Content of the following:

  • Additional <HEAD> content specified for the current dashboard

  • Any <HEAD> content from the current template dashboard, if the current dashboard is being loaded by a template

  • Any <HEAD> content specified by the <HEAD> content property of the Web UI plugin settings.

When the <HEAD> content specified by the Web UI plugin settings includes <script> tags, those scripts are loaded only once per browser tab/page lifecycle and are not executed again when another dashboard is opened in the same browser tab.

To prevent duplicate loading and repeated execution, each such <script> tag must have a unique id within the page. If no id is provided, it is generated automatically by the platform.

Configuration

Each row of the <HEAD> Content table defines a tag to be added to the <head> content of the dashboard HTML.

Field Description

Field Name

Tag Name. Defines the name of the tag.

name

Tag Attributes. Defines a list of tag attributes:

  • Name. Defines the tag attribute name.

  • Value Expression. An expression which evaluates to the tag attribute value string. The resolution environment and conditions are the same as Content Expression.

attributes

Content Expression. An expression that must evaluate to a string, which is processed as the tag content value. The expression is evaluated at the moment the dashboard is being opened. Evaluation result is HTML-escaped before inserted into the HTML markup.

contentExpression

Value Expression and Content Expression Resolution Environment:

Default Context

Dashboard context.

Default Data Table

None.

Default Row

0

Environment Variables

Standard variables only.

Example

The following table shows how a custom stylesheet can be defined for insertion into the <head> element.

Tag Name

Tag Attributes

Content Expression

link

Two entries:

  • Name: href

  • Value Expression: customstyles.css

  • Name: rel

  • Value Expression: stylesheet

-

The additional HTML element described above will appear in the <head> element as shown below. 

<head>
    <meta charset="UTF-8"/>
    ...other tags...
    <link rel="stylesheet" href="customstyles.css"> 
</head>

Was this page helpful?