Elementals.js

Latest Version: 3.0 RC 1 17 July 2017

Method _.Node.next

Similar to Element.nextSibling, this finds the next sibling node matches the passed mask, or the next Element node if a mask is omitted.

The reason to do this instead of nextSibling is that first, you can match by tagName. Second, there are other types of nodes that can end up on the DOM beside element... such as text nodes, comment nodes, etc.

Calling Convention:
_.Node.next(Element[, nodeMask || tagName])
Parameters:
Element
The Element to find the next sibling that matches the mask.
nodeMask optional

A bitwise mask used to filter the results. See the Node Masking page for more information.

If omitted, a mask of 1 (matching for nodeType 1) is used.

tagName optional
A tagName to match. When used instead of a nodeMask only elements of node type 1 with a matching tagName will be counted.
Returns:
The matching element, or false if no match found.

Example

HTML

<ul>
	<li>First</li>
	<li id="test">Second</li>
	<li>Third</li>
</ul>

JavaScript

var test = document.getElementById('test');
Console.log(_.Node.text(_.Node.next(test)));

Will output "Third"