2018-02-12 16:01:20 +00:00
|
|
|
/**
|
|
|
|
* @author Richard Davey <rich@photonstorm.com>
|
2019-01-15 16:20:22 +00:00
|
|
|
* @copyright 2019 Photon Storm Ltd.
|
2019-05-10 15:15:04 +00:00
|
|
|
* @license {@link https://opensource.org/licenses/MIT|MIT License}
|
2018-02-12 16:01:20 +00:00
|
|
|
*/
|
|
|
|
|
2017-10-04 16:05:26 +00:00
|
|
|
/**
|
2018-03-17 17:16:26 +00:00
|
|
|
* Takes an array of objects and returns the first element in the array that has properties which match
|
|
|
|
* all of those specified in the `compare` object. For example, if the compare object was: `{ scaleX: 0.5, alpha: 1 }`
|
|
|
|
* then it would return the first item which had the property `scaleX` set to 0.5 and `alpha` set to 1.
|
2018-03-20 14:57:12 +00:00
|
|
|
*
|
2018-03-17 17:16:26 +00:00
|
|
|
* To use this with a Group: `GetFirst(group.getChildren(), compare, index)`
|
2017-10-04 16:05:26 +00:00
|
|
|
*
|
|
|
|
* @function Phaser.Actions.GetFirst
|
|
|
|
* @since 3.0.0
|
2018-03-20 14:57:12 +00:00
|
|
|
*
|
2018-03-27 11:14:08 +00:00
|
|
|
* @generic {Phaser.GameObjects.GameObject[]} G - [items]
|
|
|
|
*
|
2018-03-20 14:57:12 +00:00
|
|
|
* @param {(array|Phaser.GameObjects.GameObject[])} items - The array of items to be searched by this action.
|
2018-03-17 17:16:26 +00:00
|
|
|
* @param {object} compare - The comparison object. Each property in this object will be checked against the items of the array.
|
|
|
|
* @param {integer} [index=0] - An optional offset to start searching from within the items array.
|
2018-03-20 14:57:12 +00:00
|
|
|
*
|
2018-03-20 22:36:41 +00:00
|
|
|
* @return {?(object|Phaser.GameObjects.GameObject)} The first object in the array that matches the comparison object, or `null` if no match was found.
|
2017-10-04 16:05:26 +00:00
|
|
|
*/
|
2017-06-19 13:38:22 +00:00
|
|
|
var GetFirst = function (items, compare, index)
|
|
|
|
{
|
2018-03-17 17:16:26 +00:00
|
|
|
if (index === undefined) { index = 0; }
|
|
|
|
|
2017-06-19 13:38:22 +00:00
|
|
|
for (var i = index; i < items.length; i++)
|
|
|
|
{
|
|
|
|
var item = items[i];
|
|
|
|
|
|
|
|
var match = true;
|
|
|
|
|
|
|
|
for (var property in compare)
|
|
|
|
{
|
|
|
|
if (item[property] !== compare[property])
|
|
|
|
{
|
|
|
|
match = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (match)
|
|
|
|
{
|
|
|
|
return item;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return null;
|
|
|
|
};
|
|
|
|
|
|
|
|
module.exports = GetFirst;
|