Skip to content
Material Design 3
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

기초

접근성

개요: 원칙

개요: 보조 기술

디자인: 개요

디자인: 색상 대비

디자인: 구조

디자인: 플로우

디자인: 요소

문구 작성과 텍스트: 모범 사례

글쓰기 및 텍스트: 텍스트 잘림

글쓰기 및 텍스트: 텍스트 크기 조정

모두를 위한 제품 만들기: 사용자 요구

모두를 위한 만들기: 공동 디자인

콘텐츠 디자인

개요

대체 텍스트

글로벌 글쓰기: 개요

글로벌 글쓰기: 단어 선택

알림

스타일 가이드: UX 라이팅 모범 사례

스타일 가이드: 단어 선택

스타일 가이드: 문법 및 구두점

Material 맞춤 설정

기기

워치용 디자인: 개요

워치 디자인: 기초

워치 디자인: 스타일

워치용 디자인: 레이아웃

XR

몰입형 XR을 위한 디자인: 개요

몰입형 XR 디자인: 상호작용

몰입형 XR 디자인: 레이아웃

몰입형 XR 디자인: 접근성

XR 컴포넌트: 개요

XR 컴포넌트: 앱 바

XR 컴포넌트: 대화상자

XR 컴포넌트: 내비게이션 바

XR 구성요소: 탐색 레일

XR 컴포넌트: 툴바

디자인 토큰: 개요

디자인 토큰: 토큰 사용 방법

상호작용

제스처

입력: 기초

선택: 개요

상태: 개요

상태: 상태 레이어

상태: 상태 적용

레이아웃

레이아웃 개요: 개요

레이아웃 개요: 레이아웃의 컴포넌트

레이아웃 개요: 적응형 디자인

스캐폴드: 개요

스캐폴드: 바

스캐폴드: 레일

스캐폴드: 페인

그리드와 간격: 개요

그리드 및 간격: 그리드

그리드 및 간격: 간격

그리드 및 간격: 밀도

브레이크포인트: 개요

브레이크포인트: 컴팩트

브레이크포인트: 중간

브레이크포인트: 확장형

브레이크포인트: 대형 및 초대형

양방향성 및 RTL

표준 레이아웃 예제: 개요

표준 레이아웃 예제: 피드

표준 레이아웃 예제: 목록-세부 정보

표준 레이아웃 예제: 보조 패널

사용성: 개요

사용성: M3 Expressive 적용

Material A-Z

스타일

색상

색상 시스템: 개요

색상 시스템: 작동 방식

색상 역할

색상 구성표

색상 구성표 선택

정적 색상 구성표: 기준선

정적 색상 구성표: 사용자 지정 브랜드

동적 색상 구성표: 소스 선택

동적 색상 구성표: 사용자 생성 소스

동적 색상 구성표: 콘텐츠 기반 소스

고급 사용자 지정: 개요

고급 사용자 지정: 색상 적용

고급 사용자 지정: 새 색상 정의

고급 사용자 지정: 기존 색상 조정

색상 리소스

엘리베이션: 개요

엘리베이션: 엘리베이션 적용

엘리베이션: 토큰

아이콘: 개요

아이콘: 아이콘 디자인

아이콘: 적용 방법

모션

모션 물리 시스템: 작동 방식

모션 물리 시스템: 명세

이징과 지속 시간: 이징과 지속 시간 적용

이징과 지속 시간: 토큰 및 사양

전환: 전환 패턴

전환: 전환 적용하기

모양: 개요 및 원칙

모양: 모서리 반경 스케일

모양: 모양 모핑

간격: 개요

간격: 간격 적용

간격: 토큰

타이포그래피: 개요

타이포그래피: 글꼴

타이포그래피: 타입 스케일 및 토큰

타이포그래피: 타입 적용

타이포그래피: 에디토리얼 트리트먼트

컴포넌트

앱 바: 개요

앱 바: 사양

앱 바: 가이드라인

앱 바: 접근성

배지: 개요

배지: 사양

배지: 가이드라인

배지: 접근성

버튼

모든 버튼

버튼 그룹: 개요

버튼 그룹: 사양

버튼 그룹: 가이드라인

버튼 그룹: 접근성

버튼: 개요

버튼: 사양

버튼: 가이드라인

버튼: 접근성

확장 FAB: 개요

확장 FAB: 사양

확장 FAB: 가이드라인

확장 FAB: 접근성

FAB 메뉴: 개요

FAB 메뉴: 사양

FAB 메뉴: 가이드라인

FAB 메뉴: 접근성

플로팅 작업 버튼 (FAB)(FAB): 개요

플로팅 작업 버튼 (FAB)(FAB): 사양

플로팅 작업 버튼 (FAB)(FAB): 가이드라인

플로팅 작업 버튼 (FAB)(FAB): 접근성

아이콘 버튼: 개요

아이콘 버튼: 사양

아이콘 버튼: 가이드라인

아이콘 버튼: 접근성

세그먼트 버튼: 개요

세그먼트 버튼: 사양

세그먼트 버튼: 가이드라인

세그먼트 버튼: 접근성

분할 버튼: 개요

분할 버튼: 사양

분할 버튼: 가이드라인

분할 버튼: 접근성

카드: 개요

카드: 사양

카드: 가이드라인

카드: 접근성

캐러셀: 개요

캐러셀: 사양

캐러셀: 가이드라인

캐러셀: 접근성

체크박스: 개요

체크박스: 사양

체크박스: 가이드라인

체크박스: 접근성

칩: 개요

칩: 사양

칩: 가이드라인

칩: 접근성

날짜 및 시간 선택기

날짜 선택기: 개요

날짜 선택기: 사양

날짜 선택기: 가이드라인

날짜 선택기: 접근성

시간 선택기: 개요

시간 선택기: 사양

시간 선택기: 가이드라인

시간 선택기: 접근성

대화상자: 개요

대화상자: 사양

대화상자: 가이드라인

대화상자: 접근성

구분선: 개요

구분선: 사양

구분선: 가이드라인

구분선: 접근성

목록: 개요

목록: 사양

목록: 가이드라인

목록: 접근성

로딩 및 진행 상태

로딩 표시기: 개요

로딩 표시기: 사양

로딩 표시기: 가이드라인

로딩 표시기: 접근성

진행 표시기: 개요

진행 표시기: 사양

진행 표시기: 가이드라인

진행 표시기: 접근성

메뉴: 개요

메뉴: 사양

메뉴: 가이드라인

메뉴: 접근성

내비게이션

내비게이션 바: 개요

내비게이션 바: 사양

내비게이션 바: 가이드라인

내비게이션 바: 접근성

내비게이션 드로어: 개요

내비게이션 드로어: 사양

내비게이션 드로어: 가이드라인

내비게이션 드로어: 접근성

탐색 레일: 개요

탐색 레일: 사양

탐색 레일: 가이드라인

탐색 레일: 접근성

라디오 버튼: 개요

라디오 버튼: 사양

라디오 버튼: 가이드라인

라디오 버튼: 접근성

검색: 개요

검색: 사양

검색: 가이드라인

검색: 접근성

시트

바텀 시트: 개요

바텀 시트: 사양

바텀 시트: 가이드라인

바텀 시트: 접근성

측면 시트: 개요

측면 시트: 사양

측면 시트: 가이드라인

측면 시트: 접근성

슬라이더: 개요

슬라이더: 사양

슬라이더: 가이드라인

슬라이더: 접근성

스낵바: 개요

스낵바: 사양

스낵바: 가이드라인

스낵바: 접근성

스위치: 개요

스위치: 사양

스위치: 가이드라인

스위치: 접근성

탭: 개요

탭: 사양

탭: 가이드라인

탭: 접근성

텍스트 필드: 개요

텍스트 필드: 사양

텍스트 필드: 가이드라인

텍스트 필드: 접근성

툴바: 개요

툴바: 사양

툴바: 가이드라인

툴바: 접근성

툴팁: 개요

툴팁: 사양

툴팁: 가이드라인

툴팁: 접근성

이 페이지에서

텍스트 필드: 사양 ​

텍스트 필드를 사용하면 사용자가 UI에 텍스트를 입력할 수 있습니다.

토큰 및 사양 ​

컴포넌트의 요소, 속성, 토큰 및 값을 살펴보세요. 디자인 토큰에 대해 알아보기

텍스트 필드 - 채워진 ​

테마
대비

텍스트 필드 - 아웃라인 ​

테마
대비

채워진 텍스트 필드 ​

채워진 텍스트 필드를 구성하는 10개 부분을 보여주는 다이어그램.
  1. 컨테이너
  2. 선행 아이콘(선택 사항)
  3. 비어 있는 필드의 레이블 텍스트
  4. 입력된 필드의 레이블 텍스트
  5. 후행 아이콘(선택 사항)
  6. 활성 표시기(포커스됨)
  7. 캐럿
  8. 입력 텍스트
  9. 보조 텍스트(선택 사항)
  10. 활성 표시기(활성화됨)

채워진 텍스트 필드 색상 ​

색상 값은 디자인 토큰디자인 토큰은 모든 UI 요소의 기본 구성 단위입니다. 동일한 토큰이 디자인, 도구, 코드에서 사용됩니다.토큰 자세히 알아보기으로 구현됩니다. 즉, 디자인에서는 토큰에 대응하는 색상 값을 사용하고, 구현에서는 색상 값이 값을 참조하는 토큰이 됩니다. 디자인 토큰 자세히 알아보기

채워진 텍스트 필드의 색상 매핑을 보여주는 다이어그램.

라이트 및 다크 모드에 사용되는 채워진 텍스트 필드 색상 역할:

  1. 표면 컨테이너 가장 높음
  2. 표면 변형 위
  3. 표면 변형 위
  4. 기본
  5. 표면 변형 위
  6. 기본
  7. 기본
  8. 표면 위
  9. 표면 변형 위
  10. 표면 위

채워진 텍스트 필드 상태 ​

상태는 컴포넌트나 상호작용 요소의 현재 상황을 시각적으로 표현한 것입니다. 상호작용 상태 자세히 알아보기

다양한 상태에서 비어 있는 필드와 입력된 필드의 채워진 텍스트 필드를 나란히 보여주며, 활성화됨, 포커스됨, 호버됨, 비활성화됨의 차이를 나타냅니다.
  1. 활성화됨(비어 있는 필드)
  2. 포커스됨(비어 있는 필드)
  3. 호버됨(비어 있는 필드)
  4. 비활성화됨(비어 있는 필드)
  5. 활성화됨(입력된 필드)
  6. 포커스됨(입력된 필드)
  7. 호버됨(입력된 필드)
  8. 비활성화됨(입력된 필드)

채워진 텍스트 필드 오류 상태 ​

오류 상태상태는 컴포넌트 또는 UI 요소의 상호작용 상태를 보여줍니다.상태 자세히 알아보기는 컴포넌트나 상호작용 요소의 현재 상황을 시각적으로 표현한 것입니다. 오류 메시지는 오류 해결 방법을 안내할 수 있으며, 오류가 해결될 때까지 텍스트 필드 아래에 보조 텍스트로 표시됩니다.

다양한 오류 상태에서 비어 있는 필드와 입력된 필드의 채워진 텍스트 필드를 나란히 보여주며, 활성화됨, 포커스됨, 호버됨의 차이를 나타냅니다.
  1. 활성화됨(비어 있는 필드)
  2. 포커스됨(비어 있는 필드)
  3. 호버됨(비어 있는 필드)
  4. 활성화됨(입력된 필드)
  5. 포커스됨(입력된 필드)
  6. 호버됨(입력된 필드)

채워진 텍스트 필드 측정값 ​


아이콘이 없는 채워진 텍스트 필드의 레이아웃 값과 패딩을 보여주는 다이어그램.
아이콘이 없을 때의 패딩 및 크기 측정값

선행 및 후행 아이콘이 있는 채워진 텍스트 필드의 레이아웃 값과 패딩을 보여주는 다이어그램.
아이콘이 있을 때의 패딩 및 크기 측정값

보조 텍스트의 레이아웃 값과 패딩, 그리고 보조 텍스트가 문자 수와 함께 표시된 경우를 보여주는 다이어그램.
보조 텍스트와 문자 수가 있을 때의 패딩 및 크기 측정값

속성값
기본 컨테이너 높이56dp
레이블 정렬(비어 있는 필드)세로 중앙 정렬
상단/하단 패딩8dp
아이콘이 없는 경우 좌측/우측 패딩16dp
아이콘이 있는 경우 좌측/우측 패딩12dp
아이콘 정렬세로 중앙 정렬
아이콘과 텍스트 사이 패딩16dp
보조 텍스트 및 문자 수 카운터 상단 패딩4dp
보조 텍스트와 문자 수 카운터 사이 패딩16dp
타깃 크기56dp

채워진 텍스트 필드 구성 ​


다양한 구성의 채워진 텍스트 필드를 나란히 비교한 그림.

다음 항목을 포함하는 채워진 텍스트 필드(비어 있는 필드 및 입력된 필드):

  1. 보조 텍스트
  2. 후행 아이콘
  3. 선행 아이콘
  4. 선행 및 후행 아이콘
  5. 접두 텍스트
  6. 접미 텍스트
  7. 여러 줄 텍스트 필드

아웃라인드 텍스트 필드 ​

아웃라인드 텍스트 필드를 구성하는 9개 부분을 보여주는 다이어그램.
  1. 컨테이너 아웃라인(활성화됨)
  2. 선행 아이콘(선택 사항)
  3. 비어 있는 필드의 레이블 텍스트
  4. 입력된 필드의 레이블 텍스트
  5. 후행 아이콘(선택 사항)
  6. 컨테이너 아웃라인(포커스됨)
  7. 캐럿
  8. 입력 텍스트
  9. 보조 텍스트(선택 사항)

아웃라인드 텍스트 필드 색상 ​

색상 값은 디자인 토큰디자인 토큰은 모든 UI 요소의 기본 구성 단위입니다. 동일한 토큰이 디자인, 도구, 코드에서 사용됩니다.토큰 자세히 알아보기으로 구현됩니다. 즉, 디자인에서는 토큰에 대응하는 색상 값을 사용하고, 구현에서는 색상 값이 값을 참조하는 토큰이 됩니다. 디자인 토큰 자세히 알아보기

아웃라인드 텍스트 필드의 색상 매핑을 보여주는 다이어그램.

라이트 및 다크 모드에 사용되는 아웃라인드 텍스트 필드 색상 역할:

  1. 아웃라인
  2. 표면 변형 위
  3. 표면 변형 위
  4. 기본
  5. 표면 변형 위
  6. 기본
  7. 기본
  8. 표면 위
  9. 표면 변형 위

아웃라인드 텍스트 필드 상태 ​

상태는 컴포넌트나 상호작용 요소의 현재 상황을 시각적으로 표현한 것입니다. 상호작용 상태 자세히 알아보기

다양한 상태에서 비어 있는 필드와 입력된 필드의 아웃라인드 텍스트 필드를 나란히 보여주며, 활성화됨, 포커스됨, 호버됨, 비활성화됨의 차이를 나타냅니다.
  1. 활성화됨(비어 있는 필드)
  2. 포커스됨(비어 있는 필드)
  3. 호버됨(비어 있는 필드)
  4. 비활성화됨(비어 있는 필드)
  5. 활성화됨(입력된 필드)
  6. 포커스됨(입력된 필드)
  7. 호버됨(입력된 필드)
  8. 비활성화됨(입력된 필드)

아웃라인드 텍스트 필드 오류 상태 ​

오류 상태상태는 컴포넌트 또는 UI 요소의 상호작용 상태를 보여줍니다.상태 자세히 알아보기는 컴포넌트나 상호작용 요소의 현재 상황을 시각적으로 표현한 것입니다. 오류 메시지는 오류 해결 방법을 안내할 수 있으며, 오류가 해결될 때까지 텍스트 필드 아래에 보조 텍스트로 표시됩니다.

다양한 오류 상태에서 비어 있는 필드와 입력된 필드의 아웃라인드 텍스트 필드를 나란히 보여주며, 활성화됨, 포커스됨, 호버됨의 차이를 나타냅니다.
  1. 활성화됨(비어 있는 필드)
  2. 포커스됨(비어 있는 필드)
  3. 호버됨(비어 있는 필드)
  4. 활성화됨(입력된 필드)
  5. 포커스됨(입력된 필드)
  6. 호버됨(입력된 필드)

아웃라인드 텍스트 필드 측정값 ​


아이콘이 없는 아웃라인드 텍스트 필드의 레이아웃 값과 패딩을 보여주는 다이어그램.
아이콘이 없을 때의 패딩 및 크기 측정값

선행 및 후행 아이콘이 있는 아웃라인드 텍스트 필드의 레이아웃 값과 패딩을 보여주는 다이어그램.
아이콘이 있을 때의 패딩 및 크기 측정값

보조 텍스트의 레이아웃 값과 패딩, 그리고 보조 텍스트가 문자 수와 함께 표시된 경우를 보여주는 다이어그램.
보조 텍스트와 문자 수가 있을 때의 패딩 및 크기 측정값

속성값
컨테이너 높이56dp
아이콘이 없는 경우 좌측/우측 패딩16dp
아이콘이 있는 경우 좌측/우측 패딩12dp
아이콘과 텍스트 사이 패딩16dp
아이콘 정렬세로 중앙 정렬
보조 텍스트 및 문자 수 카운터 상단 패딩4dp
보조 텍스트와 문자 수 카운터 사이 패딩16dp
레이블 정렬세로 중앙 정렬
입력된 필드의 레이블 텍스트 좌측/우측 패딩4dp
타깃 크기56dp

아웃라인드 텍스트 필드 구성 ​


다양한 구성의 아웃라인드 텍스트 필드를 나란히 비교한 그림.

다음 항목을 포함하는 아웃라인드 텍스트 필드(비어 있는 필드 및 입력된 필드):

  1. 보조 텍스트
  2. 후행 아이콘
  3. 선행 아이콘
  4. 선행 및 후행 아이콘
  5. 접두 텍스트
  6. 접미 텍스트
  7. 여러 줄 텍스트 필드
Pager
이전텍스트 필드: 개요
다음텍스트 필드: 가이드라인

Apache 2.0 라이선스 또는 CC BY 4.0 하에 배포되었습니다.

Copyright © 2018-Present Google

https://m3.material.io/components/text-fields/specs

Apache 2.0 라이선스 또는 CC BY 4.0 하에 배포되었습니다.

Copyright © 2018-Present Google