PartialFailureRow
읽지 못한 기간과 다시 시도. 받은 결과는 유지.
- 출시 화면에서 사용
개요
미리보기
Couldn’t read Sep 2–Sep 20. The 128 we got are kept.
예시
상태
기간 있음
Couldn’t read Sep 2–Sep 20. The 128 we got are kept.
다시 시도 중
Couldn’t read Sep 2–Sep 20. The 128 we got are kept.
다시 시도 실패
Couldn’t read Sep 2–Sep 20. The 128 we got are kept.
Tried again but couldn’t scan. What we got is kept.
쓰임 예
슬롯 직접 지정 (es)
Correos del 2 al 20 de septiembre: no pudimos leerlos. Los 128 recibidos se conservan.
이렇게 · 이렇게 하지 않기
- 이렇게 읽지 못한 기간을 알면 날짜를 쓰고, 모르면 날짜 없이 쓴다. 받은 결과가 남아 있다는 것을 같은 문장에 쓴다.
- 이렇게 목록 위에 고정하고 다시 시도 버튼 하나를 둔다.
- 이렇게 하지 않기 페이지 맨 위 배너로 올리지 않는다. ✓ 체크 목록·진행률·“확인됨”을 쓰지 않는다. 받은 결과를 숨기지 않는다.
토큰과 속성
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
failedRange? | { start: string; end: string } | null | — | 읽지 못한 기간(overlays.partial.failedRange). 없거나 틀리면 “일부”로 쓰고 추측하지 않는다. |
received? | number | — | 받은 결과 수(그대로 있음). |
state? | 'idle' | 'retrying' | 'retry-failed' | idle | retrying은 버튼 loading(초점 유지). retry-failed는 행을 유지하고 한 번 assertive로 알린다. |
what? | string | | 슬롯 what(무엇이). 비우면 failedRange로 만든다. |
fact? | string | | 슬롯 fact(사실 한 줄). 비우면 “읽지 못했어요. 받은 {n}개는 그대로 있어요.” |
onRetry? | () => void | — | 슬롯 action은 “다시 시도” 하나로 고정. 0개나 2개 이상은 허용하지 않는다. |
announceOnMount? | boolean | false | 처음 나타날 때 polite 한 번. ImportProgress가 이미 “일부 실패”를 알렸으면 끈다(디듀프). |
onAnnounce? | (message: string, politeness: 'polite' | 'assertive') => void | — | 공용 알림기(기본 announce()). |
| 그 밖의 속성 | — | — | <div role="group"> 속성(id, aria-*)이 전달된다. |
접근성
키보드: “다시 시도” Tab·Enter. 성공하면 행이 사라지므로 호출자가 목록 제목으로 초점을 옮긴다. 실패하면 행과 버튼 초점이 유지된다.
- role="group"의 이름은 문장 전체. 아이콘은 aria-hidden.