OOUI/Elements

Translate this page

The most basic component of the OOUI^[1] library is called an element (OO.ui.Element), which is an object that represents a rendering in the DOM^[2] — a button or an icon, for example, or anything that is visible to a user. Unlike widgets, plain elements usually do not have events connected to them and can't be interacted with.

Every OOUI element has an $element property, which is a jQuery selection of its rendered contents. Note that OOUI uses the $ prefix for the names of all variables and properties that refer to jQuery selections of DOM elements. The $element property is extremely useful, and is used, for example, when creating OOUI widgets and appending them to the DOM.

Example

// Create a <div></div> element object with the text “Sample Text“ and CSS class `sample`.
var e = new OO.ui.Element( {
	text: 'Sample Text',
	classes: [ 'sample' ]
} );

// Append the element to the DOM.
$( 'body' ).append( e.$element );

The resulting HTML will look like this:

<body>
	<div class="sample">Sample Text</div>
</body>

Elements

References

↑ OOUI (Object-Oriented User Interface)
↑ DOM (Document Object Model)

[ooui-1] OOUI (Object-Oriented User Interface)

[dom-2] DOM (Document Object Model)

[1]

[2]