Documentation

Toolbar

is #

Returns: Boolean

Check if the toolbar is running. For example, if the option toolbar is false, therefore API toolbar.is also returns false. The toolbar is not running in this case.

var is = this.toolbar.is();

isAir #

Returns: Boolean

Check if the toolbar is running as Air Toolbar.

var air = this.toolbar.isAir();

isFixed #

Returns: Boolean

Check if the toolbar is in fixed position when a user scroll the document.

var fixed = this.toolbar.isFixed();

isContextBar #

Returns: Boolean

Check if the context bar is opened.

var bar = this.toolbar.isContextBar();

getElement #

Returns: Object

Return the Dom object of the toolbar element.

var $toolbar = this.toolbar.getElement();

getWrapper #

Returns: Object

Return the Dom object of the toolbar wrapper element.

var $wrapper = this.toolbar.getWrapper();

getDropdown #

Returns: Object Boolean

Return the object of the current opened dropdown or returns false if no dropdowns are opened.

var dropdown = this.toolbar.getDropdown();

getButton #

Arguments
name String

Returns: Object Boolean

Return the button object by specified name, and false if the button doesn't exist on the toolbar.

var button = this.toolbar.getButton('bold');

getButtons #

Returns: Array

Return the array of all button objects on the toolbar.

var buttons = this.toolbar.getButtons();

getButtonsKeys #

Returns: Array

Return the array of all button names on the toolbar.

var keys = this.toolbar.getButtonsKeys();

addButton #

Arguments
name String
data Object

Returns: Object

Add a button at the end of the toolbar with name and the following data object:

  • title String
    • the alternative text of button HTML element
  • api String
    • the name of API to module or plugin method, for example: module.block.format.
  • message String
    • the name of message which is broadcasting to app when the button is clicked, for example: mybuttonclicked.
  • tooltip String
    • the text for button tooltip when a user moves the cursor to the button. By default the title is shown on the tooltip text.
  • args Mixed
    • arguments which will be passed with api method or message.
  • observe String
    • module or plugin name that will watch the button.

The method returns the object of the created button.

var data = {
    title: 'My button',
    api: 'plugin.myplugin.toggle'
};
var button = this.toolbar.addButton('mybutton', data);

With argument:

var data = {
    title: 'My button',
    api: 'plugin.myplugin.toggle',
    args: 'argument'
};
var button = this.toolbar.addButton('mybutton', data);

With arguments:

var data = {
    title: 'My button',
    api: 'plugin.myplugin.toggle',
    args: {
        key1: 'value1',
        key2: 'value2'
    }
};
var button = this.toolbar.addButton('mybutton', data);

addButtonFirst #

Arguments
name String
data Object

Returns: Object

Add a button at the start of the toolbar.

var data = {
    title: 'My button',
    api: 'plugin.myplugin.toggle'
};
var button = this.toolbar.addButtonFirst('mybutton', data);

addButtonAfter #

Arguments
after String
name String
data Object

Returns: Object

Add a button after the specified button on the toolbar.

var data = {
    title: 'My button',
    api: 'plugin.myplugin.toggle'
};
var button = this.toolbar.addButtonAfter('bold', 'mybutton', data);

In this example, the new button will be added after the bold button. If the specified button doesn't exist the new button will be added at the end of the toolbar.

addButtonBefore #

Arguments
before String
name String
data Object

Returns: Object

Add a button before the specified button on the toolbar.

var data = {
    title: 'My button',
    api: 'plugin.myplugin.toggle'
};
var button = this.toolbar.addButtonBefore('bold', 'mybutton', data);

In this example, the new button will be added before the bold button. If the specified button doesn't exist the new button will be added at the end of the toolbar.

setButtonsInactive #

Set all button on the toolbar is not active.

this.toolbar.setButtonsInactive();

setButtonsActive #

Set all button on the toolbar is active.

this.toolbar.setButtonsActive();

disableButtons #

Disable all button on the toolbar.

this.toolbar.disableButtons();

enableButtons #

Enable all button on the toolbar.

this.toolbar.enableButtons();