A simple component used for rendering collections and arrays.
Homepage Repository npm Download
A simple React component used for rendering collections and arrays.
When you see this component, you may be asking "Why did you make this? You can just use
the 'map' function of your item array!". So, here are the reasons that you might use
this component instead of the map
function:
connect
from the
redux-react
library.else
prop below).map
if you don't need this for the first two reasons that have been
listed for efficiency reasons).$ npm i --save react-each
import React from 'react';
import Each from 'react-each';
export default function MyComponent(props) {
return (
{/* ... */}
<Each items={props.items} renderItem={(item, index, { itemsLastIndex }, items) => (
// Render item...
)} else={() => (
// Render component(s) when list is not defined or is empty...
)} />
{/* ... */}
);
}
items ?(Array|Function)
Array of items (or function which returns an array of items) to use for rendering.
renderItem !Function
- REQUIRED
Render function called for each item found in the given items
array.
else ?Function
Render function called when items
array is not defined or is empty.
startIndex ?Number
(Default: 0
)
Index to start at (inclusively) when rendering items
(all items that come before
startIndex
will not be rendered).
endIndex ?Number
(Default: (items.length - 1)
)
Index to end at (inclusively) when rendering items
(all items that come after
endIndex
will not be rendered).
ISC License (ISC)
Copyright (c) 2019, Brandon D. Sara (http://bsara.pro/)
Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.