Repolode
ammarahm-ed

ammarahm-ed/react-native-actions-sheet

Android, iOS, Web을 지원하며 유연한 API로 커스텀 콘텐츠를 담을 수 있는 크로스 플랫폼 React Native 액션 시트 컴포넌트

스타
2,195
포크
158
열린 이슈
45
마지막 커밋
그저께

어떤 프로젝트인가요?

react-native-actions-sheet는 액션 메뉴, 피커, 드로어 등에 자주 사용하는 바텀 시트를 렌더링하는 React Native 컴포넌트입니다. Android, iOS, Web에서 작동하며 시트 안에 임의의 React 콘텐츠를 넣을 수 있습니다.

이 라이브러리는 react-native-reanimated, react-native-worklets, react-native-gesture-handler, react-native-safe-area-context를 기반으로 합니다. 제스처, 스크롤 처리, 애니메이션이 UI 스레드에서 실행되므로 JavaScript 스레드가 바빠도 시트가 멈추지 않습니다. 버전 11은 React Native의 New Architecture가 필요하며, 아직 레거시 아키텍처를 사용하는 앱은 버전 10을 계속 사용하도록 안내합니다.

여러 스냅 포인트, 놓을 때의 속도에 따른 플릭 닫기, 하나의 시트 안에 여러 스크롤 영역을 두는 기능을 제공하며, 슬라이더, 지도, WebView를 위한 SheetGestureBlocker도 포함합니다. 테스트에 사용할 수 있는 공식 Jest mock도 제공됩니다.

핵심 기능

  • 01하나의 코드베이스로 Android, iOS, Web에서 작동합니다.
  • 02시트 안에 임의의 React 콘텐츠를 렌더링합니다.
  • 03제스처와 애니메이션이 UI 스레드에서 실행됩니다.
  • 04여러 스냅 포인트와 플릭 닫기를 지원합니다.
  • 05슬라이더, 지도, WebView를 위한 제스처 차단 기능을 제공합니다.
  • 06테스트용 공식 Jest mock을 제공합니다.

활용 사례

  • React Native 앱에서 바텀 시트로 액션 메뉴나 컨텍스트 메뉴를 표시합니다.
  • 화면 아래에서 위로 올라오는 피커나 선택 패널을 만듭니다.
  • 모바일이나 웹의 드래그 가능한 드로어에 폼이나 스크롤 가능한 목록을 넣습니다.

빠른 시작

  1. 1

    라이브러리를 설치하세요

    npm install react-native-actions-sheet
  2. 2

    필요한 peer dependencies를 설치하세요

    npm install react-native-reanimated react-native-worklets react-native-gesture-handler react-native-safe-area-context
  3. 3

    설정 방법은 문서의 설치 가이드를 따르세요

사용 전 알아둘 점

  • 버전 11에는 React Native의 New Architecture가 필요합니다. legacy architecture 앱은 버전 10을 사용해야 합니다.
  • reanimated, worklets, gesture-handler, safe-area-context 등 여러 네이티브 라이브러리에 의존하며, 이 라이브러리들도 설치해야 합니다.

토픽

자주 묻는 질문

react-native-actions-sheet은(는) 무엇인가요?
Android, iOS, Web을 지원하며 유연한 API로 커스텀 콘텐츠를 담을 수 있는 크로스 플랫폼 React Native 액션 시트 컴포넌트 react-native-actions-sheet는 액션 메뉴, 피커, 드로어 등에 자주 사용하는 바텀 시트를 렌더링하는 React Native 컴포넌트입니다. Android, iOS, Web에서 작동하며 시트 안에 임의의 React 콘텐츠를 넣을 수 있습니다.
react-native-actions-sheet은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
react-native-actions-sheet은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
react-native-actions-sheet은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. react-native-actions-sheet의 마지막 커밋은 2026년 10월 18일입니다.
react-native-actions-sheet은(는) 어디에 사용할 수 있나요?
React Native 앱에서 바텀 시트로 액션 메뉴나 컨텍스트 메뉴를 표시합니다. 화면 아래에서 위로 올라오는 피커나 선택 패널을 만듭니다. 모바일이나 웹의 드래그 가능한 드로어에 폼이나 스크롤 가능한 목록을 넣습니다.
react-native-actions-sheet는 어떻게 설치하나요?
라이브러리를 설치하세요: npm install react-native-actions-sheet 필요한 peer dependencies를 설치하세요: npm install react-native-reanimated react-native-worklets react-native-gesture-handler react-native-safe-area-context 설정 방법은 문서의 설치 가이드를 따르세요
react-native-actions-sheet은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ammarahm-ed/react-native-actions-sheet

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트