Page Comparison

Finds the nearest ancestor of the element that passes the test.

{section}
{column:width=70%}

Finds the nearest ancestor of the element that passes the test.

{code:javascript|borderStyle=none|bgColor=white}
fluid.findAncestor(element, test);

{code}

*File name:* {{Fluid.js

Parameters

}}

h2. Parameters

{span:class=borderless-table

}
|*{{element}}*| (Element) DOM

 element |
|*{{test}}*| (Function) A function which takes an element as a parameter and returns true or false for some test

Return Value

{div:class=api-page

}

h1. fluid.findAncestor(element, test)

Example

. |
{span}

h2. Return Value
{span:class=borderless-table}
|*Element*| the nearest ancestor that passes the test |
{span}

{column}

{column:width=5%}
{column}

{column}
h3. See Also

{column}
{section}
----

h3. Example
{code:javascript}
var smallHeader = fluid.jById(id);
var bigHeader = fluid.findAncestor(smallHeader, function (element) {
    return $(element).is(selectors.sortHeader);
});

{code}
In this example, {{fluid.findAncestor()}} is used to find an ancestor of {{smallHeader}} that has a desired selector.

{div}