Type: Array

A collection of Array methods and functions.

Смотрите также:

MDC Array

Function: Array.each

Used to iterate through arrays, or iterables that are not regular arrays, such as built in getElementsByTagName calls or arguments of a function.

Syntax:

Array.each(iterable, fn[, bind]);

Аргументы:

iterable - (array) The array to iterate through.
fn - (function) The function to test for each element.
bind - (object, optional) The object to use as 'this' within the function. For more information see Function:bind.

Argument: fn

Syntax:

fn(item, index, object)

Arguments:

item - (mixed) The current item in the array.
index - (number) The current item's index in the array. In the case of an object, it is passed the key of that item rather than the index.
object - (mixed) The actual array/object.

Пример:

Array.each(['Sun', 'Mon', 'Tue'], function(day, index){
    alert('name:' + day + ', index: ' + index);
}); // alerts 'name: Sun, index: 0', 'name: Mon, index: 1', etc.

Смотрите также:

Array:each

Notes:

This is an array-specific equivalent of $each from MooTools 1.2.

Function: Array.clone

Returns a copy of the passed array.

Syntax:

var clone = Array.clone(myArray);

Аргументы:

myArray - (array) The array you wish to copy.

Возвращает:

(array) a copy of the passed array.

Пример:

var myArray = ['red', 'blue', 'green'];
var otherArray = Array.clone(myArray);
 
var myArray[0] = 'yellow';
 
alert(myArray[0]);      // alerts 'yellow'
alert(otherArray[0])    // alerts 'red'

Notes:

This is an array-specific equivalent of $unlink from MooTools 1.2.

Function: Array.from

Converts the argument passed in to an array if it is defined and not already an array.

Syntax:

var splatted = Array.from(obj);

Аргументы:

obj - (mixed) Any type of variable.

Возвращает:

(array) If the variable passed in is an array, returns the array. Otherwise, returns an array with the only element being the variable passed in.

Пример:

Array.from('hello'); // returns ['hello'].
Array.from(['a', 'b', 'c']); // returns ['a', 'b', 'c'].

Notes:

This is equivalent to $splat from MooTools 1.2, with the exception of Array-like Objects such as NodeList or FileList which Array.from does transform in Arrays and $splat not.

Array method: each

Calls a function for each element in the array.

Syntax:

myArray.each(fn[, bind]);

Аргументы:

fn - (function) The function which should be executed on each item in the array. This function is passed the item and its index in the array.
bind - (object, optional) The object to be used as 'this' in the function. For more information see Function:bind.

Argument: fn

Syntax

fn(item, index, array)

Arguments:

item - (mixed) The current item in the array.
index - (number) The current item's index in the array.
array - (array) The actual array.

Examples:

//Alerts "0 = apple", "1 = banana", and so on:
['apple', 'banana', 'lemon'].each(function(item, index){
    alert(index + " = " + item);
}); //The optional second argument for binding isn't used here.

Смотрите также:

Notes:

This method is only available for browsers without native MDC Array:forEach support.

Array method: invoke

Returns an array with the named method applied to the array's contents.

Syntax:

var arr = myArray.invoke(method[, arg, arg, arg ...])

Аргументы:

method - (string) The method to apply to each item in the array.
arg - (mixed) Any number of arguments to pass to the named method.

Возвращает:

(array) A new array containing the results of the applied method.

Пример:

var foo = [4, 8, 15, 16, 23, 42];
var bar = foo.invoke('limit', 10, 30);  //bar is now [10, 10, 15, 16, 23, 30]

Notes:

The method that is invoked is a method of each of the items. If the method does not exist, then an error will be thrown. For example:

[0, false, 'string'].invoke('limit', 0, 10); // throws an error!

Array method: every

Returns true if every element in the array satisfies the provided testing function. This method is provided only for browsers without native Array:every support.

Syntax:

var allPassed = myArray.every(fn[, bind]);

Аргументы:

fn - (function) The function to test for each element.
bind - (object, optional) The object to use as 'this' in the function. For more information see Function:bind.

Argument: fn

Syntax:

fn(item, index, array)

Arguments:

item - (mixed) The current item in the array.
index - (number) The current item's index in the array.
array - (array) The actual array.

Возвращает:

(boolean) If every element in the array satisfies the provided testing function, returns true. Otherwise, returns false.

Examples:

var areAllBigEnough = [10, 4, 25, 100].every(function(item, index){
    return item > 20;
}); // areAllBigEnough = false

Смотрите также:

MDC Array:every

Array method: filter

Creates a new array with all of the elements of the array for which the provided filtering function returns true. This method is provided only for browsers without native Array:filter support.

Syntax:

var filteredArray = myArray.filter(fn[, bind]);

Аргументы:

fn - (function) The function to test each element of the array. This function is passed the item and its index in the array.
bind - (object, optional) The object to use as 'this' in the function. For more information see Function:bind.

Argument: fn

Syntax:

fn(item, index, array)

Arguments:

item - (mixed) The current item in the array.
index - (number) The current item's index in the array.
array - (array) The actual array.

Возвращает:

(array) The new filtered array.

Examples:

var biggerThanTwenty = [10, 3, 25, 100].filter(function(item, index){
    return item > 20;
}); // biggerThanTwenty = [25, 100]

Смотрите также:

MDC Array:filter

Array method: clean

Creates a new array with all of the elements of the array which are defined (i.e. not null or undefined).

Syntax:

var cleanedArray = myArray.clean();

Возвращает:

(array) The new filtered array.

Examples:

var myArray = [null, 1, 0, true, false, 'foo', undefined, ''];
myArray.clean() // returns [1, 0, true, false, 'foo', '']

Array method: indexOf

Returns the index of the first element within the array equal to the specified value, or -1 if the value is not found. This method is provided only for browsers without native Array:indexOf support.

Syntax:

var index = myArray.indexOf(item[, from]);

Возвращает:

(number) The index of the first element within the array equal to the specified value. If not found, returns -1.

Аргументы:

item - (object) The item to search for in the array.
from - (number, optional: defaults to 0) The index of the array at which to begin the search.

Examples:

['apple', 'lemon', 'banana'].indexOf('lemon'); // returns 1
['apple', 'lemon'].indexOf('banana'); // returns -1

Смотрите также:

MDC Array:indexOf

Array method: map

Creates a new array with the results of calling a provided function on every element in the array. This method is provided only for browsers without native Array:map support.

Syntax:

var mappedArray = myArray.map(fn[, bind]);

Аргументы:

fn - (function) The function to produce an element of the new Array from an element of the current one.
bind - (object, optional) The object to use as 'this' in the function. For more information see Function:bind.

Argument: fn

Syntax:

fn(item, index, array)

Arguments:

item - (mixed) The current item in the array.
index - (number) The current item's index in the array.
array - (array) The actual array.

Возвращает:

(array) The new mapped array.

Examples:

var timesTwo = [1, 2, 3].map(function(item, index){
    return item * 2;
}); //timesTwo = [2, 4, 6];

Смотрите также:

MDC Array:map

Array method: some

Returns true if at least one element in the array satisfies the provided testing function. This method is provided only for browsers without native Array:some support.

Syntax:

var somePassed = myArray.some(fn[, bind]);

Возвращает:

(boolean) If at least one element in the array satisfies the provided testing function returns true. Otherwise, returns false.

Аргументы:

fn - (function) The function to test for each element. This function is passed the item and its index in the array.
bind - (object, optional) The object to use as 'this' in the function. For more information see Function:bind.

Argument: fn

Syntax:

fn(item, index, array)

Arguments:

item - (mixed) The current item in the array.
index - (number) The current item's index in the array.
array - (array) The actual array.

Examples:

var isAnyBigEnough = [10, 4, 25, 100].some(function(item, index){
    return item > 20;
}); // isAnyBigEnough = true

Смотрите также:

MDC Array:some

Array method: associate

Creates an object with key-value pairs based on the array of keywords passed in and the current content of the array.

Syntax:

var associated = myArray.associate(obj);

Аргументы:

obj - (array) Its items will be used as the keys of the object that will be created.

Возвращает:

(object) The new associated object.

Examples:

var animals = ['Cow', 'Pig', 'Dog', 'Cat'];
var sounds = ['Moo', 'Oink', 'Woof', 'Miao'];
sounds.associate(animals);
// returns {'Cow': 'Moo', 'Pig': 'Oink', 'Dog': 'Woof', 'Cat': 'Miao'}

Array method: link

Accepts an object of key / function pairs to assign values.

Syntax:

var result = myArray.link(object);

Аргументы:

object - (object) An object containing key / function pairs must be passed to be used as a template for associating values with the different keys.

Возвращает:

(object) The new associated object.

Examples:

var el = document.createElement('div');
var arr2 = [100, 'Hello', {foo: 'bar'}, el, false];
arr2.link({
    myNumber: Type.isNumber,
    myElement: Type.isElement,
    myObject: Type.isObject,
    myString: Type.isString,
    myBoolean: function(obj){ return obj != null; }
});
// returns {myNumber: 100, myElement: el, myObject: {foo: 'bar'}, myString: 'Hello', myBoolean: false}

Array method: contains

Tests an array for the presence of an item.

Syntax:

var inArray = myArray.contains(item[, from]);

Аргументы:

item - (object) The item to search for in the array.
from - (number, optional: defaults to 0) The index of the array at which to begin the search.

Возвращает:

(boolean) If the array contains the item specified, returns true. Otherwise, returns false.

Examples:

['a', 'b', 'c'].contains('a'); // returns true
['a', 'b', 'c'].contains('d'); // returns false

Смотрите также:

MDC Array:indexOf

Array method: append

Appends the passed array to the end of the current array.

Syntax:

var myArray = myArray.append(otherArray);

Аргументы:

otherArray - (array) The array containing values you wish to append.

Возвращает:

(array) The original array including the new values.

Examples:

var myOtherArray = ['green', 'yellow'];
['red', 'blue'].append(myOtherArray); // returns ['red', 'blue', 'green', 'yellow'];
 
[0, 1, 2].append([3, [4]]); // [0, 1, 2, 3, [4]]

Notes:

This is an array-specific equivalent of $extend from MooTools 1.2.

Array method: getLast

Returns the last item from the array.

Syntax:

myArray.getLast();

Возвращает:

(mixed) The last item in this array.
(null) If this array is empty, returns null.

Examples:

['Cow', 'Pig', 'Dog', 'Cat'].getLast(); // returns 'Cat'

Array method: getRandom

Returns a random item from the array.

Syntax:

myArray.getRandom();

Возвращает:

(mixed) A random item from this array. If this array is empty, returns null.

Examples:

['Cow', 'Pig', 'Dog', 'Cat'].getRandom(); // returns one of the items

Array method: include

Pushes the passed element into the array if it's not already present (case and type sensitive).

Syntax:

myArray.include(item);

Аргументы:

item - (object) The item that should be added to this array.

Возвращает:

(array) This array with the new item included.

Examples:

['Cow', 'Pig', 'Dog'].include('Cat'); // returns ['Cow', 'Pig', 'Dog', 'Cat']
['Cow', 'Pig', 'Dog'].include('Dog'); // returns ['Cow', 'Pig', 'Dog']

Notes:

If you want to push the passed element even if it's already present, use the vanilla javascript:

myArray.push(item);

Array method: combine

Combines an array with all the items of another. Does not allow duplicates and is case and type sensitive.

Syntax:

myArray.combine(array);

Аргументы:

array - (array) The array whose items should be combined into this array.

Возвращает:

(array) This array combined with the new items.

Examples:

var animals = ['Cow', 'Pig', 'Dog'];
animals.combine(['Cat', 'Dog']); //animals = ['Cow', 'Pig', 'Dog', 'Cat'];

Array method: erase

Removes all occurrences of an item from the array.

Syntax:

myArray.erase(item);

Аргументы:

item - (object) The item to search for in the array.

Возвращает:

(array) This array with all occurrences of the item removed.

Examples:

['Cow', 'Pig', 'Dog', 'Cat', 'Dog'].erase('Dog') // returns ['Cow', 'Pig', 'Cat']
['Cow', 'Pig', 'Dog'].erase('Cat') // returns ['Cow', 'Pig', 'Dog']

Array method: empty

Empties an array.

Syntax:

myArray.empty();

Возвращает:

(array) This array, emptied.

Examples:

var myArray = ['old', 'data'];
myArray.empty(); //myArray is now []

Array method: flatten

Flattens a multidimensional array into a single array.

Syntax:

myArray.flatten();

Возвращает:

(array) A new flat array.

Examples:

var myArray = [1,2,3,[4,5, [6,7]], [[[8]]]];
var newArray = myArray.flatten(); //newArray is [1,2,3,4,5,6,7,8]

Array method: pick

Returns the first defined value of the array passed in, or null.

Syntax:

var picked = [var1, var2, var3].pick();

Возвращает:

(mixed) The first variable that is defined.
(null) If all variables passed in are null or undefined, returns null.

Пример:

function say(infoMessage, errorMessage){
    alert([errorMessage, infoMessage, 'There was no message supplied.'].pick());
 
    //or more MooTools 1.2 style using Generics
    Array.pick([errorMessage, infoMessage, 'There was no message supplied.']);
 
}
say(); // alerts 'There was no message supplied.'
say('This is an info message.'); // alerts 'This is an info message.'
say('This message will be ignored.', 'This is the error message.'); // alerts 'This is the error message.'

Notes:

This is equivalent to $pick from MooTools 1.2.

Array method: hexToRgb

Converts an hexadecimal color value to RGB. Input array must be the following hexadecimal color format. ['FF', 'FF', 'FF']

Syntax:

myArray.hexToRgb([array]);

Аргументы:

array - (boolean, optional) If true is passed, will output an array (e.g. [255, 51, 0]) instead of a string (e.g. "rgb(255, 51, 0)").

Возвращает:

(string) A string representing the color in RGB.
(array) If the array flag is set, an array will be returned instead.

Examples:

['11', '22', '33'].hexToRgb(); // returns 'rgb(17, 34, 51)'
['11', '22', '33'].hexToRgb(true); // returns [17, 34, 51]

Смотрите также:

String:hexToRgb

Array method: rgbToHex

Converts an RGB color value to hexadecimal. Input array must be in one of the following RGB color formats. [255, 255, 255], or [255, 255, 255, 1]

Syntax:

myArray.rgbToHex([array]);

Аргументы:

array - (boolean, optional) If true is passed, will output an array (e.g. ['ff', '33', '00']) instead of a string (e.g. '#ff3300').

Возвращает:

(string) A string representing the color in hexadecimal, or 'transparent' string if the fourth value of rgba in the input array is 0 (rgba).
(array) If the array flag is set, an array will be returned instead.

Examples:

[17, 34, 51].rgbToHex(); // returns '#112233'
[17, 34, 51].rgbToHex(true); // returns ['11', '22', '33']
[17, 34, 51, 0].rgbToHex(); // returns 'transparent'

Смотрите также:

String:rgbToHex

MooTools Core v1.4.5

Core

Types

Browser

Class

Slick

Element

Fx

Request

Utilities

Смотрите также:

Syntax:

Аргументы:

Argument: fn

Syntax:

Arguments:

Пример:

Смотрите также:

Notes:

Syntax:

Аргументы:

Возвращает:

Пример:

Notes:

Syntax:

Аргументы:

Возвращает:

Пример:

Notes:

Syntax:

Аргументы:

Argument: fn

Syntax

Arguments:

Examples:

Смотрите также:

Notes:

Syntax:

Аргументы:

Возвращает:

Пример:

Notes:

Syntax:

Аргументы:

Argument: fn

Syntax:

Arguments:

Возвращает:

Examples:

Смотрите также:

Syntax:

Аргументы:

Argument: fn

Syntax:

Arguments:

Возвращает:

Examples:

Смотрите также:

Syntax:

Возвращает:

Examples:

Syntax:

Возвращает:

Аргументы:

Examples:

Смотрите также:

Syntax:

Аргументы:

Argument: fn

Syntax:

Arguments:

Возвращает:

Examples:

Смотрите также:

Syntax:

Возвращает:

Аргументы:

Argument: fn

Syntax:

Arguments: