From a76a4654ed559f42ca8f600240606ebcd94c90a1 Mon Sep 17 00:00:00 2001
From: Alexander Ebert <ebert@woltlab.com>
Date: Tue, 7 Jul 2015 22:56:11 +0200
Subject: [PATCH] DOMTraverse::parentBy*() now supports limiting the chain

Passing the 3rd parameter will terminate the traversal if current element equals the given element, similar to the behavior of jQuery's `.closest()`
---
 .../files/js/WoltLab/WCF/DOM/Traverse.js      | 21 ++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/wcfsetup/install/files/js/WoltLab/WCF/DOM/Traverse.js b/wcfsetup/install/files/js/WoltLab/WCF/DOM/Traverse.js
index 4ef2f4c8f7..9608b66b83 100644
--- a/wcfsetup/install/files/js/WoltLab/WCF/DOM/Traverse.js
+++ b/wcfsetup/install/files/js/WoltLab/WCF/DOM/Traverse.js
@@ -37,7 +37,7 @@ define(['DOM/Util'], function(DOMUtil) {
 		return children;
 	};
 	
-	var _parent = function(el, type, value) {
+	var _parent = function(el, type, value, untilElement) {
 		if (!(el instanceof Element)) {
 			throw new TypeError("Expected a valid element as first argument.");
 		}
@@ -45,6 +45,10 @@ define(['DOM/Util'], function(DOMUtil) {
 		el = el.parentNode;
 		
 		while (el instanceof Element) {
+			if (el === untilElement) {
+				return null;
+			}
+			
 			if (_probe[type](el, value)) {
 				return el;
 			}
@@ -144,10 +148,11 @@ define(['DOM/Util'], function(DOMUtil) {
 		 * 
 		 * @param	{Element}	el		child element
 		 * @param	{string}	selector	CSS selector to match parent nodes against
+		 * @param	{Element=}	untilElement	stop when reaching this element
 		 * @return	{(Element|null)}	null if no parent node matched the selector
 		 */
-		parentBySel: function(el, selector) {
-			return _parent(el, SELECTOR, selector);
+		parentBySel: function(el, selector, untilElement) {
+			return _parent(el, SELECTOR, selector, untilElement);
 		},
 		
 		/**
@@ -155,10 +160,11 @@ define(['DOM/Util'], function(DOMUtil) {
 		 * 
 		 * @param	{Element}	el		child element
 		 * @param	{string}	className	CSS class name
+		 * @param	{Element=}	untilElement	stop when reaching this element
 		 * @return	{(Element|null)}	null if there is no parent node with given class
 		 */
-		parentByClass: function(el, className) {
-			return _parent(el, CLASS_NAME, className);
+		parentByClass: function(el, className, untilElement) {
+			return _parent(el, CLASS_NAME, className, untilElement);
 		},
 		
 		/**
@@ -166,10 +172,11 @@ define(['DOM/Util'], function(DOMUtil) {
 		 * 
 		 * @param	{Element}	el		child element
 		 * @param	{string}	tagName		element tag name
+		 * @param	{Element=}	untilElement	stop when reaching this element
 		 * @return	{(Element|null)}	null if there is no parent node of given tag type
 		 */
-		parentByTag: function(el, tagName) {
-			return _parent(el, TAG_NAME, tagName);
+		parentByTag: function(el, tagName, untilElement) {
+			return _parent(el, TAG_NAME, tagName, untilElement);
 		},
 		
 		/**
-- 
2.20.1