Allow the skip api method for sliders and udpatemenus

Author: rreusser

src/components/sliders/attributes.js

@@ -20,7 +20,7 @@ var stepsAttrs = {
 
     method: {
         valType: 'enumerated',
-        values: ['restyle', 'relayout', 'animate', 'update'],
+        values: ['restyle', 'relayout', 'animate', 'update', 'skip'],
         dflt: 'restyle',
         role: 'info',
         description: [

src/components/sliders/defaults.js

@@ -95,11 +95,12 @@ function stepsDefaults(sliderIn, sliderOut) {
         valueIn = valuesIn[i];
         valueOut = {};
 
-        if(!Lib.isPlainObject(valueIn) || !Array.isArray(valueIn.args)) {
+        coerce('method');
+
+        if(!Lib.isPlainObject(valueIn) || (valueOut.method !== 'skip' && !Array.isArray(valueIn.args))) {
             continue;
         }
 
-        coerce('method');
         coerce('args');
         coerce('label', 'step-' + i);
         coerce('value', valueOut.label);

src/components/updatemenus/attributes.js

@@ -18,7 +18,7 @@ var buttonsAttrs = {
 
     method: {
         valType: 'enumerated',
-        values: ['restyle', 'relayout', 'animate', 'update'],
+        values: ['restyle', 'relayout', 'animate', 'update', 'skip'],
         dflt: 'restyle',
         role: 'info',
         description: [

src/components/updatemenus/defaults.js

@@ -76,11 +76,12 @@ function buttonsDefaults(menuIn, menuOut) {
         buttonIn = buttonsIn[i];
         buttonOut = {};
 
-        if(!Lib.isPlainObject(buttonIn) || !Array.isArray(buttonIn.args)) {
+        coerce('method');
+
+        if(!Lib.isPlainObject(buttonIn) || (buttonOut.method !== 'skip' && !Array.isArray(buttonIn.args))) {
             continue;
         }
 
-        coerce('method');
         coerce('args');
         coerce('label');
 

src/plots/command.js

@@ -262,6 +262,8 @@ function bindingValueHasChanged(gd, binding, cache) {
  *      A list of arguments passed to the API command
  */
 exports.executeAPICommand = function(gd, method, args) {
+    if(method === 'skip') return Promise.resolve();
+
     var apiMethod = Plotly[method];
 
     var allArgs = [gd];

test/jasmine/tests/command_test.js

@@ -58,6 +58,13 @@ describe('Plots.executeAPICommand', function() {
         });
 
     });
+
+    describe('with the skip command', function() {
+        it('resolves immediately', function(done) {
+            Plots.executeAPICommand(gd, 'skip')
+                .catch(fail).then(done);
+        });
+    });
 });
 
 describe('Plots.hasSimpleAPICommandBindings', function() {
@@ -93,6 +100,14 @@ describe('Plots.hasSimpleAPICommandBindings', function() {
         });
     });
 
+    it('the skip method returns false', function() {
+        var isSimple = Plots.hasSimpleAPICommandBindings(gd, [{
+            method: 'skip',
+        }]);
+
+        expect(isSimple).toEqual(false);
+    });
+
     it('return false when properties are not the same', function() {
         var isSimple = Plots.hasSimpleAPICommandBindings(gd, [{
             method: 'restyle',
@@ -187,6 +202,11 @@ describe('Plots.computeAPICommandBindings', function() {
         destroyGraphDiv(gd);
     });
 
+    it('the skip method returns no bindings', function() {
+        var result = Plots.computeAPICommandBindings(gd, 'skip', ['marker.size', 7]);
+        expect(result).toEqual([]);
+    });
+
     describe('restyle', function() {
         describe('with invalid notation', function() {
             it('with a scalar value', function() {

test/jasmine/tests/sliders_test.js

@@ -158,6 +158,32 @@ describe('sliders defaults', function() {
         });
     });
 
+    it('allow the `skip` method', function() {
+        layoutIn.sliders = [{
+            steps: [{
+                method: 'skip',
+            }, {
+                method: 'skip',
+                args: ['title', 'Hello World']
+            }]
+        }];
+
+        supply(layoutIn, layoutOut);
+
+        expect(layoutOut.sliders[0].steps.length).toEqual(2);
+        expect(layoutOut.sliders[0].steps[0]).toEqual({
+            method: 'skip',
+            label: 'step-0',
+            value: 'step-0',
+        }, {
+            method: 'skip',
+            args: ['title', 'Hello World'],
+            label: 'step-1',
+            value: 'step-1',
+        });
+    });
+
+
     it('should keep ref to input update menu container', function() {
         layoutIn.sliders = [{
             steps: [{

test/jasmine/tests/updatemenus_test.js

@@ -140,6 +140,31 @@ describe('update menus defaults', function() {
         });
     });
 
+    it('allow the `skip` method', function() {
+        layoutIn.updatemenus = [{
+            buttons: [{
+                method: 'skip',
+            }, {
+                method: 'skip',
+                args: ['title', 'Hello World']
+            }]
+        }];
+
+        supply(layoutIn, layoutOut);
+
+        expect(layoutOut.updatemenus[0].buttons.length).toEqual(2);
+        expect(layoutOut.updatemenus[0].buttons[0]).toEqual({
+            method: 'skip',
+            label: '',
+            _index: 0
+        }, {
+            method: 'skip',
+            args: ['title', 'Hello World'],
+            label: '',
+            _index: 1
+        });
+    });
+
     it('should keep ref to input update menu container', function() {
         layoutIn.updatemenus = [{
             buttons: [{