Important

You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation 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