상태 · SINCE v0.3.0
Alert — 액션과 live 정책을 선택하는 인라인 Alert
info, success, warning, error 안내에 제목·본문·액션·닫기를 조합하고 live region을 명시적으로 제어하는 Alert입니다.
Alert 사용 시점과 역할
Alert는 title 또는 비어 있지 않은 children을 반드시 요구합니다. action은 label과 onPress를 함께 받고 onDismiss가 있을 때만 닫기 IconButton을 렌더링하며, 정적 안내의 기본 live 값은 off입니다.
- info, success, warning, error의 의미별 soft 배경과 전경
- 선택적 action 객체와 dismiss 버튼
- off, polite, assertive live region 정책
설치와 최소 예제
Alert: 패키지 루트 엔트리에서 import한 뒤 앱이 소유한 상태와 이벤트를 연결하세요.
TypeScript
pnpm add @gj-kit/expo-ui
import { Alert } from '@gj-kit/expo-ui';
<Alert title="오프라인 상태" variant="warning" live="polite">연결되면 자동으로 동기화합니다.</Alert>접근성과 플랫폼 동작
정적 Alert는 기본적으로 live region을 만들지 않습니다. 비동기 결과에는 polite를, 즉시 주의가 필요한 오류에는 assertive를 선택할 수 있고 닫기 버튼은 Provider의 close 라벨을 사용합니다.
기본 스타일은 현재 UiProvider 테마의 color, spacing, radius, typography, metric 역할에서 파생됩니다. Expo, bare React Native와 React Native Web에서 같은 prop 계약을 사용합니다.