feat: Switch/Toggle widget

components/Toggle.js

@@ -0,0 +1,28 @@
+var React = require('react');
+
+class Toggle extends React.Component {
+  render() {
+    var toggleFilter = this.props.toggleFilter;
+    var label = this.props.label;
+    var isRefined = this.props.isRefined;
+
+    return (
+      <label>
+        <input
+          checked={isRefined}
+          onChange={toggleFilter}
+          type="checkbox"
+        />
+        {label}
+      </label>
+    );
+  }
+}
+
+Toggle.propTypes = {
+  toggleFilter: React.PropTypes.func,
+  label: React.PropTypes.string,
+  isRefined: React.PropTypes.bool
+};
+
+module.exports = Toggle;

index.js

@@ -6,6 +6,7 @@ module.exports = {
     multipleChoiceList: require('./widgets/multiple-choice-list'),
     pagination: require('./widgets/pagination'),
     searchBox: require('./widgets/search-box'),
-    stats: require('./widgets/stats')
+    stats: require('./widgets/stats'),
+    toggle: require('./widgets/toggle')
   }
 };

widgets/toggle.js

@@ -0,0 +1,43 @@
+var React = require('react');
+
+var utils = require('../lib/widget-utils.js');
+
+function toggle({
+    container = null,
+    facetName = null,
+    label = null
+  }) {
+  var Toggle = require('../components/Toggle');
+
+  var containerNode = utils.getContainerNode(container);
+  var usage = 'Usage: toggle({container, facetName, label})';
+
+  if (container === null || facetName === null || label === null) {
+    throw new Error(usage);
+  }
+
+  return {
+    getConfiguration: () => ({
+      facets: [facetName]
+    }),
+    render: function(results, state, helper) {
+      var isRefined = helper.hasRefinements(facetName);
+
+      function toggleFilter() {
+        var methodToCall = isRefined ? 'removeFacetRefinement' : 'addFacetRefinement';
+        helper[methodToCall](facetName, true).search();
+      }
+
+      React.render(
+        <Toggle
+          isRefined={isRefined}
+          toggleFilter={toggleFilter}
+          label={label}
+        />,
+        containerNode
+      );
+    }
+  };
+}
+
+module.exports = toggle;