Documentation

Report Edit

HtmlElement

import {HtmlElement} from 'cx/widgets';

The HtmlElement widget is used to render HTML elements. All lowercase elements will be converted to the HtmlElement instances with the corresponding tag property set.

H4

Paragraph

Span

HtmlElements
<div style="width:200px" class="test">
   <h4>H4</h4>
   <p>Paragraph</p>
   <span>Span</span>
   <hr />
   <br />
   <input type="text" onRef={(el) => { console.log(el) }}  />
</div>
Copied!Cx Fiddle

All HTML attributes and events will be passed to the element. Cx specific attributes, such as visible, layout, controller, outerLayout and items work as expected.

Configuration

PropertyDescriptionType
autoFocus

Set to true to automatically focus the element when mounted.

boolean
baseClass

Base CSS class to be applied to the element. No class is applied by default.

string
class
className

Additional CSS classes to be applied to the element. If an object is provided, all keys with a "truthy" value will be added to the CSS class list.

string/object
innerHtml
html

HTML to be injected into the element.

string
items
children

List of child elements.

array
layout

Define an inner layout.

string/object
mod

Appearance modifier. For example, mod="big" will add the CSS class .cxm-big to the block element.

string/array
outerLayout

Defines the outer layout which wraps the widget.

widget
plainText

Set to true to avoid converting inner strings to templates. Default is false.

boolean
preserveWhitespace
ws

Keep whitespace in text based children. Default is false. See also trimWhitespace.

boolean
putInto
contentFor

Used with outer layouts. Specifies the name of the content placeholder which should render the widget.

string
style

Style object applied to the wrapper div. Used for setting the dimensions of the element.

string/object
tag

Name of the HTML element to be rendered. Default is div.

string
text
innerText

Inner text contents.

string
tooltip

Tooltip configuration. For more info see Tooltips.

string/object
trimWhitespace

Remove all whitespace in text based children. Default is true. See also preserveWhitespace.

boolean
vdomKey

Key that will be used as the key when rendering the React component.

string
visible
if

Visibility of the widget. Defaults to true.

boolean