feat(dom): clulib.dom.matches + clulib.dom.closest

Author: b-strauss

lib/dom/dom.js

@@ -0,0 +1,45 @@
+goog.provide('clulib.dom');
+
+goog.require('goog.dom');
+
+/**
+ * Returns true if the [element] would be selected by the specified
+ * [selector] string, false otherwise.
+ *
+ * @param {Element} element
+ * @param {string} selector
+ * @returns {boolean}
+ */
+clulib.dom.matches = function (element, selector) {
+  /**
+   * @type {function(this:Element, string):boolean}
+   */
+  let matches = element['matches'] ||
+      element['matchesSelector'] ||
+      element['webkitMatchesSelector'] ||
+      element['mozMatchesSelector'] ||
+      element['msMatchesSelector'];
+
+  return matches.call(element, selector);
+};
+
+/**
+ * Returns the closest ancestor of the specified [element] (or the specified element itself)
+ * which matches the [selector]. Returns null, if there is no such ancestor.
+ *
+ * @param {Element} element
+ * @param {string} selector
+ * @returns {?Element}
+ */
+clulib.dom.closest = function (element, selector) {
+  if (element['closest'] != null) {
+    return /** @type {?Element} */ (element['closest'](selector));
+  } else {
+    return /** @type {?Element} */ (goog.dom.getAncestor(element, node => {
+      if (goog.dom.isElement(node))
+        return clulib.dom.matches(/** @type {Element} */ (node), selector);
+      else
+        return false;
+    }, true));
+  }
+};