Progress Ring
진행 링
측정 가능한 작업이 얼마나 끝났는지 보여주는 동그라미예요.
실제 예시
다운로드하는 동안 파일 아이콘을 감싸는 고리가 0%에서 100%까지 차올라요. 보조 기술에도 정확한 숫자가 전달돼요.
주요 부분
- 01State signal
- 02Human-readable message
- 03Timing or progress
- 04Recovery path
사용할 때
측정 가능한 진행 상황에 수평 공간이 거의 없을 때 사용하세요. 작은 객체에 연결된 진행 상황에도 적합합니다.
다음 경우에는 사용하지 마세요
대기 시간이 알려지지 않은 상태에서 빈 링을 돌리지 마세요. 그것은 스피너이지 진행 링이 아닙니다.
코드에서 사용된 이름
role=progressbar + aria-valuenow + SVG circle 출시하기 전에
Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states.
Outcome：Complete the task with 진행 링 (Progress Ring)。 User context：다운로드하는 동안 파일 아이콘을 감싸는 고리가 0%에서 100%까지 차올라요. 보조 기술에도 정확한 숫자가 전달돼요. Recommended pattern：진행 링 (Progress Ring)。 Why it fits：측정 가능한 진행 상황에 수평 공간이 거의 없을 때 사용하세요. 작은 객체에 연결된 진행 상황에도 적합합니다. Do not use it when：대기 시간이 알려지지 않은 상태에서 빈 링을 돌리지 마세요. 그것은 스피너이지 진행 링이 아닙니다. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary)：하나의 공식 표준이 전체 용어를 통제하지 않음. 의미는 팀, 플랫폼 또는 프레임워크마다 달라질 수 있음. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
이 요청을 확인하세요
Review how 진행 링 (Progress Ring) is used now. Definition: 측정 가능한 작업이 얼마나 끝났는지 보여주는 동그라미예요. Release checks: Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.