Progressbar
진행 표시줄
진행 표시줄은 시간 제한이 있는 작업의 완료 정도를 보여줍니다. 사람들은 이를 읽을 수 있지만 직접 제어하지는 않습니다.
실제 예시
2.4GB 파일이 업로드되는 동안, 진행 표시줄은 “업로드, 68퍼센트”라고 알리고 유용할 때만 업데이트합니다. 서버가 파일을 확인하는 동안 알려지지 않은 크기를 보여줍니다. 취소는 별도의 버튼으로 남아 있습니다.
주요 부분
- 01작업 라벨
- 02추적 및 채우기
- 03현재 값
사용할 때
전체 작업량을 알 수 있을 때 숫자를 표시합니다. 알 수 없는 경우 해당 상태를 표시하고 현재 진행 중인 작업을 설명합니다.
다음 경우에는 사용하지 마세요
진행 표시줄을 포커스 가능하거나 조정 가능하게 만들지 마세요. 사용자가 값을 제어할 때는 슬라이더를 사용하세요.
코드에서 사용된 이름
role=progressbar with aria-valuemin/max/now and accessible name 출시하기 전에
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 진행 표시줄 (Progressbar)。 User context：2.4GB 파일이 업로드되는 동안, 진행 표시줄은 “업로드, 68퍼센트”라고 알리고 유용할 때만 업데이트합니다. 서버가 파일을 확인하는 동안 알려지지 않은 크기를 보여줍니다. 취소는 별도의 버튼으로 남아 있습니다. Recommended pattern：진행 표시줄 (Progressbar)。 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)：이 표준은 나열된 범위만 적용합니다. 시각적 스타일, 제품 결정, 또는 Vibulary 예시는 선택하지 않습니다. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
이 요청을 확인하세요
Review how 진행 표시줄 (Progressbar) 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.