Added clearOptions() method (selectize#22).

brianreavis · brianreavis · commit e919b246298b · 2013-06-08T12:26:17.000-07:00
diff --git a/examples/api.html b/examples/api.html
@@ -28,6 +28,7 @@ <h2>API</h2>
 				</div>
 				<div class="buttons">
 					<input type="button" value="clear()" id="button-clear">
+					<input type="button" value="clearOptions()" id="button-clearoptions">
 					<input type="button" value="addOption()" id="button-addoption">
 					<input type="button" value="addItem()" id="button-additem">
 					<input type="button" value="setValue()" id="button-setvalue">
@@ -54,6 +55,10 @@ <h2>API</h2>
 					control.clear();
 				});
 
+				$('#button-clearoptions').on('click', function() {
+					control.clearOptions();
+				});
+
 				$('#button-addoption').on('click', function() {
 					control.addOption(4, {
 						id: 4,
diff --git a/src/selectize.js b/src/selectize.js
@@ -903,6 +903,11 @@ Selectize.prototype.refreshOptions = function(triggerDropdown) {
  * the options list dropdown (use `refreshOptions`
  * for that).
  *
+ * Usage:
+ *
+ *   this.addOption(value, data)
+ *   this.addOption(data)
+ *
  * @param {string} value
  * @param {object} data
  */
@@ -949,7 +954,7 @@ Selectize.prototype.updateOption = function(value, data) {
 };
 
 /**
- * Removes an option.
+ * Removes a single option.
  *
  * @param {string} value
  */
@@ -962,6 +967,17 @@ Selectize.prototype.removeOption = function(value) {
 	this.removeItem(value);
 };
 
+/**
+ * Clears all options.
+ */
+Selectize.prototype.clearOptions = function() {
+	this.userOptions = {};
+	this.options = {};
+	this.lastQuery = null;
+	this.trigger('onOptionClear');
+	this.clear();
+};
+
 /**
  * Returns the jQuery element of the option
  * matching the given value.
@@ -1519,6 +1535,7 @@ Selectize.defaults = {
 	onClear         : null, // function() { ... }
 	onOptionAdd     : null, // function(value, data) { ... }
 	onOptionRemove  : null, // function(value) { ... }
+	onOptionClear   : null, // function() { ... }
 	onDropdownOpen  : null, // function($dropdown) { ... }
 	onDropdownClose : null, // function($dropdown) { ... }
 	onType          : null, // function(str) { ... }
