Toast: 상호작용 명세
토스트 패턴의 상태, 트리거, 사용자 동작, 반응형 동작, 콘텐츠 규칙 및 실패 상태를 정의합니다. 이 참조는 채택 경계, 실패 동작 및 관찰 가능한 증거를 고정하면서 환경별 제한은 구성 가능하도록 남겨둡니다.
패키지 상태: 참조 컨텍스트가 인간 검토를 위해 준비됨. 계약 및 테스트 시나리오는 완성되었으나, 채택 구현이 이를 통과했다는 주장은 없습니다.
결정
Toast의 경우, 가능한 경우 네이티브 의미론을 사용하여 재사용 가능한 상태 및 상호작용 계약을 채택합니다. 가시적 상태, 가능한 경우 되돌릴 수 있는 선택, 보존된 입력 및 접근 가능한 복구를 포함하는 결정론적 사용자 여정을 정의합니다. 이 패키지는 참조 계약이며, 채택 팀은 자체 환경의 증거를 바탕으로 수치 한계, 공급자, 관할 구역 및 운영 소유자를 선택해야 합니다.
범위
- 이 UX 블록에서 설명하는 Toast 행위자, 입력, 출력, 상태, 정책 또는 스키마 버전 및 외부에 보이는 결과.
- 기본 및 대체 인터페이스, 백그라운드 작업, 캐시, 통합, 지원 경로 및 동일 경계를 실행할 수 있는 증거.
- 참조를 안전하게 적용하기 위해 필요한 채택별 구성, 롤아웃, 복구 및 검증 책임.
이 블록 외부
- 모든 채택자를 위한 보편적 공급자, 프레임워크, 관할 구역, 수치 임계값, 보존 기간 또는 서비스 수준 목표 선택.
- 패키지된 시나리오가 하위 구현에 대해 실행되었거나 이 참조가 법적, 보안 또는 접근성 인증을 부여한다고 주장하는 것.
계약
- 패턴이 진입할 수 있는 트리거, 열림 또는 활성, 로딩, 성공, 비어 있음, 유효하지 않음, 오류, 비활성 및 해제 상태 정의.
- 키보드 입력, 포커스 진입 및 복귀, 접근 가능한 이름, 알림, 포인터 동작 및 터치 대상 동작을 함께 명시.
- 파괴적, 되돌릴 수 없거나 외부 효과를 명확히 하고 작업이 진행 중일 때 중복 활성화를 방지.
- 좁은 너비, 높은 확대, 텍스트 확장, 강제 색상 및 동작 감소 시에도 콘텐츠 계층 및 동작을 사용 가능하게 유지.
- 작업이 실제로 진행 중일 때만 진행 상황 표시, 사용자의 확정된 의도를 숨기지 않고 중복 활성화 방지.
- 검증, 권한, 연결성, 충돌 및 최종 실패를 구분하는 평이하고 동작별 메시지 사용.
- 간결하고 차단하지 않는 상태 표시를 위해 토스트 사용, 적절한 라이브 영역을 통해 알림, 반복 또는 동시 메시지는 중복 제거 및 순서 유지.
- 필수 복구를 시간 제한 메시지에만 두지 말고, 실행 가능한 콘텐츠를 일시 중지하거나 지속시키며, 포커스 손실 없이 해제 지원, 내구성 있는 결과는 페이지 상태로 이동.
구현 지침
- 행복 경로 레이아웃을 확정하기 전에 가장 길고, 비어 있으며, 느리고, 오프라인이고, 거부되었으며, 보조 기술 경로를 프로토타입.
- 프레임워크 또는 공급자 세부사항 선택 전에 Toast 입력, 출력, 행위자, 상태, 불변 조건, 부작용 및 증거 모델링.
- 적용 가능한 Toast 계약 또는 정책 버전을 자료 상태와 함께 저장하여 마이그레이션, 재생 및 지원 결정이 추적 가능하도록 함.
- 통제된 롤아웃 뒤에 경로 도입, 예상 및 관찰 결과 비교, 채택 증거가 완성될 때까지 테스트된 복구 경로 유지.
실패 처리 및 안전장치
- 작업 실패 시 관련 입력 및 포커스 보존, 결과 알림, 안전한 복구 경로가 있는 상태로 컴포넌트 복귀.
- 유효하지 않거나 모순된 Toast 상태는 거부 또는 격리; 구현은 권한을 확장하거나 효과를 중복하는 값을 추측하지 않음.
- 재시도는 한계가 있으며 내구성 있는 식별자 사용; 소진 후 작업은 책임 소유자가 있는 검사 가능한 최종 상태에 도달.
검증 및 운영
- 키보드, 터치, 화면 판독기, 좁은 뷰포트, 지연된 네트워크 및 복구 가능한 서버 오류로 여정 완료.
- 민감한 페이로드 차원 없이 계약 버전별 Toast 성공, 거부, 검증 실패, 의존성 실패, 재시도 소진 및 복구 모니터링.
- 정책, 스키마, 의존성, 마이그레이션 또는 경계 변경 후 양성 및 음성 픽스처를 재실행하고 결과 증거 보존.
채택 가정
- 예제의 이름과 값은 구체적인 픽스처이며 보편적 기본값이 아님; 채택자는 문서화된 증거와 소유권을 통해 이를 교체.
- 채택 시스템은 인증된 신원, 내구성 있는 작업 또는 기록 버전, 제한된 원격 측정 및 변경을 위한 통제된 경로를 제공할 수 있음.
이 패키지의 실행 가능한 예제는 픽스처 및 수용 계약입니다.
구조 및 메타데이터를 확인하려면 컬렉션 검증기를 실행한 후, 대상 저장소에서 시나리오를 번역 및 실행하여 구현 증거를 기록하세요.