텍스트 필드: 사양
텍스트 필드를 사용하면 사용자가 UI에 텍스트를 입력할 수 있습니다.
토큰 및 사양
컴포넌트의 요소, 속성, 토큰 및 값을 살펴보세요. 디자인 토큰에 대해 알아보기
텍스트 필드 - 채워진
텍스트 필드 - 아웃라인
채워진 텍스트 필드

- 컨테이너
- 선행 아이콘(선택 사항)
- 비어 있는 필드의 레이블 텍스트
- 입력된 필드의 레이블 텍스트
- 후행 아이콘(선택 사항)
- 활성 표시기(포커스됨)
- 캐럿
- 입력 텍스트
- 보조 텍스트(선택 사항)
- 활성 표시기(활성화됨)
채워진 텍스트 필드 색상
색상 값은 디자인 토큰으로 구현됩니다. 즉, 디자인에서는 토큰에 대응하는 색상 값을 사용하고, 구현에서는 색상 값이 값을 참조하는 토큰이 됩니다. 디자인 토큰 자세히 알아보기

라이트 및 다크 모드에 사용되는 채워진 텍스트 필드 색상 역할:
- 표면 컨테이너 가장 높음
- 표면 변형 위
- 표면 변형 위
- 기본
- 표면 변형 위
- 기본
- 기본
- 표면 위
- 표면 변형 위
- 표면 위
채워진 텍스트 필드 상태
상태는 컴포넌트나 상호작용 요소의 현재 상황을 시각적으로 표현한 것입니다. 상호작용 상태 자세히 알아보기

- 활성화됨(비어 있는 필드)
- 포커스됨(비어 있는 필드)
- 호버됨(비어 있는 필드)
- 비활성화됨(비어 있는 필드)
- 활성화됨(입력된 필드)
- 포커스됨(입력된 필드)
- 호버됨(입력된 필드)
- 비활성화됨(입력된 필드)
채워진 텍스트 필드 오류 상태
오류 상태는 컴포넌트나 상호작용 요소의 현재 상황을 시각적으로 표현한 것입니다. 오류 메시지는 오류 해결 방법을 안내할 수 있으며, 오류가 해결될 때까지 텍스트 필드 아래에 보조 텍스트로 표시됩니다.

- 활성화됨(비어 있는 필드)
- 포커스됨(비어 있는 필드)
- 호버됨(비어 있는 필드)
- 활성화됨(입력된 필드)
- 포커스됨(입력된 필드)
- 호버됨(입력된 필드)
채워진 텍스트 필드 측정값



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

다음 항목을 포함하는 채워진 텍스트 필드(비어 있는 필드 및 입력된 필드):
- 보조 텍스트
- 후행 아이콘
- 선행 아이콘
- 선행 및 후행 아이콘
- 접두 텍스트
- 접미 텍스트
- 여러 줄 텍스트 필드
아웃라인드 텍스트 필드

- 컨테이너 아웃라인(활성화됨)
- 선행 아이콘(선택 사항)
- 비어 있는 필드의 레이블 텍스트
- 입력된 필드의 레이블 텍스트
- 후행 아이콘(선택 사항)
- 컨테이너 아웃라인(포커스됨)
- 캐럿
- 입력 텍스트
- 보조 텍스트(선택 사항)
아웃라인드 텍스트 필드 색상
색상 값은 디자인 토큰으로 구현됩니다. 즉, 디자인에서는 토큰에 대응하는 색상 값을 사용하고, 구현에서는 색상 값이 값을 참조하는 토큰이 됩니다. 디자인 토큰 자세히 알아보기

라이트 및 다크 모드에 사용되는 아웃라인드 텍스트 필드 색상 역할:
- 아웃라인
- 표면 변형 위
- 표면 변형 위
- 기본
- 표면 변형 위
- 기본
- 기본
- 표면 위
- 표면 변형 위
아웃라인드 텍스트 필드 상태
상태는 컴포넌트나 상호작용 요소의 현재 상황을 시각적으로 표현한 것입니다. 상호작용 상태 자세히 알아보기

- 활성화됨(비어 있는 필드)
- 포커스됨(비어 있는 필드)
- 호버됨(비어 있는 필드)
- 비활성화됨(비어 있는 필드)
- 활성화됨(입력된 필드)
- 포커스됨(입력된 필드)
- 호버됨(입력된 필드)
- 비활성화됨(입력된 필드)
아웃라인드 텍스트 필드 오류 상태
오류 상태는 컴포넌트나 상호작용 요소의 현재 상황을 시각적으로 표현한 것입니다. 오류 메시지는 오류 해결 방법을 안내할 수 있으며, 오류가 해결될 때까지 텍스트 필드 아래에 보조 텍스트로 표시됩니다.

- 활성화됨(비어 있는 필드)
- 포커스됨(비어 있는 필드)
- 호버됨(비어 있는 필드)
- 활성화됨(입력된 필드)
- 포커스됨(입력된 필드)
- 호버됨(입력된 필드)
아웃라인드 텍스트 필드 측정값



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

다음 항목을 포함하는 아웃라인드 텍스트 필드(비어 있는 필드 및 입력된 필드):
- 보조 텍스트
- 후행 아이콘
- 선행 아이콘
- 선행 및 후행 아이콘
- 접두 텍스트
- 접미 텍스트
- 여러 줄 텍스트 필드