Animated List
Animated list with animated items
Customize
Tweak the props liveAnimation
Effects & Interaction
Auto Add & List
Props
| Name | Type | Default | Description |
|---|---|---|---|
items | AnimatedListItem[] | [] | Array of items to display with id and content |
duration | number | 0.4 | Duration of item animation in seconds |
easing | [number, number, number, number] | [0.25, 0.46, 0.45, 0.94] | Animation easing function as cubic bezier values |
autoAddDelay | number | 2000 | Delay between auto-adding items in ms (0 to disable) |
maxItems | number | 10 | Maximum number of items to display |
startFrom | "top" | "center" | "bottom" | "center" | Starting position of list items |
animationType | "slide" | "fade" | "scale" | "bounce" | "blur" | "slide" | Type of entrance animation for items |
enterFrom | "top" | "bottom" | "left" | "right" | "top" | Direction items enter from |
pauseOnHover | boolean | false | Pause auto-adding when user hovers over the list |
hoverEffect | "none" | "scale" | "none" | Effect when hovering over items |
clickEffect | "none" | "ripple" | "press" | "none" | Effect when clicking items |
fadeEdges | boolean | true | Enable smooth fade at top/bottom edges |
fadeEdgeSize | number | 80 | Size of fade edges in pixels |
fadeColor | string | "#0a0a0a" | Background color for fade edges |
swipeToDismiss | boolean | false | Enable swiping items to dismiss them |
onDismiss | (item: AnimatedListItem) => void | undefined | Callback when an item is dismissed via swipe |
onItemClick | (item: AnimatedListItem) => void | undefined | Callback function when an item is clicked |
itemGap | number | 12 | Gap between items in pixels |
className | string | "" | Additional CSS classes |
renderItem | (item: AnimatedListItem) => ReactNode | undefined | Custom item render function |
height | string | number | "600px" | Height of the container |
itemsAnimatedListItem[]Array of items to display with id and content
[]durationnumberDuration of item animation in seconds
0.4easing[number, number, number, number]Animation easing function as cubic bezier values
[0.25, 0.46, 0.45, 0.94]autoAddDelaynumberDelay between auto-adding items in ms (0 to disable)
2000maxItemsnumberMaximum number of items to display
10startFrom"top" | "center" | "bottom"Starting position of list items
"center"animationType"slide" | "fade" | "scale" | "bounce" | "blur"Type of entrance animation for items
"slide"enterFrom"top" | "bottom" | "left" | "right"Direction items enter from
"top"pauseOnHoverbooleanPause auto-adding when user hovers over the list
falsehoverEffect"none" | "scale"Effect when hovering over items
"none"clickEffect"none" | "ripple" | "press"Effect when clicking items
"none"fadeEdgesbooleanEnable smooth fade at top/bottom edges
truefadeEdgeSizenumberSize of fade edges in pixels
80fadeColorstringBackground color for fade edges
"#0a0a0a"swipeToDismissbooleanEnable swiping items to dismiss them
falseonDismiss(item: AnimatedListItem) => voidCallback when an item is dismissed via swipe
undefinedonItemClick(item: AnimatedListItem) => voidCallback function when an item is clicked
undefineditemGapnumberGap between items in pixels
12classNamestringAdditional CSS classes
""renderItem(item: AnimatedListItem) => ReactNodeCustom item render function
undefinedheightstring | numberHeight of the container
"600px"