텍스트 인풋은 가장 기본적인 사용자 입력 컨트롤이다. 사용자의 이름, 이메일주소, 전화번호, 비밀번호와 같은 일반적인 정보부터 상품 금액, 계좌번호, 가격 정보 등 상세한 정보 수집이 필요한 상황에서 범주화 할 수 없는 정보 입력을 요청해야 할 경우 주로 사용된다.

UI 유형

텍스트 인풋의 유형은 3가지로 구분한다.

No	Type	Description

No	Type	Description
1	Default Text Input	Open 일반적인 텍스트 인풋
2	Text Input with Addon	Open 입력 받아야하는 문구 중 고정 내용을 애드온으로 표시
3	Text Input with fix	입력 필드 내에 고정 문구를 prefix, suffix로 표시

memo Vertical Text Input

Form이나 Table 내에 있는 텍스트 인풋은 입력 필드 상단에 라벨이 고정된다.

memo Required Text Input

텍스트 인풋의 필수 입력 여부 설정은 Platform Console에 있는 스키마 메뉴에서 진행 한다. 필수 입력으로 설정된 텍스트 인풋은 사용자 입력 시 설정 조건에 따라 경고성 Helper Text가 자동 출력 된다.

상태 정보

텍스트 인풋의 상태는 아래와 같이 4가지로 표현된다.

셋팅 옵션

BackOffice Builder의 Input Component > Text > Setting에서 상세 설정을 진행한다.

Common Options

입력형(Data Input) 컴포넌트에 공통으로 적용되는 옵션이다.

1. Size

텍스트 인풋의 크기는 아래와 같이 3가지로 선택 할 수 있다.

❤︎ 텍스트 인풋의 사이즈 조절은 Form 내에서만 확인 가능

Label(버튼이름)에 입력된 텍스트 길이에 따라 입력 필드의 가로 길이는 가변적으로 변한다. 만약 고정 사이즈의 입력 필드가 필요하다면, Fixed Field Size를 조절하여 직접 사이즈를 지정 할 수도 있다.

2. Field Size

입력 필드의 사이즈를 비율로 조절할 수 있다.

텍스트 인풋의 필드 사이즈 조절은 Form 내에서만 확인 가능하다.

3. Placeholder

플레이스 홀더는 입력 받을 정보에 대한 부가적인 요청 문구로 정보가 입력되면 사라진다.

4. Tooltip

툴팁을 사용하면, 라벨 옆에 물음표 아이콘이 추가되고, 마우스 오버 시 입력한 안내 문구가 출력된다.

5. Helper text (=Comment)

입력 필드 하단에 고정되어 노출되는 도움말 문구이다. 사용자의 입력 성공/실패 여부와 상관 없이 도움말 문구는 고정으로 출력된다.

Text Options

Text Input 컴포넌트에 적용되는 고유 옵션이다.

1. Addon Before/After

Text Options 영역에서 애드온 기능을 사용할 수 있다. 주로 입력 받을 값에 고정으로 들어가는 텍스트를 미리 입력 필드 밖에 고정하는 용도로 사용된다.

2. Prefix/Suffix

Text Options 영역에서 Fix 기능을 사용할 수 있다. 텍스트를 입력 필드 안에 고정하여 출력한다.

3. Text Limit

Text Options 영역에서 입력 받을 텍스트 길이에 제한 조건을 설정 할 수 있다.

need check Limit Message 삭제 필요

설정시 문구 미출력, Text Limit 글자수 조건에 맞지 않으면 입력 불가

tobe Text Input with Addon : 추후 Addon 셀렉트 기능 필요 (현재는 텍스트만 입력 가능)

tobe Text Input with fixText : 추후 아이콘 추가 기능 필요 (현재는 텍스트만 입력 가능)

tobe 추후 Clear Button, Success/Error 아이콘 표시 설정 옵션 필요