DojoCurrencyTextBox
DojoCurrencyTextBox 위젯은 숫자 통화 값을 포함하는 텍스트 상자를 정의합니다. 이 위젯은 Dojo dijit.form.CurrencyTextBox 정의를 기반으로 합니다.
지원되는 특성은 다음과 같습니다.
- constraints
- 함수 호출 중에 인수로 사용되는 사전입니다. 이는 결국 사용자 입력을 유효성 검증합니다. 이러한 함수는
validators 특성에서 참조되며
유효성 검증기 함수라고 합니다.
사전의 컨텐츠는 사용자의 비즈니스 요구사항에 부합합니다.
- currency
- 문자열 형식의 3문자 통화 코드입니다. 많은 통화 코드 목록이 Dojo에서 지원됩니다. 다음 웹 사이트에서 ISO(International Organization for Standardization) 표준 4217을 참조하십시오.
- errorMessage
- 입력이 존재하지만 올바르지 않은 경우 표시되는 메시지입니다. 메시지는 사용자에게 제공되는 출력 필드에 표시됩니다.
- inputRequired
- 입력이 필수인지 여부를 표시하는 부울 값입니다. 이 경우 오류 메시지는
inputRequiredMessage 특성의 값입니다.
이 유효성 검증은 다른 것들보다 우선하지만 텍스트 상자가 초점을 잃은 후 초점을 얻은 후에만 활성입니다.
- inputRequiredMessage
- InputRequired 특성이 true이고 통화 텍스트 상자에 컨텐츠가 없으며
상자가 초점을 잃은 후 초점을 얻을 때 표시되는 문자열입니다. 메시지는 사용자에게 제공되는 출력 필드에 표시됩니다.
inputRequiredMessage 특성이 없는 경우 오류 메시지는 로케일에 맞는 "이 값은 필수입니다."입니다.
참고: Rich UI 편집기에서 사용되는 로케일을 설정하려면 "Rich UI 모양을 위한 환경 설정"의 언어 탭에 대한 지시사항을 참조하십시오. 배치 시에 런타임 로케일을 설정하려면 "EGL 배치 디스크립터에서 Rich UI 배치 항목 추가"를 참조하십시오. - placeholder
- 통화 텍스트 상자에 표시되지만 사용자가 필드를 클릭하자마자 제거되는 문자열입니다. 이 문자열은 상자가 비어 있고 사용자가 해당 필드에서 작업하지 않으면 다시 표시됩니다.
- promptMessage
- 사용자가 입력하도록 프롬프트하는 문자열입니다. 통화 텍스트 상자가 초점을 얻을 때 상자 옆에 제공되는 출력 필드에 이 문자열이 표시되며, 사용자가 컨텐츠를 추가하거나 변경하기 시작할 때까지 계속 표시됩니다. 문자열 위치를 추가로 설정하려면 tooltipPosition 특성을 설정하십시오.
- readOnly
- 통화 텍스트 상자가 사용자 입력으로부터 보호되는지 여부를 표시하는 부울 값입니다.
- selectOnClick
- 사용자가 통화 텍스트 상자의 외부에서 상자를 클릭하는 경우 발생하는 일을 나타내는 부울 값입니다.
- False(기본값)
- 통화 텍스트 상자의 컨텐츠가 선택되지 않습니다. 클릭 위치에 업데이트 커서가 표시됩니다.
- True
- 통화 텍스트 상자의 컨텐츠가 선택됩니다. 모든 후속 클릭은 클릭 위치에 업데이트 커서를 표시하며 통화 텍스트 상자의 컨텐츠는 더 이상 선택되지 않습니다.
- suppressChangeEvent
- 코드로 이 값을 true로 설정한 후 onChange 이벤트를 방지하는 부울 값입니다.
- validators
- 배열-요소 순서로 호출되는 유효성 검증기 함수의 배열입니다. 사용자의 입력이 주어진 함수에 유효성 검증을 전달한 경우
함수는 널 또는 공백의 리턴이 성공했음을 표시하며, 이 경우에만 배열의 다음 함수가 호출됩니다. 사용자의 입력이 유효성 검증을 전달하지 않은 경우
함수는 공백이 아닌 문자열 리턴의 실패를 표시합니다.
위젯이 초점을 잃을 때 유효성 검증기 시퀀스가 호출됩니다.
Dojo 통화 텍스트 상자가 제어기에 의해 참조되는 경우, 설명 중인 함수에서 완전히 분리되는 제어기 특정 유효성 검증기 함수를 코드할 수 있습니다. 제어기 특정 함수는 필드 특정 유효성 검증이 성공한 경우와 위젯이 초점을 잃은 후에만 호출됩니다.
제어기에 대한 세부사항은 "Rich UI 유효성 검증 및 형식화"를 참조하십시오.
각 필드 특정 유효성 검증기 함수는 다음 위임 파트를 준수합니다.Delegate Validator(input String in, constraints dictionary in) returns(string?) end- input
- 동일한 Dojo 통화 텍스트 상자에서 이전 키 입력의 문자를 포함한 사용자의 입력입니다.
- constraints
- 정규식을 생성하거나 유효성 검증기 함수 내부의 처리를 안내하는 데 사용되는 정보를 제공하는 사전입니다. 예를 들어, 사전은 사용자의 보안 레벨을 지정할 수 있습니다.
- string?
- 널 또는 공백(오류가 발생하지 않은 경우)이거나 공백이 아닌 문자열(오류가 발생했음을 표시)입니다.
유효성 검증기에서 DojoLib 라이브러리가 제공하는 하나 이상의 함수를 호출할 수 있습니다.
- value
- 통화 기호가 없는 숫자 값입니다.
다음 함수는 "Rich UI 유효성 검증 및 형식화"에 나열된 것처럼 보기 레벨 유효성 검증을 지원하는 EGL Dojo 위젯 유형에 특정합니다.
- getValidState
- 온전히 내부용입니다.
- showErrorIndicator
- 위젯에서 오류 표시기를 설정하거나 지우는 부울 값을 승인합니다. 함수 프로토타입은 다음과 같습니다.
function showErrorIndicator(aboolean boolean in); - showErrorMessage
- 위젯 근처의 오류 메시지 도구 팁에 표시할 오류 메시지를 승인합니다. 도구 팁은 위젯이 초점을 얻을 때
표시되고 위젯이 초점을 잃을 때 숨겨집니다. 함수 프로토타입은 다음과 같습니다.
function showErrorMessage(msg string in);
지원되는 다른 특성 및 함수는 "위젯 특성 및 함수"와 "위젯 스타일"에서 설명합니다.
