List
The List component is a flexible component for rendering ordered or unordered lists from an array of items.
Props
Prop | Type | Default | Description |
|---|---|---|---|
type | 'ol' | 'ul' | 'ul' | Specifies the type of list to render. |
items | Array<T> | [] | An array of items to be rendered. |
itemTemplate | Snippet<[T, number]> | required | A Svelte snippet used to render each item. Receives item and index. |
class | string | '' | Custom CSS classes for the list element. |
itemClass | string | '' | Custom CSS classes for each list item (li). |
overrideDefaultStyling | boolean | false | If true, removes default fluid styling. |
...rest | HTMLAttributes | — | Standard HTML list attributes. |
Samples
Unordered List
A basic unordered list with default markers.
- Apple
- Banana
- Orange
0
<List items={fruitItems}>1
{#snippet itemTemplate(item)}2
{item}3
{/snippet}4
</List>Ordered List
A numbered list using the "ol" type prop.
- Step 1
- Step 2
- Step 3
0
<List type="ol" items={numberItems}>1
{#snippet itemTemplate(item)}2
Step {item}3
{/snippet}4
</List>Item Styling
Styling individual items using the itemClass prop.
- Apple
- Banana
- Orange
0
<List 1
items={fruitItems} 2
itemClass="p-2 bg-neutral-100 rounded list-none"3
>4
{#snippet itemTemplate(item)}5
{item}6
{/snippet}7
</List>Complex Objects
Rendering objects with custom logic in the snippet.
Create documentation for List component
Style the list items
Push changes to repository
0
<List items={tasks}>1
{#snippet itemTemplate(item)}2
<Text class={item.completed ? 'line-through' : ''}>{item.text}</Text>3
{/snippet}4
</List>