up.fragment up.fragment.first([root], selector, [options])
JavaScript function

This feature is experimental. It may be changed or removed in a future version without prior notice or deprecation.

Returns the first element matching the given selector, but ignores elements that are being destroyed or that are being removed by a transition.

Returns undefined if no element matches these conditions.

To select the first element with the selector .foo:

var fooInModal = up.fragment.first('.foo')

You may also pass a { layer } option to only match elements witin a layer:

var fooInModal = up.fragment.first('.foo', { layer: 'modal' })

You may also pass a root element as a first argument:

var container = up.fragment.first('.container')
var fooInContainer = up.fragment.first(container, '.foo')

The .up-destroying class is assigned to elements during their removal animation.
The up.element.first() function simply returns the first element matching a selector without further filtering.

Parameters

[root=document] ElementorjQuery optional

The root element for the search. Only the root's children will be matched.

May be omitted to search through all elements in the document.

selector string

The selector to match

[options.layer='auto'] string optional

The name of the layer in which to find the element.

Valid values are 'auto', 'page', 'modal' and 'popup'.

[options.origin] stringorElementorjQuery optional

An second element or selector that can be referenced as & in the first selector:

var input = document.querySelector('input.email')
up.fragment.first('fieldset:has(&)', { origin: input }) // returns the <fieldset> containing input

Elementorundefined

The first element that is neither a ghost or being destroyed, or undefined if no such element was found.