Expand all

ve.ui.MobileContext

Extends

Constructor

new ve.ui.MobileContext(surface, [config]) #

UserInterface context that displays inspector full screen.

Parameters:

Name Type Attributes Description
surface ve.ui.Surface
config Object optional

Configuration options
Source:
UserInterface context that displays inspector full screen.

Properties

createInspectorWindowManager #

Create a inspector window manager.

Overrides:
Source:
Create a inspector window manager.

getRelatedSources #

Get related item sources.

Result is cached, and cleared when the model or selection changes.

Inherited from:
Source:
Get related item sources.

Methods

addPersistentSource(source) #

Add a persistent source that will stay visible until manually removed.

Parameters:

Name Type Description
source Object

Object containing name, model and config properties. See #getRelatedSources.
Inherited from:
Source:
Add a persistent source that will stay visible until manually removed.

afterContextChange() #

Handle debounced context change events.

Inherited from:
Source:
Handle debounced context change events.

destroy() → {ve.ui.Context}chainable #

Destroy the context, removing all DOM elements.

Inherited from:
Source:

Returns:

Type
ve.ui.Context
Destroy the context, removing all DOM elements.

getInspectors() → {ve.ui.WindowManager} #

Get inspector window set.

Inherited from:
Source:

Returns:

Type
ve.ui.WindowManager
Get inspector window set.

getRelatedSourcesFromModels(selectedModels) → {Array.<Object>} #

Get related for selected models

Parameters:

Name Type Description
selectedModels Array.<ve.dm.Model>

Models
Inherited from:
Source:

Returns:

See #getRelatedSources

Type
Array.<Object>
Get related for selected models

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

Get the surface the context is being used with.

Inherited from:
Source:

Returns:

Type
ve.ui.Surface
Get the surface the context is being used with.

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

Get an object describing the amount of padding the context adds to the surface.

For example the mobile context, which is fixed to the bottom of the viewport, will add bottom padding, whereas the floating desktop context will add none.

Overrides:
Source:

Returns:

Padding object, or null

Type
ve.ui.Surface.Padding | null
Get an object describing the amount of padding the context adds to the surface.

hide() #

Hide the context while it has valid items in the menu

This could be triggered by clicking the close button on mobile or by pressing escape.

Inherited from:
Source:

Hide the context while it has valid items in the menu

This could be triggered by clicking the close button on mobile or by pressing escape.

isInspectable() → {boolean} #

Check if current content is inspectable.

Overrides:
Source:

Returns:

Content is inspectable

Type
boolean
Check if current content is inspectable.

isMobile() → {boolean} #

Check if context is for mobile devices

Inherited from:
Source:

Returns:

Context is for mobile devices

Type
boolean
Check if context is for mobile devices

isVisible() → {boolean} #

Check if context is visible.

Overrides:
Source:

Returns:

Context is visible

Type
boolean
Check if context is visible.

onCloseButtonClick() #

Handle click events from the close button

Source:
Handle click events from the close button

onContextChange() #

Handle context change event.

While an inspector is opening or closing, all changes are ignored so as to prevent inspectors that change the selection from within their setup or teardown processes changing context state.

The response to selection changes is deferred to prevent teardown processes handlers that change the selection from causing this function to recurse. These responses are also debounced for efficiency, so that if there are three selection changes in the same tick, #afterContextChange only runs once.

Inherited from:
Source:
See:
Handle context change event.

onContextItemCommand() #

Handle command events from context items

Inherited from:
Source:
Handle command events from context items

onDocumentUpdate() #

Handle document update event.

Inherited from:
Source:
Handle document update event.

onInspectorOpening(win, opening, data) #

Handle an inspector opening event.

Parameters:

Name Type Description
win OO.ui.Window

Window that's being opened
opening jQuery.Promise

Promise resolved when window is opened; when the promise is resolved the first argument will be a promise which will be resolved when the window begins closing, the second argument will be the opening data
data Object

Window opening data
Overrides:
Source:
Handle an inspector opening event.

removePersistentSource(name) #

Remove a persistent source by name

Parameters:

Name Type Description
name string

Source name
Inherited from:
Source:
Remove a persistent source by name

setupMenuItems([previousItems]) → {ve.ui.Context}protectedchainable #

Setup menu items.

Parameters:

Name Type Attributes Description
previousItems Array.<ve.ui.ContextItem> optional

if a context is being refreshed, this will be the previously-open items for comparison
Overrides:
Source:

Returns:

Type
ve.ui.Context
Setup menu items.

teardownMenuItems() → {ve.ui.Context}protectedchainable #

Teardown menu items.

Inherited from:
Source:

Returns:

Type
ve.ui.Context
Teardown menu items.

toggle([show]) → {jQuery.Promise} #

Toggle the visibility of the context.

Parameters:

Name Type Attributes Description
show boolean optional

Show the context, omit to toggle
Overrides:
Source:

Returns:

Promise resolved when context is finished showing/hiding

Type
jQuery.Promise

Fires:

Toggle the visibility of the context.

toggleMenu([show]) → {ve.ui.Context}chainable #

Toggle the menu.

Parameters:

Name Type Attributes Description
show boolean optional

Show the menu, omit to toggle
Overrides:
Source:

Returns:

Type
ve.ui.Context
Toggle the menu.

updateDimensions() → {ve.ui.Context}chainable #

Update the size and position of the context.

Inherited from:
Source:

Returns:

Type
ve.ui.Context

Fires:

Update the size and position of the context.

Events

resize() #

Inherited from:
Source: