etherpad-lite/doc/api/toolbar.md

Toolbar controller

src/node/utils/toolbar.js

button(opts)

• {Object} opts
  • command - this command fill be fired on the editbar on click
  • localizationId - will be set as data-l10-id
  • class - here you can add additional classes to the button

Returns: {Button}

Example:

var orderedlist = toolbar.button({
  command: "insertorderedlist",
  localizationId: "pad.toolbar.ol.title",
  class: "buttonicon buttonicon-insertorderedlist"
})

You can also create buttons with text:

var myButton = toolbar.button({
  command: "myButton",
  localizationId: "myPlugin.toolbar.myButton",
  class: "buttontext"
})

selectButton(opts)

• {Object} opts
  • id - id of the menu item
  • selectId - id of the select element
  • command - this command fill be fired on the editbar on change

Returns: {SelectButton}

SelectButton.addOption(value, text, attributes)

• {String} value - The value of this option
• {String} text - the label text used for this option
• {Object} attributes - any additional html attributes go here (e.g. data-l10n-id)

registerButton(name, item)

• {String} name - used to reference the item in the toolbar config in settings.json
• {Button|SelectButton} item - the button to add