Expand all

ve.ui.Toolbar

Extends

Constructor

new ve.ui.Toolbar([config]) #

UserInterface surface toolbar.

Parameters:

Name Type Attributes Description
config Object optional

Configuration options
Source:
UserInterface surface toolbar.

Methods

destroy() #

Destroys toolbar, removing event handlers and DOM elements.

Call this whenever you are done using a toolbar.

Source:
Destroys toolbar, removing event handlers and DOM elements.

detach() #

Detach toolbar from surface and all event listeners

Source:
Detach toolbar from surface and all event listeners

getCommands() → {Array.<string>} #

Get a list of commands available to this toolbar's surface

Source:

Returns:

Command names

Type
Array.<string>
Get a list of commands available to this toolbar's surface

getSurface() → {ve.ui.Surface|null} #

Gets the surface which the toolbar controls.

Returns null if the toolbar hasn't been set up yet.

Source:

Returns:

Surface being controlled

Type
ve.ui.Surface | null
Gets the surface which the toolbar controls.

getToolAccelerator() #

Source:

getTriggers(name) → {Array.<ve.ui.Trigger>|undefined} #

Get triggers for a specified name.

Parameters:

Name Type Description
name string

Trigger name
Source:

Returns:

Triggers

Type
Array.<ve.ui.Trigger> | undefined
Get triggers for a specified name.

isToolAvailable() #

Source:

onContextChange() #

Handle context changes on the surface.

Source:

Fires:

Handle context changes on the surface.

onInspectorOrDialogOpeningOrClosing(win, openingOrClosing, data) #

Handle windows opening or closing in the dialogs' or inspectors' window manager.

Parameters:

Name Type Description
win OO.ui.Window
openingOrClosing jQuery.Promise
data Object
Source:
Handle windows opening or closing in the dialogs' or inspectors' window manager.

setNarrow() #

Source:

setup(groups, [surface]) #

Setup toolbar

Parameters:

Name Type Attributes Description
groups Object

List of tool group configurations
surface ve.ui.Surface optional

Surface to attach to
Source:

Fires:

Setup toolbar

updateToolState() #

Update the state of the tools

Source:

Fires:

Update the state of the tools

Events

resize() #

Source:

surfaceChange(oldSurface, newSurface) #

Parameters:

Name Type Description
oldSurface ve.ui.Surface | null

Old surface being controlled
newSurface ve.ui.Surface | null

New surface being controlled
Source:

updateState(fragment, direction, activeDialogs) #

Parameters:

Name Type Description
fragment ve.dm.SurfaceFragment | null

Surface fragment. Null if no surface is active.
direction Object | null

Context direction with 'inline' & 'block' properties if a surface exists. Null if no surface is active.
activeDialogs Array.<string>

List of names of currently open dialogs.
Source: