텍스트 필드
텍스트 필드를 사용하면 사용자가 텍스트를 입력하고 수정할 수 있습니다.
인터랙티브 데모
이 데모에서는 텍스트 필드 컴포넌트의 다양한 변형과 구성 옵션을 미리 볼 수 있습니다. 각 탭에는 서로 다른 유형의 텍스트 필드가 표시됩니다.
사용 방법
텍스트 필드는 사용자가 UI에 텍스트를 입력할 수 있게 해주며, 일반적으로 폼과 대화상자에 표시됩니다.
원칙

쉽게 찾을 수 있음
텍스트 필드는 눈에 잘 띄고, 사용자가 정보를 입력할 수 있음을 명확하게 나타내야 합니다.

명확성
텍스트 필드의 각 상태는 서로 명확하게 구별되어야 합니다.

효율성
텍스트 필드는 사용자가 요청된 정보를 쉽게 이해하고 오류를 쉽게 해결할 수 있도록 해야 합니다.
유형
텍스트 필드에는 두 가지 유형이 있습니다:
- 채워진 텍스트 필드
- 아웃라인드 텍스트 필드
두 유형의 텍스트 필드 모두 컨테이너를 사용해 상호작용할 수 있음을 명확하게 보여주므로, 사용자가 레이아웃에서 필드를 쉽게 찾을 수 있습니다.

2. 아웃라인드 텍스트 필드
적절한 텍스트 필드 선택
두 유형의 텍스트 필드는 동일한 기능을 제공하므로, 사용할 텍스트 필드의 유형은 스타일만으로 결정할 수 있습니다.
다음 조건에 부합하는 유형을 선택하세요:
- 앱의 시각적 스타일과 가장 잘 어울리는 유형
- UI의 목표에 가장 잘 부합하는 유형
- 버튼과 같은 다른 컴포넌트 및 주변 콘텐츠와 가장 확연히 구별되는 유형


하나의 UI에서 두 가지 유형의 텍스트 필드 함께 사용
한 UI에서 두 유형의 텍스트 필드를 모두 사용하는 경우, 각 섹션별로 일관되게 사용하고 동일한 영역 안에서 섞어 사용하지 않아야 합니다. 예를 들어 한 섹션에서는 아웃라인드 텍스트 필드를, 다른 섹션에서는 채워진 텍스트 필드를 사용할 수 있습니다.

권장

권장하지 않음
구조

2. 시작 아이콘(선택 사항)
3. 레이블 텍스트
4. 입력 텍스트
5. 끝 아이콘(선택 사항)
6. 활성화 표시기
7. 도움말 텍스트(선택 사항)
컨테이너
컨테이너는 텍스트 필드와 주변 콘텐츠 사이에 대비를 만들어 텍스트 필드를 쉽게 찾을 수 있도록 합니다.
채우기와 스트로크
텍스트 필드 컨테이너에는 채우기(fill)와 스트로크(stroke, 테두리)가 있습니다. 스트로크는 컨테이너 전체를 둘러싸거나 하단 가장자리에만 적용됩니다. 스트로크의 색상과 두께를 변경하면 텍스트 필드가 활성 상태임을 나타낼 수 있습니다.
둥근 모서리
아웃라인드 텍스트 필드의 컨테이너는 둥근 모서리를 가지며, 채워진 텍스트 필드의 컨테이너는 상단 모서리만 둥글고 하단 모서리는 각진 형태입니다.

레이블 텍스트
레이블 텍스트는 텍스트 필드에 어떤 정보를 입력해야 하는지 사용자에게 알려주는 데 사용됩니다. 모든 텍스트 필드에는 레이블이 있어야 합니다.
레이블 텍스트는 입력 줄에 맞춰 정렬되며 항상 표시되어야 합니다. 텍스트 필드 중앙에 배치되거나 컨테이너 상단 근처에 놓일 수 있습니다.
권장

권장하지 않음

권장하지 않음
필수 입력 표시
필드가 필수임을 나타내려면 레이블 텍스트 옆에 별표(*)를 표시하고, 별표가 필수 필드를 나타낸다는 안내를 폼 근처에 추가하세요.
- 일부 필드만 필수인 경우, 필수 필드를 모두 표시하세요
- 대부분의 필드가 필수인 경우, 선택 사항인 필드의 레이블 텍스트 옆에 괄호로 묶은 '(선택 사항)'을 표시하세요
- 필수 텍스트에 색상이 적용된 경우, 별표에도 동일한 색상을 사용하세요

입력 텍스트

1. 입력 텍스트
입력 텍스트는 사용자가 입력한 텍스트입니다.
2. 커서
커서는 필드에서 텍스트 입력의 현재 위치를 나타냅니다.
보조 요소

1. 도움말 텍스트
도움말 텍스트는 입력 필드의 용도 등 입력 필드에 관한 추가 안내를 전달합니다. 한 줄만 차지해야 하며, 항상 표시되거나 포커스된 경우에만 표시될 수 있습니다.
2. 오류 메시지
입력한 텍스트가 허용되지 않는 경우, 오류 메시지를 통해 해결 방법을 표시할 수 있습니다. 오류 메시지는 입력 줄 아래에 표시되며, 문제가 해결될 때까지 도움말 텍스트를 대체합니다.
3. 아이콘
아이콘은 알림을 전달하는 데에도 사용할 수 있습니다. 오류 메시지와 함께 사용해 이중 알림을 제공하면 색맹·색약이 있는 사용자에게도 알림을 확실히 전달할 수 있습니다.
4. 문자 수 카운터
글자 수 또는 단어 수 제한이 있는 경우 문자 수 카운터나 단어 수 카운터를 사용해야 합니다. 카운터는 사용된 글자 수와 전체 글자 수 제한을 표시합니다.
오류 텍스트
내용의 유효성을 검사하는 텍스트 필드(예: 비밀번호)의 경우, 필요할 때 도움말 텍스트를 오류 텍스트로 교체하세요. 도움말 텍스트를 오류 텍스트로 교체하면 새로운 텍스트 줄이 레이아웃에 추가되지 않으므로, 콘텐츠가 밀려나는 것을 방지할 수 있습니다.
- 오류가 한 가지만 가능한 경우, 오류 텍스트는 해당 오류를 피하는 방법을 설명합니다
- 여러 오류가 가능한 경우, 오류 텍스트는 가능성이 가장 높은 오류를 피하는 방법을 설명합니다
권장
권장하지 않음

주의
아이콘
텍스트 필드의 아이콘은 선택 사항입니다. 텍스트 필드 아이콘은 사용 가능한 입력 방식(예: 마이크 아이콘)을 나타내고, 추가 기능(예: 필드 내용 지우기)을 제공하며, 오류 상태를 나타낼 수 있습니다.
시작 아이콘과 끝 아이콘의 위치는 LTR(왼쪽에서 오른쪽) 또는 RTL(오른쪽에서 왼쪽) 읽기 방향에 따라 달라집니다.

아이콘 표시는 텍스트 필드에 필요한 입력 유형을 설명하고, 내장된 컴포넌트의 터치 타깃이 될 수 있습니다. 예를 들어 캘린더 아이콘을 탭하면 날짜 선택 도구가 표시될 수 있습니다.
2. 유효 또는 오류 아이콘
아이콘은 유효한 입력과 유효하지 않은 입력을 모두 나타낼 수 있어, 색맹·색약이 있는 사용자에게도 오류 상태를 명확히 전달합니다.
3. 지우기 아이콘
지우기 아이콘을 사용하면 입력 필드 전체를 지울 수 있습니다. 입력 텍스트가 있을 때만 표시됩니다.
4. 음성 입력 아이콘
마이크 아이콘은 음성으로 텍스트를 입력할 수 있음을 나타냅니다.
5. 드롭다운 아이콘
드롭다운 화살표는 텍스트 필드에 내장된 선택 컴포넌트가 있음을 나타냅니다.
동작
크기 조정 및 적응
레이아웃이 더 대형 화면과 기기 형태(form factor)에 맞게 조정될 때는 텍스트 필드에 유동적인 컨테이너 크기를 적용하세요. 레이아웃이 확장될 때 서체가 적절히 조정되도록 여백, 패딩, 컨테이너 크기의 최솟값과 최댓값을 설정해 더 나은 읽기 경험을 제공하세요.

유동 레이아웃에서 텍스트 필드가 확장될 때는 고정된 여백과 서체 속성을 유지하지 마세요. 고정된 값을 유지하면 텍스트 필드가 지나치게 넓어질 수 있습니다. 예를 들어 텍스트 필드가 대형 화면의 전체 너비를 차지해서는 안 됩니다.
채워진 텍스트 필드
사용 방법
채워진 텍스트 필드는 아웃라인드 텍스트 필드보다 시각적으로 더 강조되어, 다른 콘텐츠와 컴포넌트에 둘러싸여 있을 때 눈에 잘 띕니다.

권장하지 않음
고밀도 텍스트 필드
고밀도 텍스트 필드를 사용하면 많은 양의 정보를 빠르게 살펴보고 조치를 취할 수 있습니다.


2. 레이블이 없는 고밀도 텍스트 필드
레이블 없는 텍스트 필드
필드의 용도가 별도의 레이블로 표시되는 경우 텍스트 필드에 레이블이 필요하지 않습니다.

접두사 및 접미사 텍스트




상태
채워진 텍스트 필드 (기본)

레이블 없는 채워진 텍스트 필드

접두사 텍스트가 있는 채워진 텍스트 필드

접미사 텍스트가 있는 채워진 텍스트 필드

아웃라인드 텍스트 필드
사용 방법
아웃라인드 텍스트 필드는 채워진 텍스트 필드보다 시각적으로 덜 강조됩니다. 폼처럼 많은 텍스트 필드가 함께 배치되는 곳에 표시될 때는 이러한 낮은 강조가 레이아웃을 단순화하는 데 도움이 됩니다.
고밀도 텍스트 필드
고밀도 텍스트 필드를 사용하면 많은 양의 정보를 빠르게 살펴보고 조치를 취할 수 있습니다.


레이블 없는 텍스트 필드
필드의 용도가 별도의 레이블로 표시되는 경우 텍스트 필드에 레이블이 필요하지 않습니다.

접두사 및 접미사 텍스트




상태
아웃라인드 텍스트 필드 (기본)

레이블 없는 아웃라인드 텍스트 필드

접두사 텍스트가 있는 아웃라인드 텍스트 필드

접미사 텍스트가 있는 아웃라인드 텍스트 필드

입력 유형
텍스트 필드는 다음과 같은 방식으로 사용자 입력을 받을 수 있습니다:
- 한 줄 텍스트 필드는 한 줄의 텍스트만 표시합니다
- 여러 줄 텍스트 필드는 여러 줄의 텍스트를 수용할 수 있도록 늘어납니다
- 텍스트 영역은 높이가 고정된 필드입니다
한 줄 필드에서는 커서가 필드의 오른쪽 끝에 도달하면 입력 줄보다 긴 텍스트가 자동으로 왼쪽으로 스크롤됩니다.
한 줄 필드는 긴 응답을 수집하기에 적합하지 않습니다. 긴 응답에는 대신 여러 줄 텍스트 필드나 텍스트 영역을 사용하세요.
여러 줄 텍스트 필드는 사용자 입력 전체를 한 번에 표시합니다. 넘치는 텍스트로 인해 텍스트 필드가 확장되어(아래의 화면 요소가 밀려남) 텍스트는 새 줄로 줄바꿈됩니다.
이러한 필드는 처음에는 한 줄 필드로 표시되므로, 많은 텍스트를 수용해야 하지만 공간이 제한된 레이아웃에 유용합니다.
텍스트 영역은 텍스트 필드보다 높으며 넘치는 텍스트를 새 줄로 줄바꿈합니다. 높이는 고정되어 있고 커서가 필드 하단에 도달하면 세로로 스크롤됩니다.
초기 크기가 크다는 것은 더 긴 응답이 가능할 뿐만 아니라 권장된다는 것을 나타냅니다.
웹에서는 여러 줄 필드 대신 텍스트 영역을 사용해야 합니다. 텍스트 영역의 높이가 모바일 화면 크기 안에 들어오도록 하세요.
읽기 전용 필드
읽기 전용 텍스트 필드는 사용자가 편집할 수 없는 미리 채워진 텍스트를 표시합니다. 읽기 전용 텍스트 필드는 일반 텍스트 필드와 동일하게 스타일이 지정되며, 읽기 전용임이 명확하게 표시됩니다.


연구
Material Design은 텍스트 필드 사용성의 특성과 텍스트 필드 디자인에 대한 사용자 선호도를 파악하기 위해 약 600명의 참가자를 대상으로 두 건의 연구를 진행했습니다. 이 연구에서는 사용자가 텍스트 필드를 훑어보고 찾아내는 능력과 텍스트 필드 유형을 식별하는 능력을 측정했습니다.
연구에 따르면 다음은 텍스트 필드의 사용성을 개선하기 위해 채택할 수 있는 모범 사례입니다:
- 단일 밑줄 대신 사각형 박스로 둘러싸인 텍스트 필드를 사용합니다
- 텍스트 필드 박스에는 '하단 선이 있는 반투명 채우기' 또는 '불투명한 스트로크가 있는 완전히 투명한 채우기'를 사용합니다
- 레이블 텍스트는 텍스트 필드 박스의 경계 안에 배치합니다
- 텍스트 필드의 외곽선 또는 스트로크가 배경과 최소 3:1 색상 대비율을 충족하도록 합니다
테마 설정
Rally 머티리얼 테마
이 개인 금융 앱의 채워진 텍스트 필드는 Material Theming을 사용해 맞춤 설정되었습니다. 맞춤 설정 영역에는 색상과 서체가 포함됩니다.

색상
Rally의 채워진 텍스트 필드는 레이블 텍스트, 입력 텍스트, 끝 아이콘, 활성화 표시기, 컨테이너 등 다섯 가지 요소에 맞춤 색상을 사용합니다.

| 요소 | 카테고리 | 속성 | 값 |
|---|---|---|---|
| 레이블 텍스트 | Primary | 색상 불투명도 | #FFFFFF 100% |
| 입력 텍스트 | On Surface | 색상 불투명도 | #FFFFFF 100% |
| 끝 아이콘 | On Surface | 색상 불투명도 | #FFFFFF 100% |
| 활성화 표시기 | Primary | 색상 불투명도 | #FFFFFF 100% |
| 컨테이너 | On Surface | 색상 불투명도 | #FFFFFF 4% |
타이포그래피
Rally의 채워진 텍스트 필드는 입력 텍스트와 레이블 텍스트에 맞춤 서체를 사용합니다.

| 요소 | 카테고리 | 속성 | 값 |
|---|---|---|---|
| 입력 텍스트 | Subtitle 1 | 서체 굵기 크기 대소문자 | Eczar Regular 16 단어 첫 글자 대문자 |
| 레이블 텍스트 | Caption | 서체 굵기 크기 대소문자 | Roboto Condensed Regular 12 단어 첫 글자 대문자 |
모양
Rally의 채워진 텍스트 필드는 맞춤 모서리 모양을 사용합니다.

| 요소 | 카테고리 | 속성 | 값 |
|---|---|---|---|
| 컨테이너 | 소형 컴포넌트 | 계열 크기 | Cut 0;0;0;0 dp |
Crane 머티리얼 테마
이 여행 앱의 아웃라인드 텍스트 필드는 Material Theming을 사용해 맞춤 설정되었습니다. 맞춤 설정 영역에는 색상과 서체가 포함됩니다.

색상
Crane의 아웃라인드 텍스트 필드는 입력 텍스트, 레이블 텍스트, 컨테이너 등 세 가지 요소에 맞춤 색상을 사용합니다.

| 요소 | 카테고리 | 속성 | 값 |
|---|---|---|---|
| 입력 텍스트 | On Surface | 색상 불투명도 | #000000 87% |
| 레이블 텍스트 | On Surface | 색상 불투명도 | #000000 60% |
| 컨테이너 | On Surface | 색상 불투명도 | #000000 12% |
타이포그래피
Crane의 아웃라인드 텍스트 필드는 입력 텍스트와 레이블 텍스트에 맞춤 서체를 사용합니다.

| 요소 | 카테고리 | 속성 | 값 |
|---|---|---|---|
| 입력 텍스트 | Subtitle 1 | 서체 굵기 크기 대소문자 | Raleway Medium 16 단어 첫 글자 대문자 |
| 레이블 텍스트 | Caption | 서체 굵기 크기 대소문자 | Raleway SemiBold 14 단어 첫 글자 대문자 |
모양
Crane의 아웃라인드 텍스트 필드는 맞춤 모서리 모양을 사용합니다.

| 요소 | 카테고리 | 속성 | 값 |
|---|---|---|---|
| 컨테이너 | 소형 컴포넌트 | 계열 크기 | Cut 4;4;4;4 dp |
사양
채워진 텍스트 필드



아웃라인드 텍스트 필드


