CKEDITOR.ui.balloonToolbarView

Properties

• inherited

  activeShowListeners : ObjectCKEDITOR.ui.balloonToolbarView#activeShowListeners

  See source

  Event listeners associated with this balloon panel, active as long as the panel is shown. See addShowListener, activateShowListeners, deactivateShowListeners.

  Defaults to {}

• inherited

  editor : ObjectCKEDITOR.ui.balloonToolbarView#editor

  See source

  The editor for this balloon panel.

• inherited

  focusables : ObjectCKEDITOR.ui.balloonToolbarView#focusables

  See source

  Focusable elements in this balloon panel. See registerFocusable, deregisterFocusable and CKEDITOR.focusManager.

  Defaults to {}

• inherited

  height : StringCKEDITOR.ui.balloonToolbarView#height

  See source

  The default height of the balloon panel.

  Defaults to 'auto'

• inherited

  parts : ObjectCKEDITOR.ui.balloonToolbarView#parts

  See source

  The UI elements of the balloon panel.

  Defaults to {}

• inherited

  rect : ObjectCKEDITOR.ui.balloonToolbarView#rect

  See source

  Contains panel properties as move, resize, show and hide are called. It stores values and avoids unnecessary and expensive checks in the future.

  Defaults to {visible: false}

• inherited

  showListeners : ObjectCKEDITOR.ui.balloonToolbarView#showListeners

  See source

  Event listeners associated with this balloon panel, activated on panel show. See addShowListener, activateShowListeners, deactivateShowListeners.

  Defaults to {}

• inherited

  templateDefinitions : ObjectCKEDITOR.ui.balloonToolbarView#templateDefinitions

  See source

  Balloon panel templates. Automatically converted into a CKEDITOR.template in the panel constructor.

• inherited

  templates : ObjectCKEDITOR.ui.balloonToolbarView#templates

  See source

  Templates for UI elements in this balloon panel. See templateDefinitions, parts.

  Defaults to {}

• inherited

  triangleHeight : NumberCKEDITOR.ui.balloonToolbarView#triangleHeight

  See source

  The default height of the triangle that points to the element in the editable.

  Defaults to 20

• inherited

  triangleMinDistance : NumberCKEDITOR.ui.balloonToolbarView#triangleMinDistance

  See source

  The default distance between the triangle and the vertical edge of the panel.

  Defaults to 40

• inherited

  triangleWidth : NumberCKEDITOR.ui.balloonToolbarView#triangleWidth

  See source

  The default width of the triangle that points to the element in the editable.

  Defaults to 20

• inherited

  width : NumberCKEDITOR.ui.balloonToolbarView#width

  See source

  The default width of the balloon panel.

  Defaults to 360

• private

  _listeners : ArrayCKEDITOR.ui.balloonToolbarView#_listeners

  See source

  Listeners registered by this toolbar view.

  Defaults to []

• private

  _pointedElement : ObjectCKEDITOR.ui.balloonToolbarView#_pointedElement

  See source

  The DOM element used by the balloon toolbar to attach to.

Methods

• since 4.8.0

  constructor( editor, definition ) → balloonToolbarViewCKEDITOR.ui.balloonToolbarView#constructor

  See source

  Creates a balloon toolbar view instance.

  Parameters

  editor : editor

  The editor instance for which the toolbar is created.

  definition : Object

  An object containing the toolbar definition. See CKEDITOR.ui.balloonPanel documentation for an example definition.

  Returns

  balloonToolbarView

• inherited

  _getViewPaneRect( window ) → ObjectCKEDITOR.ui.balloonToolbarView#_getViewPaneRect

  See source

  Parameters

  window : window

  Returns

  Object

  Returns viewport position, taking scroll offset into account.

  Properties

  top : Number

  bottom : Number

  left : Number

  right : Number

• inherited

  activateShowListener( id )CKEDITOR.ui.balloonToolbarView#activateShowListener

  See source

  Activates an event listener associated with this balloon panel. See showListeners, activeShowListeners, deactivateShowListener, addShowListener, removeShowListener.

  Parameters

  id : Object

• inherited

  activateShowListeners()CKEDITOR.ui.balloonToolbarView#activateShowListeners

  See source

  Activates all event listeners associated with this balloon panel. See showListeners, activeShowListeners, deactivateShowListeners, addShowListener, removeShowListener.

• inherited

  addShowListener( listener ) → ObjectCKEDITOR.ui.balloonToolbarView#addShowListener

  See source

  Adds an event listener associated with this balloon panel. This listener will be activated on panel show and deactivated on panel hide. See showListeners, activeShowListeners, activateShowListeners, deactivateShowListeners.

  Parameters

  listener : Function

  A function that, if called, attaches the listener and returns the listener object.

  Returns

  Object

  An object containing the removeListener method that removes the listener from the collection.

• inherited

  attach( elementOrSelection, [ options ] )CKEDITOR.ui.balloonToolbarView#attach

  See source

  Places the balloon panel next to a specified element or a selection so the tip of the balloon's triangle touches that element or the center of the selection. Once the panel is attached it gains focus.

  Parameters

  elementOrSelection : element | selection

  The element or selection to which the panel is attached. Since 4.11.0 instead of an element it is possible to pass a selection CKEDITOR.dom.selection.

  [ options ] : Object | element | Boolean

  Since 4.8.0 this parameter works as an options object.

  If a CKEDITOR.dom.element/Boolean instance is given, this parameter acts as an options.focusElement.

• inherited

  blur()CKEDITOR.ui.balloonToolbarView#blur

  See source

  Moves the focus back to the editor's editable.

• inherited

  build()CKEDITOR.ui.balloonToolbarView#build

  See source

  Builds the UI of the balloon panel.

• inherited

  deactivateShowListener( id )CKEDITOR.ui.balloonToolbarView#deactivateShowListener

  See source

  Deactivates an event listener associated with this balloon panel. See activateShowListener.

  Parameters

  id : Object

• inherited

  deactivateShowListeners()CKEDITOR.ui.balloonToolbarView#deactivateShowListeners

  See source

  Removes all event listeners associated with this balloon panel. See activateShowListeners.

• inherited

  deregisterFocusable( element )CKEDITOR.ui.balloonToolbarView#deregisterFocusable

  See source

  Unregisters an element from editor's focus manager. See focusables.

  Parameters

  element : element

  An element to be registered.

• inherited

  destroy()CKEDITOR.ui.balloonToolbarView#destroy

  See source

  Destroys the balloon panel by removing it from DOM and purging all associated event listeners.

• inherited

  getHeight() → NumberCKEDITOR.ui.balloonToolbarView#getHeight

  See source

  Returns the balloon panel height.

  Returns

  Number

• inherited

  getWidth() → NumberCKEDITOR.ui.balloonToolbarView#getWidth

  See source

  Returns the balloon panel width.

  Returns

  Number

• inherited

  hide()CKEDITOR.ui.balloonToolbarView#hide

  See source

  Hides the balloon panel and moves the focus back to the editable.

• inherited

  move( top, left )CKEDITOR.ui.balloonToolbarView#move

  See source

  Moves the upper-left balloon panel corner to the specified absolute position.

  Parameters

  top : Number

  left : Number

• inherited

  registerFocusable( element )CKEDITOR.ui.balloonToolbarView#registerFocusable

  See source

  Registers a new focusable element in the editor's focus manager so the instance does not blur once the child of the balloon panel gains focus. See focusables.

  Parameters

  element : element

  An element to be registered.

• inherited

  removeShowListener( id )CKEDITOR.ui.balloonToolbarView#removeShowListener

  See source

  Removes an event listener associated with this balloon panel visible state. See addShowListener.

  Parameters

  id : Number

  An ID of the listener.

• renderItems( items )CKEDITOR.ui.balloonToolbarView#renderItems

  See source

  Renders provided UI elements inside the view.

  Parameters

  items : button[] | richCombo[]

  An array of UI element objects.

• since 4.12.0

  reposition()CKEDITOR.ui.balloonToolbarView#reposition

  See source

  Repositions the balloon toolbar, pointing to the previously attached element.

• inherited

  resize( width, height )CKEDITOR.ui.balloonToolbarView#resize

  See source

  Resizes the balloon panel container to given dimensions. Use 'auto' to make the dimensions of the panel flexible.

  Parameters

  width : Number

  height : Number

• inherited

  setTitle( title )CKEDITOR.ui.balloonToolbarView#setTitle

  See source

  Sets the balloon panel title.

  Parameters

  title : String

  A new panel title.

• inherited

  setTriangle( side )CKEDITOR.ui.balloonToolbarView#setTriangle

  See source

  Changes the position of the balloon's triangle that points to the element in the editable.

  Parameters

  side : String

  One of 'left', 'right', 'top' or 'bottom'.

• inherited

  show()CKEDITOR.ui.balloonToolbarView#show

  See source

  Shows the balloon panel.

• private inherited

  _adjustElementRect( elementRect, editorRect )CKEDITOR.ui.balloonToolbarView#_adjustElementRect

  See source

  This method will modify elementRect if the element is outside of editorRect. If it is outside, it is going to change it into a rectangle that is within editorRect.

  For example here elementRect is going to be changed into a very narrow rectangle (with unmodified height) representation within editorRect.

  +------------------------------------------+
  |                                          |
  |                                         #|          +----------+
  |                                         #|          |          |
  |                                         #|          |          |
  |               editorRect                #|          |elmentRect|
  |                                         #|          |          |
  |                                         #|          |          |
  |                                         #|          +----------+
  |                                          |
  +------------------------------------------+
  

  Parameters

  elementRect : Object

  Rectangle object that should be contained within editorRect. This object might be modified.

  editorRect : Object

  Reference container that should contain elementRect.

• since 4.9.0 private

  _deregisterItemFocusables()CKEDITOR.ui.balloonToolbarView#_deregisterItemFocusables

  See source

  Deregisters focusables registered by UI items, like buttons.

• private

  _detachListeners()CKEDITOR.ui.balloonToolbarView#_detachListeners

  See source

  Detaches all listeners.

• private inherited

  _getAlignments( elementRect, panelWidth, panelHeight ) → ObjectCKEDITOR.ui.balloonToolbarView#_getAlignments

  See source

  Returns a dictionary containing different alignment positions.

  Keys tell where the balloon is positioned relative to the element, e.g. this would be the result for "top center":

  [Editor]
  +-------------------------------------+
  |         [Panel]                     |
  |         +-----------------+         |
  |         |                 |         |
  |  [El.]  +--------v--------+         |
  |  +-------------------------------+  |
  |  |                               |  |
  |  |                               |  |
  +--+-------------------------------+--+
  

  Sample result:

  {
      "right vcenter": { top: 529.5, left: 175 },
      "left vcenter": { top: 529.5, left: 10},
      "top hcenter": { top: 402, left: 92.5},
      "top left": { top: 402, left: 102.5},
      "top right": { top: 402, left: 82.5},
      "bottom hcenter": { top: 643, left: 92.5},
      "bottom left": { top: 643, left: 102.5},
      "bottom right": { top: 643, left: 82.5}
  }
  

  Parameters

  elementRect : Object

  panelWidth : Number

  panelHeight : Number

  Returns

  Object