Class: Panel

Help4.control2.bubble.Panel(params)

Creates the bubble for the SAP Companion 4 panel.

Constructor

new Panel(params)

Parameters:
Name Type Description
params Help4.control2.bubble.Panel.Params
Properties:
Name Type Attributes Description
logoSrc string <nullable>
 URL to possible logo
showBackButton boolean whether to show back button
showDockButton boolean whether to show dock button
showMinimizeButton boolean whether to show minimize button
showCloseButton boolean whether to show close button
showTranslationButton boolean whether to show the translation button
translation boolean whether translation is enabled
animateTranslationButton boolean whether to animate the translation button
docked boolean whether panel is docked
minimized boolean whether panel is minimized
caption string <nullable>
 caption text
showCaption boolean caption text
showTiles boolean whether to show the widget tiles
showContentArea boolean whether to show the content area
showSearch boolean whether to show search
searchTerm string the search term
brandingLogoSrc string <nullable>
 image source URL to possible branding logo
brandingLogoUrl string <nullable>
 navigation link to possible branding logo
showEditButton boolean whether to show the edit button
showPublishViewButton boolean whether to show the publish view button
showWmButton boolean whether to show the wm button
publishView boolean whether publish view is enabled
publishedState string <nullable>
 published state of the widget content
Source:

Extends

Methods

(protected) ____defineDataFunctions()

Overrides:
Source:

(protected) ____defineProperties(params, derivedopt, nullable)

Parameters:
Name Type Attributes Default Description
params Object
derived Object <optional>
<nullable>
 null
Properties
Name Type Description
GET Object
SET Object
Overrides:
Source:

(protected) ____defineProperty(args)

Parameters:
Name Type Description
args Object
Properties
Name Type Attributes Default Description
type string <optional>
 'param' for Help4.jscore.DataBase
key string
info Help4.jscore.ControlBase.Param
funGet Help4.jscore.ControlBase.FunGet
funSet Help4.jscore.ControlBase.FunSet
Overrides:
Source:

(protected) ____defineStaticProperties()

auto define all to be cleaned properties
Overrides:
Source:
Throws:
Error

(protected) ____extendParams(dest, src) → {Object}

Parameters:
Name Type Description
dest Object
src Object
Overrides:
Source:
Returns:
Type
Object

(protected) ____getClassConfig() → {Help4.jscore.Base.Params}

Overrides:
Source:
Returns:
Type
Help4.jscore.Base.Params

(protected) ____getData() → {Object}

Overrides:
Source:
Returns:
Type
Object

(protected) ____mergeDerivedParams(level0, level1)

Parameters:
Name Type Description
level0 Help4.jscore.Base.Params
level1 Help4.jscore.Base.Params
Overrides:
Source:
Throws:
Error

(protected) ____resolveDerivedParams(classConfig)

Parameters:
Name Type Description
classConfig Help4.jscore.Base.Params
Overrides:
Source:

(protected) ____setInitValue(args)

Parameters:
Name Type Description
args Object
Properties
Name Type Description
key string
info Help4.jscore.ControlBase.Param
params Object
funSet Help4.jscore.ControlBase.FunSet
Overrides:
Source:

(protected) _applyTextAttribute(node, textId, value)

used to support text extraction and replacement
Parameters:
Name Type Default Description
node HTMLElement
textId string
value boolean true
Overrides:
Source:

(protected) _createControl(object, params) → {Help4.control2.Control}

Parameters:
Name Type Description
object function
params Help4.control2.Control.Params
Overrides:
Source:
Returns:
Type
Help4.control2.Control

(protected) _createElement(tagName, params) → {HTMLElement}

creates a new DOM element within my control's DOM
Parameters:
Name Type Description
tagName string tag name of new DOM element
params Object additional parameters
Overrides:
Source:
Returns:
Type
HTMLElement

(protected) _destroyControl(…keys)

destroys class properties
Parameters:
Name Type Attributes Description
keys string <repeatable>
Overrides:
Source:

(protected) _fireEvent(event) → {Help4.jscore.Base}

fires an event that can be observed from outside
Parameters:
Name Type Description
event Object the event to be fired
Overrides:
Source:
Returns:
Type
Help4.jscore.Base

(async, protected) _fireEvent2(event) → {Promise.<Array.<Help4.EmbeddedEvent.EventResponse>>}

fires an event that can be observed from outside
Parameters:
Name Type Description
event Object the event to be fired
Overrides:
Source:
Returns:
Type
Promise.<Array.<Help4.EmbeddedEvent.EventResponse>>

(protected) _fireEventSync(event) → {Array.<Help4.EmbeddedEvent.EventResponse>}

fires an event that can be observed from outside
Parameters:
Name Type Description
event Object the event to be fired
Overrides:
Source:
Returns:
Type
Array.<Help4.EmbeddedEvent.EventResponse>

(protected) _onAfterInit(params)

called after init
Parameters:
Name Type Description
params Help4.control2.Control.Params same params as provided to the constructor
Overrides:
Source:

(protected) _onCreateContent()

incompatible override!
Overrides:
Source:

(protected) _onCreateFooter()

incompatible override!
Overrides:
Source:

(protected) _onCreateHeader()

incompatible override!
Overrides:
Source:

(protected) _onDomAttached(dom)

called once the DOM node is attached
Parameters:
Name Type Description
dom HTMLElement control DOM
Overrides:
Source:

(protected) _onDomAvailable(dom)

called once the DOM node is available but not yet attached
Parameters:
Name Type Description
dom HTMLElement control DOM
Overrides:
Source:

(protected) _onDomFocussed(dom)

called once the DOM's event listeners are attached and the DOM's automatic focus is applied
Parameters:
Name Type Description
dom HTMLElement control DOM
Overrides:
Source:

(protected) _onDragMove()

called on every move of the control during drag & drop
Overrides:
Source:

(protected) _onDragStart()

called once the control starts drag & drop
Overrides:
Source:

(protected) _onDragStop()

called once drag & drop ends
Overrides:
Source:

(protected) _onGetDragDropParams() → {Help4.control2.DragDropParams}

called to configure drag & drop properly
Overrides:
Source:
Returns:
- allows to define specific DOM (object) and dragable area (area)
Type
Help4.control2.DragDropParams

(protected) _removeTextAttribute(node, …textId)

used to support text extraction and replacement
Parameters:
Name Type Attributes Description
node HTMLElement
textId string <repeatable>
Overrides:
Source:

(protected) _setTextAttribute(node, …textId)

used to support text extraction and replacement
Parameters:
Name Type Attributes Description
node HTMLElement
textId string <repeatable>
Overrides:
Source:

addCss(…classNames) → {Help4.control2.Control}

add CSS classnames to this control
Parameters:
Name Type Attributes Description
classNames string <repeatable>
 class names to be added to this control's DOM
Overrides:
Source:
Returns:
Type
Help4.control2.Control

addListenerSync(eventType, listener) → {Help4.jscore.Base}

add an event listener
Parameters:
Name Type Description
eventType string | Array.<string> event type to be observed
listener Help4.EmbeddedEvent.Listener the callback function
Overrides:
Source:
Returns:
Type
Help4.jscore.Base

align(connectionPointsopt, paramsopt) → (nullable) {Help4.control2.bubble.Alignment}

Parameters:
Name Type Attributes Description
connectionPoints Help4.control2.ConnectionPoints <optional>
params Help4.control2.bubble.AlignParams <optional>
Overrides:
Source:
Returns:
Type
Help4.control2.bubble.Alignment

focusListItem(direction)

focus handling - up/down/left/right arrow keys
Parameters:
Name Type Description
direction string
Source:

getArea() → {Help4.control2.AreaXYWH}

get position and size of this control
Overrides:
Source:
Returns:
- area of this control within DOM
Type
Help4.control2.AreaXYWH

getConnectionPoints(paramsopt) → {Help4.control2.ConnectionPoints}

get possible connection points for this control
Parameters:
Name Type Attributes Description
params Object <optional>
 optional parameters to be used by derived classes
Overrides:
Source:
Returns:
- points top,left,bottom,right and middle of this control
Type
Help4.control2.ConnectionPoints

getContentInstance() → {Help4.control2.bubble.content.BubbleContent}

Overrides:
Source:
Returns:
Type
Help4.control2.bubble.content.BubbleContent

getControlTexts() → {Object|null}

get all texts within my DOM; they can then be used for e.g. automatic machine learning translation (MLT)
Overrides:
Source:
Throws:
Error
Returns:
Type
Object | null

getDocument() → {Document}

deliver the document that hosts this control
Overrides:
Source:
Returns:
Type
Document

getDom(idopt) → {HTMLElement}

deliver the DOM elements that represents this control or some element inside
Parameters:
Name Type Attributes Description
id string <optional>
 a possible sub-dom-id
Overrides:
Source:
Returns:
Type
HTMLElement

getFooterInstance() → {Help4.control2.bubble.footer.BubbleFooter}

Overrides:
Source:
Returns:
Type
Help4.control2.bubble.footer.BubbleFooter

getHeaderInstance() → {Help4.control2.bubble.header.BubbleHeader}

Overrides:
Source:
Returns:
Type
Help4.control2.bubble.header.BubbleHeader

getHostedControls(onlyVisibleopt) → {Array.<Help4.control2.Control>}

Parameters:
Name Type Attributes Default Description
onlyVisible boolean <optional>
 false deliver only currently visible controls
Overrides:
Source:
Returns:
Type
Array.<Help4.control2.Control>

getMetadata(…keys) → {*}

get information from the metadata store
Parameters:
Name Type Attributes Description
keys string <repeatable>
 keys to retrieve the stored meta information
Overrides:
Source:
Returns:
Type
*

getMetadataKeys() → {Array.<string>}

get all currently stored metadata keys
Overrides:
Source:
Returns:
- all currently stored keys
Type
Array.<string>

getOrder() → (nullable) {string}

Overrides:
Source:
Returns:
Type
string

getOwnerDom() → {HTMLElement}

deliver the DOM that contains this control
Overrides:
Source:
Returns:
Type
HTMLElement

getPosition() → {Help4.control2.PositionXY}

get position of this control
Overrides:
Source:
Returns:
- position of this control within DOM
Type
Help4.control2.PositionXY

getSize() → {Help4.control2.SizeWH}

get size of this control
Overrides:
Source:
Returns:
- size of this control's bounding client rect
Type
Help4.control2.SizeWH

getTexts(onlyVisibleopt) → {Object|null}

get the texts within my control and within all controls that are within my control
Parameters:
Name Type Attributes Default Description
onlyVisible boolean <optional>
 false
Overrides:
Source:
Returns:
Type
Object | null

handleESC() → {boolean}

Overrides:
Source:
Returns:
Type
boolean

hasCss(…classNames) → {boolean}

tests some classnames on this control
Parameters:
Name Type Attributes Description
classNames string <repeatable>
 class names to be tested on this control's DOM
Overrides:
Source:
Returns:
Type
boolean

isDestroyed() → {boolean}

whether instance is destroyed
Overrides:
Source:
Returns:
Type
boolean

isMouseOver() → {boolean}

calculate whether the mouse is on top of my DOM
Overrides:
Source:
Returns:
- whether mouse is over my DOM
Type
boolean

onEvent(event)

handle incoming events
Parameters:
Name Type Description
event Object the received event
Overrides:
Source:

removeCss(…classNames) → {Help4.control2.Control}

remove CSS classnames from this control
Parameters:
Name Type Attributes Description
classNames string <repeatable>
 class names to be removed from this control's DOM
Overrides:
Source:
Returns:
Type
Help4.control2.Control

resetAlignmentCache()

Overrides:
Source:

resumeDragDrop() → {Help4.control2.Control}

resume drag & drop operation
Overrides:
Source:
Returns:
Type
Help4.control2.Control

setAttribute(name, value) → {Help4.control2.Control}

adds an attribute to the DOM
Parameters:
Name Type Description
name string
value *
Overrides:
Source:
Returns:
Type
Help4.control2.Control

setChild(child) → {Help4.control2.bubble.Bubble}

Parameters:
Name Type Description
child Help4.control2.bubble.Bubble
Overrides:
Source:
Returns:
Type
Help4.control2.bubble.Bubble

setControlTexts(textMap) → {Help4.control2.Control}

exchange all texts of my control; e.g. after successful MLT
Parameters:
Name Type Description
textMap Object
Overrides:
Source:
Throws:
Error
Returns:
Type
Help4.control2.Control

setDom(dom)

Parameters:
Name Type Description
dom HTMLElement
Overrides:
Source:

setMetadata(key, value) → {Help4.control2.Control}

allows to store any external key-value information within this control
Parameters:
Name Type Description
key string | Object the key
value * any value to be stored
Overrides:
Source:
Returns:
Type
Help4.control2.Control

setPosition(left, top)

Parameters:
Name Type Description
left number
top number
Source:

setStyle(styles) → {Help4.control2.Control}

add styles to this control
Parameters:
Name Type Description
styles Object styles to be added to this control's DOM
Overrides:
Source:
Returns:
Type
Help4.control2.Control

setTexts(textMap) → {Help4.control2.Control}

set the texts within my control and within all controls that are within my control
Parameters:
Name Type Description
textMap Object
Overrides:
Source:
Returns:
Type
Help4.control2.Control

suspendDragDrop() → {Help4.control2.Control}

suspend drag & drop operation
Overrides:
Source:
Returns:
Type
Help4.control2.Control

Type Definitions

Params

Type:
Properties:
Name Type Attributes Default Description
logoSrc string <optional>
<nullable>
 null URL to possible logo
showBackButton boolean <optional>
 false whether to show back button
showDockButton boolean <optional>
 true whether to show dock button
showMinimizeButton boolean <optional>
 true whether to show minimize button
showCloseButton boolean <optional>
 true whether to show close button
docked boolean <optional>
 false whether panel is docked
minimized boolean <optional>
 false whether panel is minimized
showTranslationButton boolean <optional>
 false whether to show the translation button
translation boolean <optional>
 false whether translation is enabled
animateTranslationButton boolean <optional>
 false whether to animate the translation button
caption string <optional>
<nullable>
 null caption text
showCaption boolean <optional>
 true caption text
showSearch boolean <optional>
 true whether to show search
showTiles boolean <optional>
 true whether to show the widget tiles
showContentArea boolean <optional>
 false whether to show the content area
brandingLogoSrc string <optional>
<nullable>
 null image source URL to possible branding logo
brandingLogoUrl string <optional>
<nullable>
 null navigation link to possible branding logo
showEditButton boolean <optional>
 false whether to show the edit button
showPublishViewButton boolean <optional>
 false whether to show the publish view button
showWmButton boolean <optional>
 false whether to show the wm button
publishView boolean <optional>
 false whether publish view is enabled
publishedState string <optional>
<nullable>
 null published state of the widget content
Source: