Class PanelAPI

constructor

• new PanelAPI(iApi): PanelAPI

• Creates an instance of APIScope.

  Parameters

  • iApi: InstanceAPI

  Returns PanelAPI

  Memberof

  APIScope

panelStore

opened

• get opened(): PanelInstance[]

• Returns an array of open PanelInstance objects.

  Returns PanelInstance[]

  Memberof

  PanelAPI

pinned

• get pinned(): undefined | PanelInstance

• Returns the currently pinned panel instance, if exists.

  Returns undefined | PanelInstance

  Memberof

  PanelAPI

visible

• get visible(): PanelInstance[]

• Returns an array of visible PanelInstance object. This is not every open panel, only the ones currently visible to the user.

  Returns PanelInstance[]

  Memberof

  PanelAPI

allRegistered

• allRegistered(): string[]

• Returns the panel ids of all currently registered panels

  Returns string[]

  Memberof

  PanelAPI

close

• close(value): undefined | PanelInstance

• Closes the panel specified.

  Parameters

  • value: string | PanelInstance

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

expand

• expand(value, expand?): undefined | PanelInstance

• Expands/collapses the expand state of the panel. Toggles whether the panel expands if no expand value is given.

  Parameters

  • value: string | PanelInstance
  • Optionalexpand: boolean

    Optional. Whether the panel should expand, toggles the value if not set

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

focus

• focus(panelOrId): undefined | PanelInstance

• Sets keyboard focus to the specified panel if it is currently visible.

  Parameters

  • panelOrId: string | PanelInstance

  Returns undefined | PanelInstance

get

• get(value): PanelInstance

• Finds and returns a panel with the id specified.

  Parameters

  • value: string | PanelInstance

  Returns PanelInstance

  Memberof

  PanelAPI

isRegistered

• isRegistered<T>(panelId): Promise<T extends string
      ? PanelInstance
      : PanelInstance[]>

• Provides a promise that resolves when the panel(s) have finished registration.

  Type Parameters

  • T extends string | string[]

  Parameters

  • panelId: T

    the panel ID(s) for which the promise is requested

  Returns Promise<T extends string
      ? PanelInstance
      : PanelInstance[]>

  Memberof

  PanelAPI

minimize

• minimize(value): undefined | PanelInstance

• Minimizes the panel specified, mechanically the same as closing however it does not emit the close event so that temporary appbar buttons stay.

  Parameters

  • value: string | PanelInstance

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

move

• move(value, direction): undefined | PanelInstance

• Moves the specifed visible panel to the left or right.

  Parameters

  • value: string | PanelInstance
  • direction: PanelDirection

    the direction of movement, either "left" or "right".

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

open

• open(value): undefined | PanelInstance

• Opens a registered panel in the panel stack.

  • rInstance.panel.open('panel-id') -- opens the 'panel-id' panel on the first screen in the set
  • rInstance.panel.open(<PanelInstance>) -- opens the provided PanelInstance object on the first screen in the set
  • rInstance.panel.open({ id: 'panel-id', screen: 'screen-id' }) -- opens the 'panel-id' panel on the 'screen-id' screen
  • rInstance.panel.open({ id: 'panel-id', screen: 'screen-id', props: {... } }) -- opens the 'panel-id' panel on the 'screen-id' screen passing supplied props to it

  Parameters

  • value: string | PanelInstance | PanelInstancePath

    a panel id, a PanelInstance object or an object of the form { id: <panel-id>, screen: <id>, props: <object> }.

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

pin

• pin(value, pin?): undefined | PanelInstance

• Pin/unpin/toggle (if no value provided) pin status of the provided panel. When pinning, automatically unpins any previous pinned panel if exists.

  Parameters

  • value: string | PanelInstance
  • Optionalpin: boolean

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

register

• register(value, options?): PanelInstance

• Registers a provided panel object and returns the resulting PanelInstance objects. When the panel is registered, all its screens are added to the Vue as components right away.

  Parameters

  • value: PanelConfigPair

    a PanelConfig/id pair in the form of { id: string, config: PanelConfig }
  • Optionaloptions: PanelRegistrationOptions

  Returns PanelInstance

  Memberof

  PanelAPI

• register(value, options?): PanelInstanceSet

• Registers a set of provided panel objects and returns the resulting PanelInstance object set. When the panel is registered, all its screens are added to the Vue as components right away.

  Parameters

  • value: PanelConfigSet

    a set of PanelConfig objects in the form of { [name: string]: PanelConfig } where keys assumed to be ids
  • Optionaloptions: PanelRegistrationOptions

    a set of options that will apply to all the panel in the set

  Returns PanelInstanceSet

  Memberof

  PanelAPI

registerHTML

• registerHTML(htmlPanel): PanelInstance

• Registers a new panel containing a screen of HTML content and returns the PanelInstance

  Parameters

  • htmlPanel: HTMLPanelInstance

    a HTMLPanelInstance object corresponding to the new html panel

  Returns PanelInstance

  Memberof

  PanelAPI

remove

• remove(value): void

• Removes a panel instance

  Parameters

  • value: string | PanelInstance

  Returns void

  Memberof

  PanelAPI

setStyle

• setStyle(value, style, replace?): undefined | PanelInstance

• Sets the styles of the specified panel by using a provided CSS styles object.

  Parameters

  • value: string | PanelInstance
  • style: object
  • Optionalreplace: boolean = false

    merge with existing styles if false; replace if true

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

show

• show(value, route): undefined | PanelInstance

• Sets route to the specified screen id and pass props to the panel screen components.

  Parameters

  • value: string | PanelInstance
  • route: PanelConfigRoute

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered and the specified screen exists, undefined otherwise.

  Memberof

  PanelAPI

toggle

• toggle(value?, toggle?): undefined | PanelInstance

• Toggle panel.

  Parameters

  • Optionalvalue: string | PanelInstance | PanelInstancePath
  • Optionaltoggle: boolean

    Optional param. True forces a panel open, false forces the panel to close.

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

toggleMinimize

• toggleMinimize(value?, toggle?): undefined | PanelInstance

• Toggle panel's minimized state

  Parameters

  • Optionalvalue: string | PanelInstance | PanelInstancePath
  • Optionaltoggle: boolean

    Optional param. True forces a panel open, false forces the panel to minimize.

  Returns undefined | PanelInstance

  the panel instance if the panel is currently registered, undefined otherwise.

  Memberof

  PanelAPI

updateHTML

• updateHTML(panel, html, screenId?): void

• Updates the content of a specific HTML-based screen of a panel, using HTML content

  Parameters

  • panel: string | PanelInstance

    The PanelInstance object, or its respective id, that corresponds to the panel whose content is to be updated.
  • html: HTMLScreen | {
        [key: string]: string;
    }

    keyed language object containing HTML content for each language, represented as an HTMLElement object or a string.
  • OptionalscreenId: string

    id of the screen to be updated. If not provided, it will update the first screen in the panel

  Returns void

  Memberof

  PanelAPI