Полезные методы

Prototype предоставляет ряд “полезных” методов. Большинство из них являются псевдонимами других Prototype методов, за исключением метода $, который обертывает DOM узлы с дополнительной функциональностью.

Эти полезные методы так часто используются во всех скриптах, что их имена сделали настолько короткими, насколько возможно. Отсюда $-основанное соглашение.

Наиболее используемым методом несомненно является $().

Эти методы являются одним из краеугольных камней эффективного JavaScript программирования на основе Prototype. Потратьте немного времени на их изучение.

Методы

$

$(id | element) -> HTMLElement
$((id | element)...) -> [HTMLElement...]

Если передана строка (string), то возвращается элемент c указанным ID; иначе возвращается переданный элемент. Принимает произвольное число аргументов. Все элементы которые возвращаются этим методом поставляться уже с Prototype DOM расширениями.

$$

$$(cssRule...) -> [HTMLElement...]

Принимает произвольное количество CSS правил (strings) и возвращает массив DOM элементов, соответствующих им.

$A

$A(iterable) -> actualArray

Принимает array-подобную коллекцию (все с числовыми индексами) и возвращает ее виде эквивалентного Array объекта. Этот метод является удобным псевдонимом метода Array.from, и является предпочтительным путем для преобразования переменной в Array.

$F

$F(element) -> value

Возвращает значение элемента формы. Этот метод является псевдонимом метода Form.Element.getValue. Обратитесь к нему за подробной информацией.

$H

$H([obj]) -> Hash

Создает Hash (который является синонимом “map” или “ассоциативный массив”).Для удобства обертка вокруг конструктора Hash проверяет, если переданный объект является Hash объектом, то он возвращается не тронутым.

$R

$R(start, end[, exclusive = false]) -> ObjectRange

Создает новый объект ObjectRange object. Этот метод является псевдонимом конструктора ObjectRange,$R - предпочитаемый псевдоним.

$w

$w(String) -> Array

Разбивает строку на элементы code>Массива, разделителем являются пробелы. Эквивалентна функциям Ruby %w{foo bar} и Perl qw(foo bar).

Try.these

Try.these(Function...) -> firstOKResult

Принимает произвольное количество функций и возвращает результат первой, которая на выбросила ошибку.

document.getElementsByClassName

document.getElementsByClassName(className[, element]) -> [HTMLElement...]

Получает (и расширяет) все элементы, у которых указан CSS класс равный className. Необязательный параметр element определяет родительский элемент для поиска в его приделах.