Skip to content
Material Design 1
Main Navigation
v3
v2
v1

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

외관

Sidebar Navigation

Material Design

환경

Material 속성

높이(Elevation) 및 그림자

새로운 소식

모션

Material 모션

지속 시간 & 이징

움직임

Material 변형

코레오그래피

크리에이티브 커스터마이징

스타일

색상

아이콘

이미지

타이포그래피(Typography)

글쓰기 (Writing)

레이아웃

원칙

단위와 치수

메트릭스와 키라인

구조

반응형 UI

분할 화면

컴포넌트

하단 내비게이션

바텀 시트

버튼

버튼: 플로팅 작업 버튼

카드

칩

데이터 표

대화상자

구분선

확장 패널

그리드 목록

목록

목록: 컨트롤

메뉴

선택기

진행률 및 활동

선택 컨트롤

슬라이더

스낵바(Snackbars) 및 토스트(Toasts)

스테퍼

서브헤더

탭

텍스트 필드

툴바

툴팁

위젯

패턴

확인(Confirmation) & 알려주기(Acknowledgement)

데이터 형식

빈 상태 (Empty states)

오류

지문(Fingerprint)

제스처

도움말 및 피드백

런치 스크린

이미지 로딩

탐색

탐색 창 (Navigation drawer)

내비게이션 전환

알림

오프라인 상태

권한

스크롤링 기법

검색

선택

설정

당겨서 새로고침(Swipe to refresh)

성장 및 커뮤니케이션

소개

온보딩

기능 탐색

제스처 교육

사용성

접근성

양방향성(Bidirectionality)

플랫폼

플랫폼 대응

Android

리소스

색상 팔레트

기기

레이아웃 템플릿

Roboto & Noto 글꼴

스티커 시트 및 아이콘

그림자

이 페이지에서

오류 ​

앱이 기대한 작업을 완료하지 못하면 오류가 발생합니다.

오류의 몇 가지 예는 다음과 같습니다:

  • 앱이 사용자 입력을 이해하지 못할 때
  • 앱 로드에 실패할 때
  • 서로 호환되지 않는 작업이 동시에 실행될 때
오류의 유형

사용자 입력 오류
앱 오류
호환되지 않는 상태 오류


구체적인 오류 패턴

폼
일반 사용 오류
동기화 오류
네트워크 연결
권한

Material Design의 앱 작업 오류

사용법 ​

앱이 작업을 완료하지 못할 때 오류가 발생합니다. 예를 들면 다음과 같습니다:

  • 앱이 사용자 입력을 이해하지 못할 때
  • 시스템 또는 앱 자체에 오류가 발생할 때
  • 사용자가 서로 호환되지 않는 작업을 동시에 실행하려고 할 때

사용자가 정보를 자유롭게 입력할 수 있도록 앱을 설계하면 오류 발생을 최소화할 수 있습니다. 이를 위해 앱은 일반적인 데이터 형식을 수용하고, 어포던스를 활용해 사용자의 이해를 도와야 합니다.

오류를 처리할 때는 다음을 따르세요:

  • 지금 무슨 일이 일어나고 있는지 명확하게 전달하세요
  • 사용자가 오류를 해결할 수 있는 방법을 안내하세요
  • 사용자가 입력한 내용은 최대한 보존하세요

사용자 입력 오류 ​

입력 오류가 감지되면 즉시 사용자가 수정할 수 있도록 안내하세요. 제출 전에 오류를 감지할 수 있다면 폼 제출을 비활성화하고, 제출 후에만 감지할 수 있는 오류라면 오류 내용과 수정 방법을 명확하게 설명하세요.

텍스트 필드 입력

도움말 텍스트는 사용자가 폼의 각 필드와 상호작용하기 전, 도중 또는 후에 표시할 수 있습니다.

오류 텍스트는 사용자가 필드와 상호작용한 후에만 표시하세요. 사용자가 잘못된 데이터를 입력하면 도움말 텍스트가 오류 텍스트로 대체될 수 있습니다.

폼 텍스트는 필수적인 내용만 담아 최소화하세요. 모든 텍스트 필드에 도움말 텍스트나 오류 텍스트가 필요한 것은 아닙니다.

사양:

텍스트 필드 사이와 오류 텍스트 아래에는 세로 16dp의 간격을 두세요.

Material Design 텍스트 필드 입력 예시
텍스트 필드 입력 예시
오류 메시지가 표시된 Material Design 텍스트 필드 입력
오류 텍스트가 표시된 텍스트 필드 입력 예시

폼 제출

제출(Submit) 버튼은 기본적으로 활성화 상태여야 합니다.

인라인 폼 유효성 검사를 수행하는 경우, 오류가 있는 필드가 명확하게 표시되어 있다면 오류가 수정될 때까지 제출 버튼을 비활성화할 수 있습니다.

색상

오류 텍스트는 제품의 컬러 팔레트를 반영해야 합니다. 오류 상태에는 빨간색이나 주황색처럼 따뜻한 색조로서 배경과 대비되는 색상을 사용하는 것이 좋습니다.

오류 텍스트는 배경색과 뚜렷한 대비를 이루어야 가독성을 확보할 수 있습니다.

webaim.org와 같은 사이트에서 색상 대비 검사 도구를 제공합니다.

밝은 배경용 글꼴

  • 오류: Roboto Regular 12sp
  • 힌트 및 도움말 텍스트: 불투명도 38%의 #000000
다양한 텍스트 상태를 위한 Material Design 라이트 테마
라이트 테마의 각 상태: 힌트 텍스트가 있는 일반 상태, 오류 텍스트가 있는 일반 상태, 도움말 텍스트가 있는 일반 상태, 도움말 텍스트가 오류 텍스트로 바뀐 일반 상태

어두운 배경용 글꼴

  • 오류: Roboto Regular 12sp
  • 힌트 및 도움말 텍스트: 불투명도 50%의 #FFFFFF
정상 및 오류 상태를 위한 Material Design 다크 테마
다크 테마의 각 상태: 힌트 텍스트가 있는 일반 상태, 오류 텍스트가 있는 일반 상태, 도움말 텍스트가 있는 일반 상태, 도움말 텍스트가 오류 텍스트로 바뀐 일반 상태

도움말 및 오류 텍스트

Material Design의 도움말 텍스트 예시
도움말 텍스트가 있는 예시
오류 텍스트가 있는 Material Design 예시
오류 텍스트가 있는 예시
Material Design의 도움말 텍스트 예시
도움말 텍스트가 있는 예시
오류 텍스트를 보여 주는 Material Design 예시
오류 텍스트가 있는 예시
도움말 텍스트와 오류 텍스트가 있는 Material Design 정상 상태
도움말 텍스트가 있는 일반 상태와 도움말 텍스트 및 오류 텍스트가 있는 일반 상태의 예시
Material Design 입력 및 오류 텍스트 예시
입력 텍스트와 오류 텍스트

타일 높이: 64dp
입력 텍스트 위쪽 패딩: 16dp
입력 텍스트 아래쪽 패딩: 8dp
오류 텍스트 위아래 패딩: 4dp

플로팅 텍스트 레이블의 오류 표시

입력 필드가 있는 Material Design 플로팅 텍스트 레이블
입력 텍스트가 있는 플로팅 텍스트 레이블 예시
오류 메시지가 있는 Material Design 플로팅 텍스트 레이블
오류 텍스트가 표시된 플로팅 텍스트 레이블 예시
Material Design: 정상 및 오류 입력 예시
힌트 텍스트/레이블이 있는 일반 상태와 입력 텍스트·레이블·오류가 있는 일반 상태의 예시
Material Design의 플로팅 텍스트 레이블 사양
플로팅 텍스트 레이블의 사양

타일 높이: 80dp
레이블 텍스트 위쪽 패딩: 8dp
입력 텍스트 위아래 패딩: 8dp
오류 텍스트 위아래 패딩: 4dp

텍스트 필드 입력 - 글자 또는 단어 수 초과/미달 ​

글자 수 카운터는 사용자가 필드와 상호작용하기 전, 도중 또는 후에 표시할 수 있습니다. 사용자가 글자 수 제한에 근접하기 전까지는 카운터를 표시하지 않는 방법도 고려해 보세요.

  • 카운터 글꼴: Roboto Regular 12sp
  • 카운터 필드에는 하단에 16dp의 추가 패딩을 적용합니다

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

글자 수 카운터가 있는 Material Design 한 줄 입력란
글자 수 카운터와 사용자 입력 텍스트가 있는 한 줄 입력 레이블 예시
글자 수 카운터가 있는 Material Design 한 줄 입력란
글자 수 카운터와 오류 텍스트가 있는 한 줄 입력 레이블 예시

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

글자 수 카운터가 있는 Material Design 여러 줄 입력란
글자 수 카운터와 사용자 입력 텍스트가 있는 여러 줄 입력 레이블 예시
카운터와 오류가 있는 Material Design 여러 줄 입력란
글자 수 카운터와 오류 텍스트가 있는 여러 줄 입력 레이블 예시
사용자 텍스트와 오류 텍스트 예시가 있는 Material Design 입력 상태
각 상태의 예시: 사용자 입력 텍스트가 있는 한 줄 입력 레이블, 오류 텍스트가 있는 한 줄 입력 레이블, 사용자 입력 텍스트가 있는 여러 줄 입력 레이블, 오류 텍스트가 있는 여러 줄 입력 레이블
Material Design 텍스트 필드 입력
텍스트 필드 입력

전체 입력 영역의 높이: 88dp
한 줄 입력 레이블의 상단 패딩: 16dp
한 줄 필드의 입력 텍스트 위아래 패딩: 8dp
카운터 위쪽 패딩: 8dp

호환되지 않는 값

사용자가 텍스트 필드와 상호작용하는 도중이나 이후에 호환되지 않는 값에 대한 오류를 표시하세요.

두 개 이상의 필드에 호환되지 않는 입력이 있는 경우:

  • 해당 텍스트 필드에 수정이 필요하다는 표시를 하고, 그 아래에 오류 메시지를 추가하세요.
  • 폼 또는 화면 상단에 필요한 수정 사항과 추가 설명을 요약한 메시지를 표시하세요.

폼 제출 시 감지되는 오류

폼을 다시 로드하면서 통합된 오류 메시지를 표시하고, 스크롤 위치를 최상단으로 이동하세요. 개별 필드의 오류는 사용자가 폼을 작성하는 과정에서 해소될 수 있습니다.

Material Design 양식 예시
폼 예시
Material Design: 양식 제출 오류 예시
폼 제출 시도 후 감지된 오류 예시

미완성 폼

비어 있는 폼 필드는 텍스트 필드 자체와 그 아래의 오류 메시지 양쪽으로 표시해야 합니다.

사용자가 폼 작성 중 필드를 건너뛴 경우를 알리기 위해 미완성 폼 오류를 표시하세요. 폼에서 사용자의 진행 상황을 감지할 수 없다면, 사용자가 폼 제출을 시도한 후에 오류를 표시하세요.

폼 제출 전 여러 개의 오류

사용자가 폼을 작성해 가는 동안에는 오류 메시지를 각 필드별로 개별 표시하세요.

Material Design 양식 예시
폼 예시
작성이 완료되지 않은 양식의 Material Design 예시
미완성 폼 예시

한 줄 목록 오류

Material Design의 한 줄 목록 오류 예시
한 줄 목록 오류 예시

앱 오류 ​

앱 오류는 사용자 입력과 무관하게 발생합니다.

일반 앱 오류

오류가 발생하면 오류 메시지가 나타날 때까지 로딩 인디케이터를 표시하세요.

사용할 수 없는 기능은 UI에서 비활성화 상태로 표시할 수 있습니다. 예를 들어 버튼을 비활성화 상태로 표시하고, 사용할 수 없다는 설명 텍스트를 함께 보여줄 수 있습니다. 모든 오류에 새로운 컴포넌트를 띄울 필요는 없습니다.

가능하다면 사용자가 오류를 해결하는 데 도움이 되는 작업을 제공하세요.

앱 오류 피드백을 위한 Material Design 알림 대화상자
얼럿 대화상자(Alert dialog): 정상 작동을 방해하는 오류에 대한 앱 피드백
오류에 대한 앱 피드백을 위한 Material Design 스낵바
스낵바(Snackbar): 경미한 오류에 대한 앱 피드백을 표시합니다. 스낵바는 일시적이므로 중요하거나 지속적이거나 대량으로 발생하는 오류에는 사용하지 마세요.

동기화 오류 / 로드 실패

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

로딩 실패 시 Material Design 빈 상태
로드에 실패한 화면/콘텐츠의 빈 상태
작업이 있는 Material Design 컴포넌트 오류
작업(action)이 포함된 컨테이너/컴포넌트별 오류

네트워크 연결

네트워크 연결이 끊어진 경우에도, 사용자가 앱의 나머지 부분을 최대한 많이 사용할 수 있도록 해야 합니다.

적절하다면 사용자가 작업을 완수할 수 있도록 돕는 링크를 제공하세요. 단, 실제로 지원할 수 있는 링크만 제공하세요. 예를 들어 작업이 실패할 것임을 미리 감지할 수 있는 경우에는 "다시 시도"와 같은 옵션을 제공하지 마세요.

다시 시도 작업이 있는 Material Design 스낵바
다시 시도 작업이 포함된 스낵바
온라인 전용 화면의 Material Design 빈 상태
온라인에서만 사용할 수 있는 화면의 빈 상태

호환되지 않는 상태 오류 ​

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

일반적인 비호환성

오류의 원인과 출처를 명확히 설명하세요.

예를 들어 제한 모드에서는 스크린샷과 프리미엄 기능을 사용할 수 없습니다.

특별 모드 표시기가 있는 Material Design 스낵바
스낵바 + 특수 모드 인디케이터

사용자가 선택한 오프라인

사용자가 오프라인 상태에서 온라인 연결이 필요한 작업을 수행하려고 할 때는, 방해가 되지 않는 지속적인 인디케이터를 표시하세요.

예시:

  • 비행기 모드에서 전화 걸기
  • 오프라인 상태에서 이용 가능한 음악
Material Design 스낵바
스낵바
Material Design 비행기 모드 표시기
기기가 비행기 모드로 전환되었음을 알리는 인디케이터.

권한 요청

앱이 작업을 진행하기 전에 사용자 권한이 필요한 경우, 이를 오류로 취급하지 말고 앱 흐름 안에 권한 요청을 포함시키세요.

앱을 처음 실행하기 전에 권한이 필요한 경우, 앱의 첫 실행 경험에 이를 포함시키는 것을 고려하세요.

예시:

  • 앱의 권한이 변경된 경우
  • 인앱 결제가 비활성화된 경우
Material Design 대화상자
대화상자
Pager
이전빈 상태 (Empty states)
다음지문(Fingerprint)

Apache-2.0 라이선스 하에 배포되었습니다.

Copyright © 2014-Present Google

https://m1.material.io/patterns/errors.html

Apache-2.0 라이선스 하에 배포되었습니다.

Copyright © 2014-Present Google