진행 · SINCE v0.3.0
Spinner — 대기 중임을 의미론까지 전달하는 Spinner
테마 아이콘 크기와 color role을 사용하고 기본 로딩 접근성 라벨을 제공하는 Expo·React Native Spinner입니다.
Spinner 사용 시점과 역할
Spinner는 현재 완료량을 알 수 없는 짧은 작업에 사용하는 ActivityIndicator 래퍼입니다. sm·md·lg 크기와 ThemeColors 키를 받으며 별도 라벨이 없으면 Provider의 loading 문자열을 사용합니다.
- sm, md, lg 테마 아이콘 크기
- ThemeColors의 닫힌 color key 지원
- Provider 기본 loading 문자열
설치와 최소 예제
Spinner: 패키지 루트 엔트리에서 import한 뒤 앱이 소유한 상태와 이벤트를 연결하세요.
TypeScript
pnpm add @gj-kit/expo-ui
import { Spinner } from '@gj-kit/expo-ui';
<Spinner accessibilityLabel="파일 목록을 불러오는 중" size="md" />접근성과 플랫폼 동작
progressbar 역할, busy 상태와 읽을 수 있는 accessibilityLabel을 함께 제공합니다. 진행 수치를 알 수 있는 작업에는 ProgressBar의 determinate 모드가 더 적합합니다.
기본 스타일은 현재 UiProvider 테마의 color, spacing, radius, typography, metric 역할에서 파생됩니다. Expo, bare React Native와 React Native Web에서 같은 prop 계약을 사용합니다.