While most parts of the Spry framework are well and intensively documented. There are some features and functions missing inside the documentation. For the new and upcoming website of Spry-it we are tackling this issue with a new search-able and re-documented database. But until than we are still stuck with the old documentation.. Or not?

In the upcoming blog posts, we will attempt to shine some light on these hidden functions. To kick it off, we will be starting with the SpryDOMUtils.js.

SpryDOMUtils

This part of the Spry framework provides us with tools to work with browsers DOM (Document Object Model) such as a CSS3 complaint element selector (Spry.$$).

You can this file by downloading the complete Spry library at: http://labs.adobe.com/technologies/spry/

Spry.$( arguments );

The Spry.$ is a wrapper for the native document.getElementsById function. It gets like the native function, elements by the id="" attribute. But the Spry function allows you to send multiple arguments to the function. 

Syntax:

Spry.$( arguments );

Arguments:

arguments "String", one or multiple strings that represent the id's

Returns:

HTML Node or Array of HTML Nodes, depending on the amount of arguments you supplied.

Example:

<strong id="element">Strong</strong>
<b id="another">Bold</b>
Spry.$( 'element' ); // returns the HTML element with the id="element"
Spry.$( 'element', 'another' );// returns a Array with both the elements