Components

<For>

Edit this page

The <For> component is used to render a list of items. It is similar to the .map() function in JavaScript.

function For<T, U extends JSX.Element>(props: {
each: readonly T[]
fallback?: JSX.Element
children: (item: T, index: () => number) => U
}): () => U[]

A referentially keyed loop with efficient updating of only changed items. The callback takes the current item as the first argument:

<For each={state.list} fallback={<div>Loading...</div>}>
{(item) => <div>{item}</div>}
</For>

The each prop can also be a function that returns a list. This is useful for creating a loop that depends on a state value:

<For each={stateSignal()}>{(item) => <div>{item}</div>}</For>

The optional second argument is an index signal:

<For each={state.list} fallback={<div>Loading...</div>}>
{(item, index) => (
<div>
#{index()} {item}
</div>
)}
</For>

Props

NameTypeDescription
eachreadonly T[]The list of items to render.
fallbackJSX.ElementA fallback element to render while the list is loading.
children(item: T, index: () => number) => UA callback that returns a JSX element for each item in the list.
Report an issue with this page