New excludeSearch plug-in

features/excludeSearch/dataTables.excludeSearch.js

@@ -0,0 +1,70 @@
+/**
+ * @summary     ExcludeSearch
+ * @description Add an input box that will remove matching items from the table
+ * @version     1.0.0
+ * @file        dataTables.excludeSearch.js
+ * @author      Ulises Gomez / Gravity Lending (https://www.linkedin.com/in/ulises-gomez/)
+ * @copyright   Copyright 2023 Ulises Gomez
+ *
+ * License      MIT - http://datatables.net/license/mit
+ *
+ * This feature adds a search input box to DataTables that will remove any rows that
+ * match the user's input from the display. Think of it as the inverse of the default
+ * search.
+ * 
+ * An [example is available here](http://live.datatables.net/zohoyoqa/1/edit).
+ *
+ * @example
+ *    $('#myTable').DataTable({
+ *        excludeSearch: true
+ *    });
+ */
+
+ (function(window, document, $) {
+	
+$.fn.dataTable.Api.register('exclude_search()', function (searchTerm) {
+	this.iterator('table', function (context) {
+		context.exclude_search = searchTerm;
+	});
+	return this;
+});
+
+$.fn.dataTable.ext.search.push(function (context, search_data) {
+	if (
+		context.exclude_search === '' ||
+		context.exclude_search === undefined ||
+		context.exclude_search === null
+	) {
+		// No search term - all results shown
+		return true;
+	}
+	let show_row = true;
+	search_data.forEach((val) => {
+		if (val.toUpperCase().includes(context.exclude_search.toUpperCase())) {
+			show_row = false;
+		}
+	});
+	return show_row;
+});
+$.fn.dataTable.ExcludeSearch = function (context) {
+	let table = new $.fn.dataTable.Api(context);
+	// class mx-3 is from bootstrap v4
+	let input_container = $(
+		'<div class="mx-3 dataTables_filter"><label>Exclude: </label><input type="text" /></div>'
+	);
+	input_container.find('input').on('input', function () {
+		table.exclude_search($(this).val()).draw();
+	});
+	this.node = function () {
+		return input_container;
+	};
+};
+$.fn.DataTable.ExcludeSearch = $.fn.dataTable.ExcludeSearch;
+$.fn.dataTable.ext.feature.push({
+	fnInit: function (settings) {
+		return new $.fn.dataTable.ExcludeSearch(settings).node();
+	},
+	cFeature: 'X',
+});
+
+})(window, document, jQuery);