Options
All
  • Public
  • Public/Protected
  • All
Menu

Class Transformation<Data, Handler>

An operation that transforms the data tree.

Type parameters

Hierarchy

Index

Constructors

constructor

  • Parameters

    • editor: EditorAPI

      The editor for which this transformation is created.

    • transformationType: string

      The type of transformation.

    • desc: string

      The description of this transformation. A transformation's getDescriptionFor method will replace <name> with the name of the node actually being processed. So a string like Remove <name> would become Remove foo when the transformation is called for the element foo.

    • handler: Handler

      The handler to call when this transformation is executed.

    • Optional options: TransformationOptions

      Additional options.

    Returns Transformation

Properties

Protected abbreviatedDesc

abbreviatedDesc: string | undefined

An abbreviated description, suitable to put into a button, for instance.

boundHandler

boundHandler: function

Type declaration

    • (this: Action<Data>, ev: Event): void
    • Parameters

      • this: Action<Data>
      • ev: Event

      Returns void

boundTerminalHandler

boundTerminalHandler: function

Type declaration

    • (this: Action<Data>, ev: Event): boolean
    • Parameters

      • this: Action<Data>
      • ev: Event

      Returns boolean

Protected desc

desc: string

A simple string description of the action.

editor

editor: EditorAPI

The editor to which this action belongs.

handler

handler: Handler

Protected icon

icon: string

HTML code that represents an icon for this action. This can be a simple string or something more complex.

kind

kind: string

needsInput

needsInput: boolean

Indicates whether this action needs input from the user. For instance, an action which brings up a modal dialog to ask something of the user must have this parameter set to true. It is important to record whether an action needs input because, to take one example, the autoinsert logic will try to insert automatically any element it can. However, doing this for elements that need user input will just confuse the user (or could cause a crash). Therefore, it is important that the insertion operations for such elements be marked with needsInput set to true so that the autoinsert logic backs off from trying to insert these elements.

nodeType

nodeType: string

transformationType

transformationType: string

treatAsTextInput

treatAsTextInput: boolean

Methods

eventHandler

  • An event handler. By default just calls execute. You probably want to use boundHandler rather than rebind this method. This handler always returns undefined and calls preventDefault() on the event passed to it.

    Parameters

    Returns void

execute

  • execute(data: Data): void
  • Calls the fireTransformation method on this transformation's editor.

    Parameters

    • data: Data

      The data object to pass.

    Returns void

getAbbreviatedDescription

  • getAbbreviatedDescription(): string | undefined

getDescription

  • getDescription(): string

getDescriptionFor

  • getDescriptionFor(data: Data): string

getIcon

  • getIcon(): string

getLabelFor

  • getLabelFor(data: Data): string
  • This method returns the icon together with the description for the data passed as parameter.

    Parameters

    • data: Data

      The same data that would be passed to execute.

    Returns string

    The icon and the description, combined for presentation.

makeButton

terminalEventHandler

toString

  • toString(): string

Generated using TypeDoc