mirror of
https://github.com/noodlapp/noodl-docs.git
synced 2026-01-12 07:12:53 +01:00
Initial commit
Co-Authored-By: kotte <14197736+mrtamagotchi@users.noreply.github.com> Co-Authored-By: mikaeltellhed <2311083+mikaeltellhed@users.noreply.github.com> Co-Authored-By: Tore Knudsen <18231882+torekndsn@users.noreply.github.com> Co-Authored-By: Michael Cartner <32543275+michaelcartner@users.noreply.github.com>
This commit is contained in:
62
nodes/data/array/array-map.md
Normal file
62
nodes/data/array/array-map.md
Normal file
@@ -0,0 +1,62 @@
|
||||
---
|
||||
hide_title: true
|
||||
hide_table_of_contents: true
|
||||
title: Array Map
|
||||
---
|
||||
|
||||
<##head##>
|
||||
|
||||
# Array Map
|
||||
|
||||
This node takes an input array, runs a small map script on each item, and outputs the resulting mapped array. That is an array with new objects, each created in the mapping script.
|
||||
|
||||
<div className="ndl-image-with-background l">
|
||||
|
||||

|
||||
|
||||
</div>
|
||||
|
||||
<##head##>
|
||||
|
||||
## Inputs
|
||||
|
||||
| Data | Description |
|
||||
| --------------------------------------- | ------------------------------------------------------------ |
|
||||
| <span className="ndl-data">Items</span> | <##input:items##>The array that should be mapped.<##input##> |
|
||||
|
||||
### Script
|
||||
|
||||
The mapping script used to map the objects in the input array to new objects in the mapped output array. The script should be provided in the following format:
|
||||
|
||||
```javascript
|
||||
map({
|
||||
FullName: () => object.first_name + object.last_name,
|
||||
Age: 'years_old',
|
||||
})
|
||||
```
|
||||
|
||||
You can either provide a string with the name of the property that should be mapped with the syntax _to:'from'_ which will simply rename a property taking the value directly from the input object. Or you can provide a mapping function that takes the object (of the type [Noodl.Object](/javascript/reference/object)) and the function should return the mapped value.
|
||||
|
||||
Sometimes you need to extract the **Id** of the objects you are mapping, this can be done in the following way:
|
||||
|
||||
```javascript
|
||||
map({
|
||||
Value: () => object.getId(),
|
||||
Label: 'PhotoName',
|
||||
})
|
||||
```
|
||||
|
||||
Note that the objects that are created when mapping are new objects so they will have their own Id as well.
|
||||
|
||||
## Outputs
|
||||
|
||||
### General
|
||||
|
||||
| Data | Description |
|
||||
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
|
||||
| <span className="ndl-data">Items</span> | <##output:items##>The mapped array.<##output##> |
|
||||
| <span className="ndl-data">Count</span> | <##output:count##>The number of items in the mapped array (this will be the same as the input array)<##output##> |
|
||||
|
||||
| Signal | Description |
|
||||
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <span className="ndl-signal">Changed</span> | <##output:changed##>A signal is emitted here when the input array has been modified which will trigger the _Array Map_ node to remap the input and produce a new output _Items_.<##output##> |
|
||||
Reference in New Issue
Block a user