Important

You are browsing documentation for version 5.0 of OroCommerce. Support of this version ended in January 2025. Read the documentation for version 6.1 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

TextEditorView ⇐ BaseView

Text cell content editor. This view is used by default (if no frontend type has been specified).

Column configuration examples:

datagrids:
  {grid-uid}:
    inline_editing:
      enable: true
    # <grid configuration> goes here
    columns:
      # Sample 1. Mapped by frontend type
      {column-name-1}:
        frontend_type: string
      # Sample 2. Mapped by frontend type and placeholder specified
      {column-name-2}:
        frontend_type: string
        inline_editing:
          editor:
            view_options:
              placeholder: '<placeholder>'
      # Sample 3. Full configuration
      {column-name-3}:
        inline_editing:
          editor:
            view: oroform/js/app/views/editor/text-editor-view
            view_options:
              placeholder: '<placeholder>'
              css_class_name: '<class-name>'
          validation_rules:
            NotBlank: ~
            Length:
              min: 3
              max: 255
          save_api_accessor:
              route: '<route>'
              query_parameter_names:
                 - '<parameter1>'
                 - '<parameter2>'

Options in YML

Column Option Name	Description
inline_editing.editor.view_options.placeholder	Optional. Placeholder translation key for an empty element
inline_editing.editor.view_options.placeholder_raw	Optional. Raw placeholder value
inline_editing.editor.view_options.css_class_name	Optional. Additional css class name for editor view DOM element
inline_editing.validation_rules	Optional. Validation rules. See JS Validation
inline_editing.save_api_accessor	Optional. Sets accessor module, route, parameters etc.

Constructor Parameters

Extends: BaseView

Param	Type	Description
options	Object	Options container
options.model	Object	Current row model
options.className	string	CSS class name for editor element
options.fieldName	string	Field name to edit in model
options.placeholder	string	Placeholder translation key for an empty element
options.placeholder_raw	string	Raw placeholder value. It overrides placeholder translation key
options.validationRules	Object	Validation rules. See JS Validation
options.value	string	initial value of edited field

• TextEditorView ⇐ BaseView

  • .ARROW_LEFT_KEY_CODE

  • ._isFocused

  • .getPlaceholder() ⇒ string

  • .showBackendErrors(backendErrors

  • .getFormState() ⇒ Object

  • .setFormState(value)

  • .focus(atEnd)

  • .onFocusin(e)

  • .onFocusout(e)

  • .onMousedown(e)

  • .blur()

  • .getValidationRules()](#module_TextEditorView#getValidationRules) ⇒ Object

  • .getRawModelValue()](#module_TextEditorView#getRawModelValue) ⇒ *

  • .formatRawValue(value)](#module_TextEditorView#formatRawValue) ⇒ string

  • .parseRawValue(value)](#module_TextEditorView#parseRawValue) ⇒ *

  • .getModelValue()](#module_TextEditorView#getModelValue) ⇒ string

  • .getValue()](#module_TextEditorView#getValue) ⇒ string

  • .rethrowAction() ⇒ string

  • .rethrowEvent()

  • .isChanged() ⇒ boolean

  • .isValid() ⇒ boolean

  • .updateSubmitButtonState()

  • .onGenericKeydown(e)

  • .onGenericEnterKeydown(e)

  • .onGenericTabKeydown(e)

  • .onGenericEscapeKeydown(e)

  • .onGenericArrowKeydown(e)

  • .getServerUpdateData() ⇒ Object

  • .getModelUpdateData() ⇒ Object

textEditorView.ARROW_LEFT_KEY_CODE

Arrow codes

Kind: instance property of TextEditorView

textEditorView._isFocused

Internal focus tracking variable

Kind: instance property of TextEditorView Access: protected

textEditorView.getPlaceholder() ⇒ string

Returns placeholder

Kind: instance method of TextEditorView

textEditorView.showBackendErrors(backendErrors)

Shows backend validation errors

Kind: instance method of TextEditorView

Param	Type	Description
‘backendErrors”	Object	Map of field name to its error

textEditorView.getFormState() ⇒ Object

Reads state of form (map of element name to its value)

Kind: instance method of TextEditorView

textEditorView.setFormState(value)

Set values to form elements

Kind: instance method of TextEditorView

Param	Type	Description
value	Object	Map of element name to its value

textEditorView.focus(atEnd)

Places focus on the editor

Kind: instance method of TextEditorView

Param	Type	Description
atEnd	boolean	Useful for multi input editors. Specifies which input should be focused: first or last

### textEditorView.onFocusin(e)

Handles focusin event

Kind: instance method of [TextEditorView](#module_TextEditorView)

Param	Type
e	jQuery.Event

textEditorView.onFocusout(e)

Handles focusout event

Kind: instance method of TextEditorView

Param	Type
e	jQuery.Event

textEditorView.onMousedown(e)

Handles mousedown event

Kind: instance method of [TextEditorView](#module_TextEditorView)

Param	Type
e	jQuery.Event

textEditorView.blur()

Turn view into blur

Kind: instance method of TextEditorView

textEditorView.getValidationRules() ⇒ Object

Prepares validation rules for usage

Kind: instance method of TextEditorView

textEditorView.getRawModelValue() ⇒ *

Reads proper model’s field value

Kind: instance method of TextEditorView

textEditorView.formatRawValue(value) ⇒ string

Converts model value to the format that can be passed to a template as field value

Kind: instance method of TextEditorView

Param	Type
value	*

textEditorView.parseRawValue(value) ⇒ *

Parses value that is stored in model

Kind: instance method of TextEditorView

Param	Type
value	*

textEditorView.getModelValue() ⇒ string

Returns the raw model value

Kind: instance method of TextEditorView

textEditorView.getValue() ⇒ string

Returns the current value after user edit

Kind: instance method of TextEditorView

textEditorView.rethrowAction() ⇒ string

Generic handler for buttons which allows to notify overlaying component about some user action. Any button with ‘data-action’ attribute will rethrow the action to the inline editing plugin.

Available actions:

• save

• cancel

• saveAndEditNext

• saveAndEditPrev

• cancelAndEditNext

• cancelAndEditPrev

Sample usage:

<button data-action="cancelAndEditNext">Skip and Go Next</button>

Kind: instance method of TextEditorView

textEditorView.rethrowEvent()

Generic handler for DOM events. Used on form to allow processing that events outside view.

Kind: instance method of TextEditorView

textEditorView.isChanged() ⇒ boolean

Returns true if the user has changed the value

Kind: instance method of TextEditorView

textEditorView.isValid() ⇒ boolean

Returns true if the user entered valid data

Kind: instance method of TextEditorView

textEditorView.updateSubmitButtonState()

Set a submit button disabled state relevant input value

Kind: instance method of TextEditorView

#textEditorView.onGenericKeydown(e)

Refers keydown action to proper action handler

Kind: instance method of [TextEditorView](#module_TextEditorView)

Param
e

textEditorView.onGenericEnterKeydown(e)

Generic keydown handler, which handles ENTER

Kind: instance method of TextEditorView

Param	Type
e	$.Event

textEditorView.onGenericTabKeydown(e)

Generic keydown handler, which handles TAB

Kind: instance method of TextEditorView

Param	Type
e	$.Event

textEditorView.onGenericEscapeKeydown(e)

Generic keydown handler, which handles ESCAPE

Kind: instance method of TextEditorView

Param	Type
e	$.Event

textEditorView.onGenericArrowKeydown(e)

Generic keydown handler, which handles ARROWS

Kind: instance method of TextEditorView

Param	Type
e	$.Event

textEditorView.getServerUpdateData() ⇒ Object

Returns data which should be sent to the server

Kind: instance method of TextEditorView

textEditorView.getModelUpdateData() ⇒ Object

Returns data for the model update

Kind: instance method of TextEditorView