Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
8f5860f
chore: auth
zaewc Dec 24, 2025
7e40481
chore: Get Started URL 404 Error
Dino0204 Dec 28, 2025
450b47a
fix: 상대 경로
Dino0204 Dec 28, 2025
26bba93
docs: desc
zaewc Dec 25, 2025
08c03a9
chore: external bundle
zaewc Dec 28, 2025
4d2ed64
fix: ecmascript 상 private field 사용
zaewc Dec 28, 2025
bf1c692
Update packages/core/src/strategies/layout/FixedLayoutStrategy.ts
zaewc Dec 28, 2025
7a5ee32
fix: readonly
zaewc Dec 27, 2025
797b120
perf: 메모이제이션 추가
zaewc Dec 28, 2025
e8fbea0
fix: | 0
zaewc Dec 28, 2025
84c77df
perf: Terser 세팅
zaewc Dec 28, 2025
cd54372
refector: react 코드 간결화
zaewc Dec 28, 2025
725156d
Update packages/core/tsup.config.ts
zaewc Dec 28, 2025
1e13699
chore: ts 2022->2020
zaewc Dec 29, 2025
32aade5
chore: delete unsafe options
zaewc Dec 29, 2025
827aaa8
docs: update readme.md
zaewc Dec 29, 2025
917e9d7
fix: animation
zaewc Dec 29, 2025
1ef0baf
Fix NPM Downloads badge link in README.md
zaewc Dec 29, 2025
5276401
perf: Memoize VirtualList renderItem prop with useCallback.
zaewc Feb 24, 2026
b85efec
refactor: Improve virtualizer render range calculation using Math.min…
zaewc Feb 24, 2026
87c9379
chore: add vscode into gitignore
zaewc Feb 24, 2026
475572d
refactor: improve type annotation for cleanupTimer to `ReturnType<typ…
zaewc Feb 24, 2026
5b32a6f
refactor: reorder `virtualListRenderItem` `useCallback` definition
zaewc Feb 24, 2026
5f7f8ba
Merge branch 'master' into develop
zaewc Feb 24, 2026
c0fd3bf
refactor: use named function for VirtualList's renderItem prop
zaewc Feb 24, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,5 @@ dist/
./packages/react/playwright-report
./packages/react/test-results
coverage/
cache/
cache/
.vscode
148 changes: 43 additions & 105 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,39 +1,53 @@
<img width="300" alt="4f11d7e413d6546a60fddc0e02219658e360d58512bc11c1acc57530fab307de" src="https://github.com/user-attachments/assets/d35a27e7-7895-43e5-9b4f-ac29c403dd3e" />
<img width="300" alt="scrolloop logo" src="https://github.com/user-attachments/assets/d35a27e7-7895-43e5-9b4f-ac29c403dd3e" />

# scrolloop
# [scrolloop](https://976520.github.io/scrolloop/)

React 스크롤 컴포넌트 라이브러리
The modern scrolling component for React and React Native

Just a scrolling library for React

![NPM Downloads](https://img.shields.io/npm/d18m/scrolloop)
![NPM Downloads](https://img.shields.io/npm/dt/scrolloop)
![Repo size](https://img.shields.io/github/repo-size/976520/scrolloop)
![Last commit](https://img.shields.io/github/last-commit/976520/scrolloop?color=red)
![Top language](https://img.shields.io/github/languages/top/976520/scrolloop)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)

## Install

### React

```bash
npm install scrolloop
yarn add scrolloop
pnpm add scrolloop
npm install @scrolloop/react
# or
yarn add @scrolloop/react
# or
pnpm add @scrolloop/react
```

## Examples
### React Native

```bash
npm install @scrolloop/react-native
# or
yarn add @scrolloop/react-native
# or
pnpm add @scrolloop/react-native
```

### VirtualList
## Quick Start

### React

```tsx
const items = Array.from({ length: 10000 }, (_, i) => `Item ${i}`);
import { VirtualList } from "@scrolloop/react";

function App() {
const items = Array.from({ length: 1000 }, (_, i) => `Item #${i}`);

export default function App() {
return (
<VirtualList
count={items.length}
itemSize={40}
itemSize={50}
height={400}
renderItem={(index, style) => (
<div style={style} key={index}>
<div key={index} style={style}>
{items[index]}
</div>
)}
Expand All @@ -42,18 +56,21 @@ export default function App() {
}
```

### React Native

```tsx
import { View, Text } from "react-native";
import { VirtualList } from "@scrolloop/react-native";

const items = Array.from({ length: 10000 }, (_, i) => `Item ${i}`);
function App() {
const items = Array.from({ length: 1000 }, (_, i) => `Item #${i}`);

export default function App() {
return (
<VirtualList
count={items.length}
itemSize={40}
itemSize={50}
renderItem={(index, style) => (
<View style={style} key={index}>
<View key={index} style={style}>
<Text>{items[index]}</Text>
</View>
)}
Expand All @@ -62,91 +79,12 @@ export default function App() {
}
```

### InfiniteList

```tsx
interface User {
id: string;
name: string;
email: string;
}

export default function UserList() {
return (
<InfiniteList<User>
fetchPage={fetchFunction()}
pageSize={20}
itemSize={60}
height={800}
renderItem={(user, index, style) => (
<div
style={{
...style,
padding: "8px 16px",
borderBottom: "1px solid #eee",
}}
>
<h3>{user.name}</h3>
<p>{user.email}</p>
</div>
)}
renderLoading={() => <div>로딩 중...</div>}
renderError={(error, retry) => (
<div>
<p>{error.message}</p>
<button onClick={retry}>재시도</button>
</div>
)}
renderEmpty={() => <div>데이터가 없습니다.</div>}
/>
);
}
```

```tsx
import { View, Text, TouchableOpacity } from "react-native";

interface User {
id: string;
name: string;
email: string;
}
## Packages

export default function UserList() {
return (
<InfiniteList<User>
fetchPage={fetchFunction()}
pageSize={20}
itemSize={60}
height={800}
renderItem={(user, index, style) => (
<View
style={{
...style,
padding: 8,
borderBottomWidth: 1,
borderBottomColor: "#eee",
}}
>
<Text style={{ fontSize: 16, fontWeight: "bold" }}>{user.name}</Text>
<Text style={{ color: "#666" }}>{user.email}</Text>
</View>
)}
renderLoading={() => <Text>로딩 중...</Text>}
renderError={(error, retry) => (
<View>
<Text>{error.message}</Text>
<TouchableOpacity onPress={retry}>
<Text>재시도</Text>
</TouchableOpacity>
</View>
)}
renderEmpty={() => <Text>데이터가 없습니다.</Text>}
/>
);
}
```
- **@scrolloop/core**: Platform-agnostic virtual scrolling logic
- **@scrolloop/react**: React implementation
- **@scrolloop/react-native**: React Native implementation

## license
## License

MIT
2 changes: 1 addition & 1 deletion docs/.vitepress/config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ export default defineConfig({
base: "/scrolloop/",

head: [
["link", { rel: "icon", href: "/favicon.ico" }],
["link", { rel: "icon", href: "/favicon.svg" }],
["meta", { name: "theme-color", content: "#7c3aed" }],
],

Expand Down
4 changes: 2 additions & 2 deletions docs/.vitepress/theme/Hero.vue
Original file line number Diff line number Diff line change
Expand Up @@ -37,11 +37,11 @@ const animateCountUp = (targetValue, duration, callback) => {
};

const startInitialAnimation = () => {
animateCountUp(42, 1500, (value) => {
animateCountUp(36, 2500, (value) => {
kbCount.value = value;
});

animateCountUp(1048596, 2500, (value) => {
animateCountUp(1048596, 3500, (value) => {
millionsCount.value = value;
if (value >= 1048596) {
if (!incrementStarted.value) {
Expand Down
Loading