YMaps.Utils

Пространство имен служебных функций.

МетодыМетоды

Имя	Статический	Возвращает	Описание
boundaryRestrict(value, min, max)		Number	Ограничивает числовое значение на входе заданными минимальным и максимальным пределами.
callMethod(objects, methodName)			Вызывает заданный метод для каждого объекта из множества объектов.
cycleRestrict(value, min, max)		Number	Приводит числовое значение к заданному диапазону.
extend(child, parent)		Object	Реализует наследование прототипа без исполнения конструктора родителя.
normalizeContent(content)		ILayout	Возвращает макет на основе переданных данных.

Подробное описание методовПодробное описание методов

boundaryRestrictboundaryRestrict

{Number} boundaryRestrict(value, min, max)

Ограничивает числовое значение на входе заданными минимальным и максимальным пределами.

Пример:

// Возвращает -180
YMaps.Utils.boundaryRestrict(-250, -180, 180)

Параметры:

Возвращает:

callMethodcallMethod

callMethod(objects, methodName)

Вызывает заданный метод для каждого объекта из множества объектов. Аргументы, начиная с третьего, передаются на вход вызываемому методу.

Пример:

var points = [new YMaps.Point(10, 20), new YMaps.Point(20, 30)];
YMaps.Utils.callMethod(points, "moveBy", new YMaps.Point(10, 10));

Параметры:

cycleRestrictcycleRestrict

{Number} cycleRestrict(value, min, max)

Приводит числовое значение к заданному диапазону.

Считается, что диапазон значений замкнут в кольцо. Если значение выходит за одну из границ диапазона, то излишек отсчитывается по кругу со стороны другой границы.

Как правило, данный метод используется для работы с неограниченными геоточками.

См.: Преобразование координат

Пример:

// Возвращает 110
YMaps.Utils.cycleRestrict(-250, -180, 180);
// Возвращает 60
YMaps.Utils.cycleRestrict(-300, -180, 180);
// Возвращает -170
YMaps.Utils.cycleRestrict(190, -180, 180);

Параметры:

Возвращает:

extendextend

{Object} extend(child, parent)

Реализует наследование прототипа без исполнения конструктора родителя.

Пример:

// Родительский класс
function ParentClass(){}
ParentClass.prototype.parentMethod = function() {
    alert('Parent');
};
// Дочерний класс
function ChildClass(){
    ParentClass.call(this);
}
YMaps.Utils.extend(ChildClass, ParentClass);
var childObject = new ChildClass();
childObject.parentMethod(); // Parent

Параметры:

Возвращает:

normalizeContentnormalizeContent

{ILayout} normalizeContent(content)

Возвращает макет на основе переданных данных.

Если передана пустая строка, null или undefined, то метод возвращает null.

Пример:

map.openBalloon(map.getCenter(), YMaps.Utils.normalizeContent('<p>Центр карты</p>'));

Параметры:

Возвращает: