goog.ui.editor.ToolbarController
Classgoog.ui.editor.ToolbarController
> goog.events.EventTarget
> goog.Disposable
goog.ui.editor.ToolbarController(field, toolbar)
A class for managing the editor toolbar. Acts as a bridge between a {@link goog.editor.Field} and a {@link goog.ui.Toolbar}. The {@code toolbar} argument must be an instance of {@link goog.ui.Toolbar} or a subclass. This class doesn't care how the toolbar was created. As long as one or more controls hosted in the toolbar have IDs that match built-in {@link goog.editor.Command}s, they will function as expected. It is the caller's responsibility to ensure that the toolbar is already rendered or that it decorates an existing element.
field
{!goog.editor.Field
}
toolbar
{!goog.ui.Toolbar
}
.addEventListener(type, handler, opt_capture, opt_handlerScope)
Inherited from goog.events.EventTarget
.
Adds an event listener to the event target. The same handler can only be added once per the type. Even if you add the same handler multiple times using the same type then it will only be called once when the event is dispatched. Supported for legacy but use goog.events.listen(src, type, handler) instead.
type
{string
}
handler
{Function
|Object
}
opt_capture
{boolean
=}
opt_handlerScope
{Object
=}
.addOnDisposeCallback(callback, opt_scope)
Inherited from goog.Disposable
.
Invokes a callback function when this object is disposed. Callbacks are invoked in the order in which they were added.
callback
{!Function
}
opt_scope
{Object
=}
.blur()
Programmatically blurs the editor toolbar, un-highlighting the currently highlighted item, and closing the currently open menu (if any).
.creationStack
{string
}Inherited from goog.Disposable
.
If monitoring the goog.Disposable instances is enabled, stores the creation stack trace of the Disposable instance.
.dispatchEvent(e)
Inherited from goog.events.EventTarget
.
Dispatches an event (or event like object) and calls all listeners listening for events of this type. The type of the event is decided by the type property on the event object. If any of the listeners returns false OR calls preventDefault then this function will return false. If one of the capture listeners calls stopPropagation, then the bubble listeners won't fire.
e
{string
|Object
|goog.events.Event
}
boolean
}
.dispose()
Inherited from goog.Disposable
.
Disposes of the object. If the object hasn't already been disposed of, calls {@link #disposeInternal}. Classes that extend {@code goog.Disposable} should override {@link #disposeInternal} in order to delete references to COM objects, DOM nodes, and other disposable objects. Reentrant.
void
}
.disposeInternal()
[protected]Unattach listeners from this object. Classes that extend EventTarget may need to override this method in order to remove references to DOM Elements and additional listeners, it should be something like this:
MyClass.prototype.disposeInternal = function() { MyClass.superClass_.disposeInternal.call(this); // Dispose logic for MyClass };
.getCommand(id)
[protected]Returns the {@link goog.editor.Command} constant that corresponds to the given Closure component ID. Subclasses may override this method if they want to use a custom mapping scheme from controls to commands.
id
{string
}
string
}
.getComponentId(command)
[protected]Returns the Closure component ID of the control that corresponds to the given {@link goog.editor.Command} constant. Subclasses may override this method if they want to use a custom mapping scheme from commands to controls.
command
{string
}
string
}
.getDisposed
[deprecated]Deprecated. Use {@link #isDisposed} instead.
Inherited from goog.Disposable
.
boolean
}
.getField()
[protected]Returns the field instance managed by the toolbar. Useful for classes that extend {@code goog.ui.editor.ToolbarController}.
goog.editor.Field
}
.getHandler()
[protected]Returns the event handler object for the editor toolbar. Useful for classes that extend {@code goog.ui.editor.ToolbarController}.
goog.events.EventHandler
}
.getParentEventTarget()
Inherited from goog.events.EventTarget
.
Returns the parent of this event target to use for bubbling.
goog.events.EventTarget
}
.getToolbar()
Returns the toolbar UI component that manages the editor. Useful for classes that extend {@code goog.ui.editor.ToolbarController}.
goog.ui.Toolbar
}
.handleAction(e)
[protected]Handles {@code ACTION} events dispatched by toolbar buttons in response to user actions by executing the corresponding field command.
e
{goog.events.Event
}
.isDisposed()
Inherited from goog.Disposable
.
boolean
}
.isEnabled()
boolean
}
.isVisible()
boolean
}
.registerDisposable(disposable)
Inherited from goog.Disposable
.
Associates a disposable object with this object so that they will be disposed together.
disposable
{goog.disposable.IDisposable
}
.removeEventListener(type, handler, opt_capture, opt_handlerScope)
Inherited from goog.events.EventTarget
.
Removes an event listener from the event target. The handler must be the same object as the one added. If the handler has not been added then nothing is done.
type
{string
}
handler
{Function
|Object
}
opt_capture
{boolean
=}
opt_handlerScope
{Object
=}
.setEnabled(enabled)
Enables or disables the toolbar.
enabled
{boolean
}
.setParentEventTarget(parent)
Inherited from goog.events.EventTarget
.
Sets the parent of this event target to use for bubbling.
parent
{goog.events.EventTarget
?}
.setVisible(visible)
Shows or hides the toolbar.
visible
{boolean
}
.updateToolbar(e)
[protected]Updates the toolbar in response to editor events. Specifically, updates button states based on {@code COMMAND_VALUE_CHANGE} events, reflecting the effective formatting of the selection.
e
{goog.events.Event
}
.updateToolbarFromState(state)
Updates the toolbar to reflect a given state.
state
{Object
}