DojoTextField

DojoTextField 위젯은 단일 텍스트 행을 포함하는 텍스트 상자를 정의합니다. 이 위젯은 Dojo dijit.form.ValidationTextBox 정의를 기반으로 합니다.

지원되는 특성은 다음과 같습니다.
constraints
함수 호출 중에 인수로 사용되는 사전입니다. 이는 결국 사용자 입력을 유효성 검증합니다. 이러한 함수는 validators 특성에서 참조되며 유효성 검증기 함수라고 합니다.
사전의 컨텐츠는 사용자의 비즈니스 요구사항에 부합합니다. 예제 지정은 다음과 같습니다.
constraints = new Dictionary{timeFormat = "hh:mm:ss"}

이 경우 유효성 검증기 함수는 사용자의 입력이 시, 분, 초의 값과 사이의 콜론을 나타내도록 형식화되지 않으면 오류 메시지를 리턴할 수 있습니다.

inputRequired
입력이 필수인지 여부를 표시하는 부울 값입니다. 이 경우 오류 메시지는 inputRequiredMessage 특성의 값입니다.

이 유효성 검증은 다른 것들보다 우선하지만 필드가 초점을 잃은 후 초점을 얻은 후에만 활성입니다.

inputRequiredMessage
InputRequired 특성이 true이고 텍스트 필드에 컨텐츠가 없으며 필드가 초점을 잃은 후 초점을 얻을 때 표시되는 문자열입니다. 메시지는 사용자에게 제공되는 출력 필드에 표시됩니다.

inputRequiredMessage 특성이 없는 경우 오류 메시지는 로케일에 맞는 "이 값은 필수입니다."입니다.

참고: Rich UI 편집기에서 사용되는 로케일을 설정하려면 "Rich UI 모양을 위한 환경 설정"의 언어 탭에 대한 지시사항을 참조하십시오. 배치 시에 런타임 로케일을 설정하려면 "EGL 배치 디스크립터에서 Rich UI 배치 항목 추가"를 참조하십시오.
maxLength
필드에 입력할 수 있는 최대 문자 수입니다.
placeholder
Dojo 텍스트 필드에 표시되지만 사용자가 필드를 클릭하자마자 제거되는 문자열입니다. 이 문자열은 필드가 비어 있고 사용자가 해당 필드에서 작업하지 않으면 다시 표시됩니다.
promptMessage
사용자가 입력하도록 프롬프트하는 문자열입니다. 텍스트 필드가 초점을 얻을 때 텍스트 필드 옆에 제공되는 출력 필드에 이 문자열이 표시되며, 사용자가 컨텐츠를 추가하거나 변경하기 시작할 때까지 계속 표시됩니다. 문자열 위치를 추가로 설정하려면 tooltipPosition 특성을 설정하십시오.
readOnly
텍스트 필드가 사용자 입력으로부터 보호되는지 여부를 표시하는 부울 값입니다.
selectOnClick
사용자가 텍스트 필드의 외부에서 필드를 클릭하는 경우 발생하는 일을 나타내는 부울 값입니다.
False(기본값)
텍스트 필드의 컨텐츠가 선택되지 않습니다. 클릭 위치에 업데이트 커서가 표시됩니다.
True
텍스트 필드의 컨텐츠가 선택됩니다. 모든 후속 클릭은 클릭 위치에 업데이트 커서를 표시하며 텍스트 필드의 컨텐츠는 더 이상 선택되지 않습니다.
suppressChangeEvent
코드로 이 값을 true로 설정한 후 onChange 이벤트를 방지하는 부울 값입니다.
text
Dojo 텍스트 필드의 문자열 컨텐츠입니다.
textCase
사용자가 입력을 완료하고 다른 필드로 이동하는 경우 입력의 대소문자에 발생하는 일을 표시하는 문자열 상수입니다. 다음 값 중 하나입니다.
CASE_NONE(기본값)
사용자의 문자열이 그대로 남아 있습니다.
UPPER_CASE
사용자의 문자열이 대문자로 설정됩니다.
LOWER_CASE
사용자의 문자열이 소문자로 설정됩니다.
PROPER_CASE
문자열이 제목인 것처럼 각 단어의 첫 번째 문자가 대문자로 설정됩니다.
tooltipPosition
사용자의 감소하는 환경 설정 순서로 메시지 위치의 순서를 지정하는 문자열 상수 배열입니다.

EGL 런타임 코드는 배열의 각 상수를 차례로 시도합니다. 창 또는 화면 이동 영역에서 공간이 충분하지 않은 경우 외에는 주어진 상수에 대해 적절하게 메시지가 표시됩니다. 공간이 충분하지 않은 경우, 핸들러는 배열의 다음 상수가 표시하는 방향을 시도합니다.

올바른 상수는 다음과 같습니다.

TOOLTIP_AFTER
메시지가 텍스트 필드의 오른쪽에 표시됩니다.
TOOLTIP_BEFORE
메시지가 텍스트 필드의 왼쪽에 표시됩니다.
TOOLTIP_ABOVE
메시지가 텍스트 필드의 위에 표시됩니다.
BELOW
메시지가 텍스트 필드의 아래에 표시됩니다.

공간 때문에 값을 사용할 수 없는 경우, 메시지는 필드의 맨 위에 표시됩니다.

값을 지정하지 않으면 tooltipPosition의 값은 [DojoLib.AFTER, DojoLib.BEFORE]입니다.

trim
사용자가 입력을 완료하고 다른 필드로 이동하는 경우 선행 및 후미 공백이 제거되는지 여부를 표시하는 부울 값입니다.
validators
사용자의 각 키 입력에 대한 응답으로 배열-요소 순서로 호출되는 유효성 검증기 함수의 배열입니다. 사용자의 입력이 주어진 함수에 유효성 검증을 전달한 경우 함수는 널 또는 공백의 리턴이 성공했음을 표시하며, 이 경우에만 배열의 다음 함수가 호출됩니다. 사용자의 입력이 유효성 검증을 전달하지 않은 경우 함수는 공백이 아닌 문자열 리턴의 실패를 표시합니다.

유효성 검증기의 시퀀스는 각 키 입력 시 호출됩니다.

Dojo 텍스트 필드가 제어기에 의해 참조되는 경우, 설명 중인 함수에서 완전히 분리되는 제어기 특정 유효성 검증기 함수를 코드할 수 있습니다. 제어기 특정 함수는 필드 특정 유효성 검증이 성공한 경우와 위젯이 초점을 잃은 후에만 호출됩니다.

제어기에 대한 세부사항은 "Rich UI 유효성 검증 및 형식화"를 참조하십시오.

각 필드 특정 유효성 검증기 함수는 다음 위임 파트를 준수합니다.
Delegate Validator(input String in, constraints dictionary in)
         returns(string?) end
input
동일한 Dojo 텍스트 필드에서 이전 키 입력의 문자를 포함하여 사용자가 수집한 입력입니다.
constraints
정규식을 생성하거나 유효성 검증기 함수 내부의 처리를 안내하는 데 사용되는 정보를 제공하는 사전입니다. 예를 들어, 사전은 사용자의 보안 레벨을 지정할 수 있습니다.
string?
널 또는 공백(오류가 발생하지 않은 경우)이거나 공백이 아닌 문자열(오류가 발생했음을 표시)입니다.

유효성 검증기에서 DojoLib 라이브러리가 제공하는 하나 이상의 함수를 호출할 수 있습니다.

다음 함수는 "Rich UI 유효성 검증 및 형식화"에 나열된 것처럼 보기 레벨 유효성 검증을 지원하는 EGL Dojo 위젯 유형에 특정합니다.
getValidState
온전히 내부용입니다.
showErrorIndicator
위젯에서 오류 표시기를 설정하거나 지우는 부울 값을 승인합니다. 함수 프로토타입은 다음과 같습니다.
function showErrorIndicator(aboolean boolean in);
showErrorMessage
위젯 근처의 오류 메시지 도구 팁에 표시할 오류 메시지를 승인합니다. 도구 팁은 위젯이 초점을 얻을 때 표시되고 위젯이 초점을 잃을 때 숨겨집니다. 함수 프로토타입은 다음과 같습니다.
function showErrorMessage(msg string in);

지원되는 다른 특성 및 함수는 "위젯 특성 및 함수"와 "위젯 스타일"에서 설명합니다.