MultiLineTextField

MultiLineTextField 소개

MultiLineTextField 컴포넌트는 사용자로부터 여러 줄로 된 문자열을 입력하는 데 쓰이는 컴포넌트입니다. TextArea 컴포넌트와 유사하지만 Material Design 요소를 반영했으며 usecharcount 속성을 지원해 입력 중인 값의 길이를 표시할 수 있고 입력값에 대한 유효성을 검사할 수 있습니다.

MultiLineTextField 컴포넌트는 여러 줄로 된 문자열을 입력할 수 있도록 디자인되었기 때문에 입력값의 형태를 제한하지는 않습니다. 특정한 문자열만 입력하도록 허용하려면 TextField 컴포넌트를 사용하십시오.

사용 예

서비스 특성상 입력할 값의 길이가 정해진 경우에는 입력창 하단에 입력 가능한 글자수와 현재 입력된 글자수를 표시합니다.

MultiLineTextField 사용하기

MultiLineTextField 컴포넌트를 사용하기 위해서는 TypeDefinition에서 MultiLineTextField 컴포넌트를 추가해주어야 합니다.

24.0.0.200 이후 버전에서는 프로젝트 생성 시 MultiLineTextField 컴포넌트가 추가된 상태로 표시됩니다.

24.0.0.100 또는 넥사크로 N V21에서 만든 프로젝트를 사용하는 경우 아래와 같은 방법으로 MultiLineTextField 컴포넌트를 추가해주어야 합니다.

1

Project Explorer에서 [TypeDefinition > Objects] 항목을 더블 클릭합니다.

2

Modules 항목에서 MobileComp.json 항목을 펼칩니다.

3

nexacro.MultiLineTextField 항목 옆에 [+] 아이콘을 클릭해 MultiLineTextField 컴포넌트를 Objects 목록에 추가합니다.

텍스트 길이에 따라 charcounttext 표시하기

입력한 텍스트 길이에 따라 usecharcount 속성값을 변경해 charcounttext를 표시합니다.

예제

maxlength 속성값의 70%가 넘어가면 charcounttext를 표시합니다.

sample_edit_01_01

sample_multilinetextfield_01.xfdl

예제에서 사용한 핵심 기능

usecharcount

maxlength 속성값을 설정한 경우 "현재 입력한 텍스트 길이 / maxlength 속성값" 형태로 charcounttext를 표시합니다.

maxlength

입력할 수 있는 텍스트 길이 최댓값을 설정합니다.

예제 구현 방법

1

화면에 MultiLineTextField 컴포넌트를 배치합니다.

2

컴포넌트의 maxlength 속성값을 "100"으로 설정하고 usecharcount 속성값을 false로 변경합니다.

3

oninput 이벤트 핸들러 함수를 아래와 같이 추가합니다.

this.MultiLineTextField00_oninput = function(obj:nexacro.MultiLineTextField,e:nexacro.InputEventInfo)
{
	var currentLength = this.MultiLineTextField00.getLength();
	var maxAllowedLength = this.MultiLineTextField00.maxlength * 0.7;
	if(currentLength > maxAllowedLength)
	{
		this.MultiLineTextField00.usecharcount = true;
	} 	else 	{
		this.MultiLineTextField00.usecharcount = false;		
	}
};

4

QuickView(Ctrl + F6)를 실행하여 MultiLineTextField 컴포넌트에 70자 이상 입력 시 charcounttext가 표시되는지 확인합니다.