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

사용법
연락처나 결제 정보를 입력할 때와 같이 사용자가 UI에 텍스트를 입력해야 하는 경우 텍스트 필드를 사용하세요.

텍스트 필드에는 두 가지 변형이 있습니다:
- 채워진 텍스트 필드
- 아웃라인드 텍스트 필드
두 변형 모두 상호작용을 위한 시각적 단서로 컨테이너를 사용하며, 기능은 동일합니다.


아웃라인드 텍스트 필드
아웃라인드 텍스트 필드는 채워진 텍스트 필드보다 시각적 강조가 약합니다. 따라서 양식처럼 여러 텍스트 필드가 함께 배치되는 곳에서 사용하면 강조가 적은 덕분에 레이아웃을 단순화하는 데 도움이 됩니다.

텍스트 필드 선택
텍스트 필드 선택
두 변형은 기능이 동일하며, 사용할 변형은 스타일에 따라 결정하면 됩니다.
다음 조건에 가장 잘 맞는 변형을 선택하세요:
- 앱의 시각적 스타일과 가장 잘 어울리는가
- UI의 목적에 가장 적합한가
- 다른 컴포넌트(예: 버튼) 및 주변 콘텐츠와 충분히 구분되는가


동일한 화면에서 두 텍스트 필드 변형 사용
UI에서 두 변형을 모두 사용할 때는 섹션별로 일관되게 적용하고, 같은 영역 안에서 섞어 사용하지 마세요.
예를 들어 한 섹션에는 아웃라인드 텍스트 필드를, 다른 섹션에는 채워진 텍스트 필드를 사용하세요.


구조
채워진 텍스트 필드

- 컨테이너
- 앞쪽 아이콘(선택 사항)
- 비어 있는 필드의 레이블 텍스트
- 값이 입력된 필드의 레이블 텍스트
- 뒤쪽 아이콘(선택 사항)
- 포커스 상태의 활성 표시기
- 커서(캐럿)
- 입력 텍스트
- 보조 텍스트(선택 사항)
- 사용 설정 상태의 활성 표시기
아웃라인드 텍스트 필드

- 사용 설정 상태의 컨테이너 아웃라인
- 비어 있는 필드의 레이블 텍스트
- 앞쪽 아이콘(선택 사항)
- 값이 입력된 필드의 레이블 텍스트
- 뒤쪽 아이콘(선택 사항)
- 포커스 상태의 컨테이너 아웃라인
- 커서(캐럿)
- 입력 텍스트
- 보조 텍스트(선택 사항)
컨테이너
컨테이너는 텍스트 필드와 주변 콘텐츠 사이에 대비를 형성하여 사용자가 텍스트 필드를 더 쉽게 찾을 수 있도록 합니다.
채우기 및 테두리
텍스트 필드 컨테이너에는 채우기(fill)와 테두리(stroke)가 있으며, 테두리는 전체 컨테이너를 둘러싸거나 아래쪽 가장자리에만 적용될 수 있습니다. 테두리 색상과 두께는 텍스트 필드가 활성 상태임을 나타내기 위해 변경될 수 있습니다.
둥근 모서리
아웃라인드 텍스트 필드의 컨테이너는 모서리가 둥글고, 채워진 텍스트 필드의 컨테이너는 위쪽 모서리가 둥글며 아래쪽 모서리는 직각입니다.

레이블 텍스트
레이블 텍스트는 사용자에게 어떤 정보를 입력해야 하는지 알려줍니다. 모든 텍스트 필드에는 레이블이 있어야 합니다.
레이블 텍스트는 입력 텍스트와 정렬되어야 하며 항상 표시되어야 합니다. 필드 중앙 또는 컨테이너 상단 근처에 위치할 수 있습니다.
레이블 텍스트는 잘리거나 여러 줄에 걸쳐 표시되어서는 안 됩니다. 짧고 명확하며 완전히 보이도록 유지하세요.


인접 레이블
필드의 목적이 별도의 인접 레이블로 표시되는 경우 텍스트 필드 자체에는 레이블이 필요하지 않습니다.
인접 레이블은 텍스트 필드 컨테이너의 시작 가장자리에 맞춰 정렬하세요.

필수 입력 표시기
필드가 필수임을 표시하려면 레이블 텍스트 옆에 별표(*)를 표시하고, 별표가 필수 필드를 나타낸다는 점을 다음 두 가지 방법 중 하나로 안내하세요:
- 보조 텍스트
- 양식 시작 부분에 하나의 안내 문구
추가 권장 사항은 다음과 같습니다:
- 모든 필수 필드를 표시하세요
- 필수 항목의 레이블 텍스트에 특정 색상을 사용하는 경우 별표에도 같은 색상을 적용하세요

입력 텍스트
입력 텍스트는 사용자가 텍스트 필드에 입력한 텍스트입니다.
텍스트 필드는 입력 텍스트를 다음과 같은 방식으로 표시할 수 있습니다:
- 단일 줄 텍스트 필드는 한 줄의 텍스트만 표시합니다
- 여러 줄 텍스트 필드는 여러 줄의 텍스트를 담을 수 있도록 확장됩니다
- 텍스트 영역은 높이가 고정된 필드입니다

접두사 텍스트
텍스트 필드에는 통화 기호와 같은 접두사 텍스트가 포함될 수 있습니다.

접미사 텍스트
텍스트 필드에는 측정 단위나 이메일 도메인과 같은 접미사 텍스트가 포함될 수 있습니다.


보조 텍스트 및 문자 수 카운터
보조 텍스트는 입력 필드의 용도 등 필드에 대한 추가 정보를 전달합니다. 가급적 한 줄로 유지하되, 필요한 경우 여러 줄로 줄바꿈할 수 있습니다. 항상 표시하거나 포커스 시에만 표시할 수 있습니다.
문자 또는 단어 수 제한이 있는 경우 카운터를 포함하세요. 카운터는 사용한 문자 수와 전체 문자 수 제한의 비율을 표시합니다.

- 보조 텍스트
- 문자 수 카운터
오류 텍스트
비밀번호처럼 콘텐츠를 검증하는 텍스트 필드에서는 보조 텍스트를 오류 텍스트로 교체하세요. 이렇게 하면 오류 텍스트 때문에 새 줄이 추가되어 콘텐츠가 밀리고 레이아웃이 바뀌는 것을 방지할 수 있습니다.
- 오류가 하나만 발생할 수 있는 경우, 오류 텍스트에서 해당 오류를 방지하는 방법을 설명해야 합니다
- 여러 오류가 발생할 수 있는 경우, 오류 텍스트에서 가장 발생 가능성이 높은 오류를 방지하는 방법을 설명해야 합니다

오류 아이콘
텍스트 필드가 오류 상태일 때는 오류 아이콘을 표시할 것을 강력히 권장합니다.
오류 아이콘은 시각 장애가 있는 사용자가 오류를 더 쉽게 인지하도록 돕고, 추가적인 시각 단서를 제공합니다.

아이콘 및 이미지
텍스트 필드의 아이콘은 선택 사항입니다. 텍스트 필드 아이콘은 다음과 같은 역할을 할 수 있습니다:
- 마이크 아이콘과 같은 사용 가능한 입력 방법을 나타냄
- 필드 내용 지우기와 같은 추가 기능에 접근할 수 있음을 알려줌
- 오류를 나타냄
앞쪽 및 뒤쪽 아이콘은 LTR(왼쪽→오른쪽) 또는 RTL(오른쪽→왼쪽) 환경에 따라 위치가 변경됩니다.
높이가 24dp인 이미지는 텍스트 필드 안에 배치할 수 있습니다. 이 높이는 필드 내부에 적절한 상하 패딩을 확보하며, 아이콘 크기 권장 사항과 일치합니다.
- 아이콘 표시자
아이콘 표시자는 텍스트 필드에 필요한 입력 유형을 나타내며, 중첩된 컴포넌트의 터치 영역 역할을 할 수 있습니다. 예를 들어 달력 아이콘을 탭하면 날짜 선택기가 표시됩니다. - 유효 또는 오류 아이콘
아이콘으로 유효한 입력과 유효하지 않은 입력을 모두 나타낼 수 있어, 색맹 사용자도 오류 상태를 명확히 인지할 수 있습니다. - 지우기 아이콘
지우기 아이콘을 사용하면 입력된 텍스트 전체를 지울 수 있습니다. 입력 텍스트가 있을 때만 표시됩니다. - 음성 입력 아이콘
마이크 아이콘은 음성으로 텍스트를 입력할 수 있음을 나타냅니다. - 드롭다운 아이콘
드롭다운 화살표는 텍스트 필드에 중첩된 선택 컴포넌트가 있음을 나타냅니다. - 이미지
이미지는 신용 카드 번호와 같이 어떤 정보를 입력해야 하는지에 대한 맥락을 제공하는 데 도움이 될 수 있습니다.

- 아이콘 표시자
- 유효 또는 오류 아이콘
- 지우기 아이콘
- 음성 입력 아이콘
- 드롭다운 아이콘
- 이미지
읽기 전용 필드
읽기 전용 텍스트 필드는 사용자가 편집할 수 없는 미리 채워진 텍스트를 표시합니다.
읽기 전용 텍스트 필드는 일반 텍스트 필드와 동일한 스타일로 표시되며, 읽기 전용으로 명확히 레이블이 지정됩니다.


적응형 디자인
레이아웃이 더 대형 화면과 다양한 브레이크포인트에 적응할 때 텍스트 필드에는 유연한 컨테이너 크기를 적용하세요. 레이아웃이 확장될 때 가독성을 위해 서체가 조정되도록 여백, 패딩, 컨테이너 크기에 최소값과 최대값을 설정하세요.

유동 레이아웃에서 텍스트 필드가 확장될 때 고정 여백과 서체 속성을 그대로 유지하지 마세요. 그렇게 하면 텍스트 필드가 지나치게 길어질 수 있습니다.
예를 들어 텍스트 필드는 대형 화면의 전체 너비를 차지해서는 안 됩니다.

밀도
밀도가 높은 텍스트 필드를 사용하면 사용자가 많은 정보를 빠르게 훑어보고 조치할 수 있습니다.

기본적으로 밀도를 적용하지 않기
기본적으로 텍스트 필드에 밀도를 적용하지 마세요. 밀도를 적용하면 터치 영역이 권장 크기인 48x48 CSS 픽셀보다 작아질 수 있습니다. 대신 사용자가 밀도가 더 높은 레이아웃을 선택하거나 테마를 변경하는 등 더 높은 밀도를 선택할 수 있는 방법을 제공하세요.
밀도 설정이 활성화된 상태에서도 쉽게 되돌릴 수 있도록, 설정을 변경하는 모든 컨트롤의 터치 영역은 각각 최소 48x48 CSS 픽셀 이상으로 유지하세요.