CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Typedef

ElementDefinition (engine/view)

@ckeditor/ckeditor5-engine/src/view/elementdefinition

typedef
String | Object
See source

A plain object that describes a view element in a way that a concrete, exact view element could be created from that description.

const viewDefinition = {
	name: 'h1',
	classes: [ 'foo', 'bar' ]
};

Above describes a view element:

<h1 class="foo bar"></h1>

An example with styles and attributes:

const viewDefinition = {
    name: 'span',
    styles: {
        'font-size': '12px',
        'font-weight': 'bold'
    },
    attributes: {
        'data-id': '123'
    }
};

Describes:

<span style="font-size:12px;font-weight:bold" data-id="123"></span>

Elements without attributes can be given simply as a string:

const viewDefinition = 'p';

Which will be treated as:

const viewDefinition = {
	name: 'p'
};

Filtering

Properties

  • attributes : Object

    Object with key-value pairs representing attributes. Each object key represents attribute name. Value under that key must be a string.

  • classes : String | Array.<String>

    Class name or array of class names to match. Each name can be provided in a form of string.

  • name : String

    View element name.

  • priority : Number

    Element's priority.

  • styles : Object

    Object with key-value pairs representing styles. Each object key represents style name. Value under that key must be a string.