Различные функции-утилиты.
Находится в базовом файле y5.js.
dec2hex
y5.Utils.dec2hex(number) -> String — 16-ричное число
Преобразует десятичное число в двузначное 16-тиричное.
| Имя аргумента | Тип | Описание |
|---|---|---|
| number | Number | число |
Пример:
y5.Utils.dec2hex(10); // -> '0A'
fakeFrame
y5.Utils.fakeFrame ->
Создает iframe для IE, для подкладывания под div, чтобы избежать артефактов
с Flash или select.
generateId
y5.Utils.generateId(prefix) -> String — случайный ID
Генерирует случайный ID.
| Имя аргумента | Тип | Описание |
|---|---|---|
| prefix | String | префикс (по умолчанию = '') |
generateUniqueId
y5.Utils.generateUniqueId() -> String — уникальный ID
Генерирует уникальный ID.
Пример:
y5.Utils.generateUniqueId(); // -> 'y5__id45'
getUniqueId
y5.Utils.getUniqueId(object) -> String — уникальный ID
Генерирует уникальный ID и присваивает его свойству uniqueID переданного объекта.
Если свойство uniqueID объекта существует, то просто возвращается значение этого свойства.
| Имя аргумента | Тип | Описание |
|---|---|---|
| object | Object | объект |
hex2dec
y5.Utils.hex2dec(number) -> Number — десятичное число
Преобразует 16-тиричное число в десятичное.
| Имя аргумента | Тип | Описание |
|---|---|---|
| number | String | 16-ричное число |
Пример:
y5.Utils.hex2dec('A'); // -> 10
isEqual
y5.Utils.isEqual(first, second) -> Boolean — результат сравнения
Сравнивает два объекта.
Положительный результат в случае, если объект один и тот же.
| Имя аргумента | Тип | Описание |
|---|---|---|
| first | Object | объект |
| second | Object | объект |
objectCopy
y5.Utils.objectCopy(destination, source) -> Object — объект, получившийся в результате слияния двух объектов
Поочередно копирует свойства двух объектов.
| Имя аргумента | Тип | Описание |
|---|---|---|
| destination | Object | первый объект |
| source | Object | второй объект |
Пример:
y5.Utils.objectCopy({a: 1, b: 3}, {b: 2, c: 3}); // -> {a: 1, b: 2, c: 3}
objectExtends
y5.Utils.objectExtends(destination, source, sourceName)
Расширяет функции прототипа первого объекта функциями прототипа второго объекта.
| Имя аргумента | Тип | Описание |
|---|---|---|
| destination | Object | расширяемый объект |
| source | Object | объект с функциями расширения |
| sourceName | Object | имя объекта расширения |
setTimeout
y5.Utils.setTimeout(method, timeout, context, arg1, arg2, ..., argN) -> ID — ID таймера
Выполняет метод объекта через заданный таймаут.
| Имя аргумента | Тип | Описание |
|---|---|---|
| method | Function | метод |
| timeout | Number | таймаут (мсек) |
| context | Object | объект в контексте которого запускается функция (по умолчанию null) |
| arg1 | Object | аргумент вызываемой функции |
| arg2 | Object | |
| ... | Object | |
| argN | Object |
setUniqueId
y5.Utils.setUniqueId(object, uniqueID) -> String — уникальный ID
Устанавливает значение свойства uniqueID переданного объекта.
| Имя аргумента | Тип | Описание |
|---|---|---|
| object | Object | объект |
| uniqueID | String | уникальный ID (если неопределен, то генерируется новый) |
Пример:
y5.Utils.setUniqueId(object, 'foo'); // -> 'foo' y5.Utils.setUniqueId(object); // -> 'y5__id46'