added new jQuery plugin called attrFilter along with unit tests for it

1 files changed, 20 insertions, 1 deletions

diff --git a/src/js/fiveui/injected/jquery-plugins.js b/src/js/fiveui/injected/jquery-plugins.js
index 5a32031..1589972 100644
--- a/src/js/fiveui/injected/jquery-plugins.js
+++ b/src/js/fiveui/injected/jquery-plugins.js
@@ -43,7 +43,8 @@ fiveui.jquery.hasText = function (text) {
 };
 
 /**
- * Filter for elements which lack of the given attribute.
+ * Filter for elements which lack of the given attribute. (see also
+ * fiveui.jquery.attrFilter)
  *
  * Example:
  *
@@ -133,6 +134,24 @@ fiveui.jquery.cssIsNot = function (prop, set, fn) {
 }
 
 /**
+ * General attribute filter
+ *
+ * @description This plugin filters for elements whose attribute `a` pass
+ * the predicate `fn`, which should take a string and return true or false.
+ * Elements that don't have the attribute are automatically filtered out.
+ *
+ * @param {String} a element attribute name
+ * @param {Function} fn a predicate to run on the element attribute
+ * @returns {Object} jQuery object
+ */
+fiveui.jquery.attrFilter = function (a, fn) {
+  return this.filter(function () {
+    var x = $(this).attr(a);
+    return x != undefined && fn(x);
+  });
+}
+
+/**
  * Filter out elements that do not contain the attribute
  * href=`href`.
  *