DOT

VVM

 DOCS

Version: 1.0 | 1.1 |

HtmlLiteral

in namespace DotVVM.Framework.Controls

Renders a text into the page.

Properties

Name Type Description Notes Default Value
Attributes Dictionary<String,Object>
attribute
inner element
static value
bindable
default
ClientIDMode ClientIDMode Gets or sets the client ID generation algorithm.
attribute
inner element
static value
bindable
default
Static
DataContext Object Gets or sets a data context for the control and its children. All value and command bindings are evaluated in context of this value.
attribute
inner element
static value
bindable
default
Html String Gets or sets the HTML that will be rendered in the control.
attribute
inner element
static value
bindable
default
ID String Gets or sets the unique control ID.
attribute
inner element
static value
bindable
default
InnerText String Gets or sets the inner text of the HTML element.
attribute
inner element
static value
bindable
default
RenderWrapperTag Boolean Gets or sets the name of the tag that wraps the HtmlLiteral.
attribute
inner element
static value
bindable
default
True
Visible Boolean Gets or sets whether the control is visible.
attribute
inner element
static value
bindable
default
True
WrapperTagName String Gets or sets whether the control should render a wrapper element.
attribute
inner element
static value
bindable
default
div

Events

Name Type Description

Usage & Scenarios

This control is used to render raw HTML content in the page.

Be very careful when using this control. If you allow users to enter HTML into your application and then you render this HTML, it can make your application vulnerable. Always make sure that the HTML you pass in this control is safe and doesn't contain any scripts because the browser would have run them.

If you want to render a text in the page, use the Literal control instead.

HTML Rendered by the Control

By default, the control renders a <div> element which will contain the specified HTML. You can change it to any other tag name using the WrapperTagName property.

<div data-bind="html: expression"></div>

If you set the RenderWrapperTag to false, only the pure HTML content will be rendered. However, removing the wrapper tag is supported only in the Server rendering mode.

Sample 1: Basic HtmlLiteral

Use the Html property to supply the raw HTML to be rendered.

<dot:HtmlLiteral Html="{value: Html}" />
using System;
using System.Threading;
using DotVVM.Framework.ViewModel;

namespace DotvvmWeb.Views.Docs.Controls.builtin.HtmlLiteral.sample1
{
    public class ViewModel : DotvvmViewModelBase
    {
        public string Html => "Hello <strong>DotVVM</strong>";
    }
}

Suggestions


Help & Contribute

The documentation is maintained on GitHub.
We'll be happy if you edit the page and create a pull request.

Send message