Class

RootAttributeOperation (engine/model/operation)

@ckeditor/ckeditor5-engine/src/model/operation/rootattributeoperation

class

Operation to change root element's attribute. Using this class you can add, remove or change value of the attribute.

This operation is needed, because root elements can't be changed through

Filtering

Properties

  • inherited

    baseVersion : Number

    version on which operation can be applied. If you try to apply operation with different base version than the document version the model-document-applyOperation-wrong-version error is thrown.

  • inherited

    batch : Batch | null

    Batch to which the operation is added or null if the operation is not added to any batch yet.

  • readonly inherited

    isDocumentOperation : Boolean

    Defines whether operation is executed on attached or detached items.

  • readonly

    key : String

    Key of an attribute to change or remove.

  • readonly

    newValue : *

    New value to set for the attribute. If null, then the operation just removes the attribute.

  • readonly

    oldValue : *

    Old value of the attribute with given key or null if adding a new attribute.

  • readonly

    root : RootElement

    Root element to change.

  • readonly inherited

    type : String

    Operation type.

Static properties

  • inherited static

    className : String

    Name of the operation class used for serialization.

Methods

  • constructor( root, key, oldValue, newValue, baseVersion )

    Creates an operation that changes, removes or adds attributes on root element.

    Parameters

    root : RootElement

    Root element to change.

    key : String

    Key of an attribute to change or remove.

    oldValue : *

    Old value of the attribute with given key or null if adding a new attribute.

    newValue : *

    New value to set for the attribute. If null, then the operation just removes the attribute.

    baseVersion : Number | null

    Document version on which operation can be applied or null if the operation operates on detached (non-document) tree.

    Related:

  • clone() → RootAttributeOperation

    Creates and returns an operation that has the same parameters as this operation.

    Returns

    RootAttributeOperation

    Clone of this operation.

  • getReversed() → RootAttributeOperation

  • inherited

    toJSON() → Object

    Custom toJSON method to solve child-parent circular dependencies.

    Returns

    Object

    Clone of this object with the operation property replaced with string.

  • protected inherited

    _execute()

    Executes the operation - modifications described by the operation properties will be applied to the model tree.

  • protected inherited

    _validate()

    Checks whether the operation's parameters are correct and the operation can be correctly executed. Throws an error if operation is not valid.

Static methods

  • static

    fromJSON( json, document ) → RootAttributeOperation

    Creates RootAttributeOperation object from deserilized object, i.e. from parsed JSON string.

    Parameters

    json : Object

    Deserialized JSON object.

    document : Document

    Document on which this operation will be applied.

    Returns

    RootAttributeOperation