Native: Element

Custom class to allow all of its methods to be used with any Selectors element via the dollar function $.

Element Property: getElements

Gets all the elements within an element that match the given selector.

Syntax:

var myElements = myElement.getElements(selector[, nocash]);

Arguments:

1. selector - (string) The CSS Selector to match.
2. nocash - (boolean, optional: defaults to false) If true, the found Elements are not extended.

Returns:

• (array) An Element collection.

Examples:

//Returns all anchors within myElement.
$('myElement').getElements('a'); 
 
//Returns all input tags with name "dialog".
$('myElement').getElements('input[name=dialog]');
 
//Returns all input tags with names ending with 'log'.
$('myElement').getElements('input[name$=log]');
 
//Returns all email links (starting with "mailto:").
$('myElement').getElements('a[href^=mailto:]');
 
//Adds events to all Elements with the class name 'email'.
$(document.body).getElements('a.email').addEvents({
    'mouseenter': function(){
        this.href = 'real@email.com';
    },
    'mouseleave': function(){
        this.href = '#';
    }
});

Notes:

• Supports these operators in attribute selectors:

  • = : is equal to
  • ^= : starts-with
  • $= : ends-with
  • != : is not equal to

• Xpath is used automatically in compliant browsers.

Element Property: getElement

Same as Element:getElements, but returns only the first.

Syntax:

var anElement = myElement.getElement(selector);

Arguments:

1. selector - (string) The CSS Selector to match.

Returns:

• (mixed) An extended Element, or null if not found.

Example:

var found = $('myElement').getElement('.findMe').setStyle('color', '#f00');

Note:

• Alternate syntax for $E, where filter is the Element.

Function: $E

Alias for Element:getElement, using document as context.

Element Method: match

Matches the Element with the given selector.

Syntax:

var matched = myElement.match(selector);

Arguments:

1. selector - (string) Selector to match the Element to.

Returns:

• (boolean) true if matched, otherwise false.

Example:

//Returns true if the Element is a div named "somename".
$('myElement').match('div[name=somename]');

See Also: