add 'modebarButtonsToRemove' config argument:

- adds ability to remove specific modebar buttons by listing
  their names upon plot configuration
- throw error if 'modebarButtonsToRemove' isn't an Array
- add filter step to choose button routine, removing buttons
  that are in 'modebarButtonsToRemove' list.

Author: etpinard

src/components/modebar/manage.js

@@ -33,13 +33,20 @@ module.exports = function manageModebar(gd) {
         return;
     }
 
-    var buttons = chooseButtons(fullLayout, context.modebarButtons);
+    if(!Array.isArray(context.modebarButtonsToRemove)) {
+        throw new Error([
+            '*modebarButtonsToRemove* configuration options',
+            'must be an array.'
+        ].join(' '));
+    }
+
+    var buttons = chooseButtons(fullLayout, context.modebarButtonsToRemove);
 
     if(modebar) modebar.update(gd, buttons);
     else fullLayout._modebar = createModebar(gd, buttons);
 };
 
-function chooseButtons(fullLayout) {
+function chooseButtons(fullLayout, buttonsToRemove) {
     var buttons = findButtons('all');
 
     if(fullLayout._hasGL3D) buttons = buttons.concat(findButtons('gl3d'));
@@ -58,6 +65,7 @@ function chooseButtons(fullLayout) {
 
     if(fullLayout._hasPie) buttons = buttons.concat(findButtons('pie'));
 
+    buttons = filterButtons(buttons, buttonsToRemove);
     buttons = groupButtons(buttons);
 
     return buttons;
@@ -89,6 +97,21 @@ function areAllAxesFixed(fullLayout) {
     return allFixed;
 }
 
+// Remove buttons according to modebarButtonsToRemove plot config options
+function filterButtons(buttons, buttonsToRemove) {
+    var out = [];
+
+    for(var i = 0; i < buttons.length; i++) {
+        var button = buttons[i];
+
+        if(buttonsToRemove.indexOf(button) !== -1) continue;
+
+        out.push(button);
+    }
+
+    return out;
+}
+
 function groupButtons(buttons) {
     var hashObj = {};
     var i;

src/plot_api/plot_config.js

@@ -58,6 +58,9 @@ module.exports = {
     // display the modebar (true, false, or 'hover')
     displayModeBar: 'hover',
 
+    // remove modebar button by name
+    modebarButtonsToRemove: [],
+
     // add the plotly logo on the end of the modebar
     displaylogo: true,