오류
앱이 기대한 작업을 완료하지 못하면 오류가 발생합니다.
오류의 몇 가지 예는 다음과 같습니다:
- 앱이 사용자 입력을 이해하지 못할 때
- 앱 로드에 실패할 때
- 서로 호환되지 않는 작업이 동시에 실행될 때
오류의 유형
사용자 입력 오류
앱 오류
호환되지 않는 상태 오류
구체적인 오류 패턴
폼
일반 사용 오류
동기화 오류
네트워크 연결
권한

사용법
앱이 작업을 완료하지 못할 때 오류가 발생합니다. 예를 들면 다음과 같습니다:
- 앱이 사용자 입력을 이해하지 못할 때
- 시스템 또는 앱 자체에 오류가 발생할 때
- 사용자가 서로 호환되지 않는 작업을 동시에 실행하려고 할 때
사용자가 정보를 자유롭게 입력할 수 있도록 앱을 설계하면 오류 발생을 최소화할 수 있습니다. 이를 위해 앱은 일반적인 데이터 형식을 수용하고, 어포던스를 활용해 사용자의 이해를 도와야 합니다.
오류를 처리할 때는 다음을 따르세요:
- 지금 무슨 일이 일어나고 있는지 명확하게 전달하세요
- 사용자가 오류를 해결할 수 있는 방법을 안내하세요
- 사용자가 입력한 내용은 최대한 보존하세요
사용자 입력 오류
입력 오류가 감지되면 즉시 사용자가 수정할 수 있도록 안내하세요. 제출 전에 오류를 감지할 수 있다면 폼 제출을 비활성화하고, 제출 후에만 감지할 수 있는 오류라면 오류 내용과 수정 방법을 명확하게 설명하세요.
텍스트 필드 입력
도움말 텍스트는 사용자가 폼의 각 필드와 상호작용하기 전, 도중 또는 후에 표시할 수 있습니다.
오류 텍스트는 사용자가 필드와 상호작용한 후에만 표시하세요. 사용자가 잘못된 데이터를 입력하면 도움말 텍스트가 오류 텍스트로 대체될 수 있습니다.
폼 텍스트는 필수적인 내용만 담아 최소화하세요. 모든 텍스트 필드에 도움말 텍스트나 오류 텍스트가 필요한 것은 아닙니다.
사양:
텍스트 필드 사이와 오류 텍스트 아래에는 세로 16dp의 간격을 두세요.


폼 제출
제출(Submit) 버튼은 기본적으로 활성화 상태여야 합니다.
인라인 폼 유효성 검사를 수행하는 경우, 오류가 있는 필드가 명확하게 표시되어 있다면 오류가 수정될 때까지 제출 버튼을 비활성화할 수 있습니다.
색상
오류 텍스트는 제품의 컬러 팔레트를 반영해야 합니다. 오류 상태에는 빨간색이나 주황색처럼 따뜻한 색조로서 배경과 대비되는 색상을 사용하는 것이 좋습니다.
오류 텍스트는 배경색과 뚜렷한 대비를 이루어야 가독성을 확보할 수 있습니다.
webaim.org와 같은 사이트에서 색상 대비 검사 도구를 제공합니다.
밝은 배경용 글꼴
- 오류: Roboto Regular 12sp
- 힌트 및 도움말 텍스트: 불투명도 38%의 #000000

어두운 배경용 글꼴
- 오류: Roboto Regular 12sp
- 힌트 및 도움말 텍스트: 불투명도 50%의 #FFFFFF

도움말 및 오류 텍스트






타일 높이: 64dp
입력 텍스트 위쪽 패딩: 16dp
입력 텍스트 아래쪽 패딩: 8dp
오류 텍스트 위아래 패딩: 4dp
플로팅 텍스트 레이블의 오류 표시




타일 높이: 80dp
레이블 텍스트 위쪽 패딩: 8dp
입력 텍스트 위아래 패딩: 8dp
오류 텍스트 위아래 패딩: 4dp
텍스트 필드 입력 - 글자 또는 단어 수 초과/미달
글자 수 카운터는 사용자가 필드와 상호작용하기 전, 도중 또는 후에 표시할 수 있습니다. 사용자가 글자 수 제한에 근접하기 전까지는 카운터를 표시하지 않는 방법도 고려해 보세요.
- 카운터 글꼴: Roboto Regular 12sp
- 카운터 필드에는 하단에 16dp의 추가 패딩을 적용합니다
글자 수 카운터가 있는 한 줄 입력


글자 수 카운터가 있는 여러 줄 입력




전체 입력 영역의 높이: 88dp
한 줄 입력 레이블의 상단 패딩: 16dp
한 줄 필드의 입력 텍스트 위아래 패딩: 8dp
카운터 위쪽 패딩: 8dp
호환되지 않는 값
사용자가 텍스트 필드와 상호작용하는 도중이나 이후에 호환되지 않는 값에 대한 오류를 표시하세요.
두 개 이상의 필드에 호환되지 않는 입력이 있는 경우:
- 해당 텍스트 필드에 수정이 필요하다는 표시를 하고, 그 아래에 오류 메시지를 추가하세요.
- 폼 또는 화면 상단에 필요한 수정 사항과 추가 설명을 요약한 메시지를 표시하세요.
폼 제출 시 감지되는 오류
폼을 다시 로드하면서 통합된 오류 메시지를 표시하고, 스크롤 위치를 최상단으로 이동하세요. 개별 필드의 오류는 사용자가 폼을 작성하는 과정에서 해소될 수 있습니다.


미완성 폼
비어 있는 폼 필드는 텍스트 필드 자체와 그 아래의 오류 메시지 양쪽으로 표시해야 합니다.
사용자가 폼 작성 중 필드를 건너뛴 경우를 알리기 위해 미완성 폼 오류를 표시하세요. 폼에서 사용자의 진행 상황을 감지할 수 없다면, 사용자가 폼 제출을 시도한 후에 오류를 표시하세요.
폼 제출 전 여러 개의 오류
사용자가 폼을 작성해 가는 동안에는 오류 메시지를 각 필드별로 개별 표시하세요.


한 줄 목록 오류

앱 오류
앱 오류는 사용자 입력과 무관하게 발생합니다.
일반 앱 오류
오류가 발생하면 오류 메시지가 나타날 때까지 로딩 인디케이터를 표시하세요.
사용할 수 없는 기능은 UI에서 비활성화 상태로 표시할 수 있습니다. 예를 들어 버튼을 비활성화 상태로 표시하고, 사용할 수 없다는 설명 텍스트를 함께 보여줄 수 있습니다. 모든 오류에 새로운 컴포넌트를 띄울 필요는 없습니다.
가능하다면 사용자가 오류를 해결하는 데 도움이 되는 작업을 제공하세요.


동기화 오류 / 로드 실패
동기화가 중단되었거나 콘텐츠 로드에 실패한 경우에도, 사용자가 앱의 나머지 부분을 최대한 많이 사용할 수 있도록 해야 합니다.


네트워크 연결
네트워크 연결이 끊어진 경우에도, 사용자가 앱의 나머지 부분을 최대한 많이 사용할 수 있도록 해야 합니다.
적절하다면 사용자가 작업을 완수할 수 있도록 돕는 링크를 제공하세요. 단, 실제로 지원할 수 있는 링크만 제공하세요. 예를 들어 작업이 실패할 것임을 미리 감지할 수 있는 경우에는 "다시 시도"와 같은 옵션을 제공하지 마세요.


호환되지 않는 상태 오류
호환되지 않는 상태 오류는 사용자가 서로 충돌하는 작업을 실행하려고 할 때 발생합니다. 예를 들어 비행기 모드에서 전화를 걸거나, 제한된 회사 계정에서 스크린샷을 찍는 경우입니다. 사용자가 선택한 상태와 그 상태가 나머지 사용 경험에 미치는 영향을 명확하게 전달하여, 사용자가 이러한 상황에 스스로 빠지지 않도록 도와주세요. 이러한 오류가 발생했을 때 사용자 잘못이라는 인상을 주어서는 안 됩니다.
일반적인 비호환성
오류의 원인과 출처를 명확히 설명하세요.
예를 들어 제한 모드에서는 스크린샷과 프리미엄 기능을 사용할 수 없습니다.

사용자가 선택한 오프라인
사용자가 오프라인 상태에서 온라인 연결이 필요한 작업을 수행하려고 할 때는, 방해가 되지 않는 지속적인 인디케이터를 표시하세요.
예시:
- 비행기 모드에서 전화 걸기
- 오프라인 상태에서 이용 가능한 음악


권한 요청
앱이 작업을 진행하기 전에 사용자 권한이 필요한 경우, 이를 오류로 취급하지 말고 앱 흐름 안에 권한 요청을 포함시키세요.
앱을 처음 실행하기 전에 권한이 필요한 경우, 앱의 첫 실행 경험에 이를 포함시키는 것을 고려하세요.
예시:
- 앱의 권한이 변경된 경우
- 인앱 결제가 비활성화된 경우
