DojoTimeTextBox
DojoTimeTextBox 위젯은 시간 값을 포함하는 텍스트 상자를 정의합니다. 이 위젯은 Dojo dijit.form.TimeTextBox 정의를 기반으로 합니다.
사용자가 위젯을 클릭하면 시간 그래픽 목록인 시간 선택 메뉴가 제공됩니다. 사용자는 나열된 시간을 선택하여 상자에 표시된 값을 업데이트할 수 있습니다.
visibleIncrement와 visibleRange 특성을 설정하여 시간 선택 메뉴를 사용자 정의하고 value와 timePattern 특성을 설정하여 시간 텍스트 상자에 표시되는 시간 값을 사용자 정의할 수 있습니다.
- constraints
- 사용자 입력을 차례로 유효성 검증하는 함수를 호출하는 동안 인수로 사용되는 사전입니다.
해당 함수는 validators 특성에서 참조되며
유효성 검증기 함수라고 합니다.사전의 컨텐츠는 사용자 비즈니스 요구사항에 적합합니다. 다음은 지정 예입니다.
constraints = new Dictionary{minimumHour = "11:30 AM"}};이 경우 사용자가 오전 11:30 미만으로 시간을 지정하면 유효성 검증기 함수에서 오류 메시지를 리턴할 수 있습니다.
- errorMessage
- 입력이 있지만 올바르지 않은 경우 표시되는 메시지입니다. 메시지는 사용자에게 제공되는 출력 필드 또는 도구 팁에 표시됩니다.
- inputRequired
- 입력이 필요한지 여부를 나타내는 부울 값입니다. 이 경우 오류 메시지는 inputRequiredMessage 특성의 값입니다.
이 유효성 검증은 다른 검증에 우선하지만 포커스가 유실된 상태였다가 포커스를 획득한 후에만 활성화됩니다.
- inputRequiredMessage
- InputRequired 특성이 true이고, 시간 텍스트 상자에 컨텐츠가 없으며, 포커스가 유실된 상태였다가 해당 상자가 포커스를 획득한 경우 표시되는 문자열입니다.
메시지는 사용자에게 제공되는 출력 필드 또는 도구 팁에 표시됩니다.
inputRequiredMessage 특성이 없는 경우 오류 메시지는 로케일에 맞게 다음 문자열로 표시됩니다. "이 값은 필수입니다".
- placeholder
- 시간 텍스트 상자에 표시되지만 사용자가 박스를 클릭하는 즉시 제거되는 문자열입니다. 상자가 비어 있고 사용자가 해당 상자에서 작업하지 않을 때마다 시간 텍스트 상자에 문자열이 다시 표시됩니다.
- promptMessage
- 사용자 입력을 프롬프트하는 문자열입니다. 시간 테스트 상자가 포커스를 획득한 경우 사용자에게 제공되는 도구 팁의 상자 옆에 문자열이 표시되고 사용자가 컨텐츠를 추가 또는 변경하려고 시작하기 전까지 계속해서 표시됩니다. 추가적으로 문자열 위치를 설정하려면 tooltipPosition 특성을 설정하십시오.
- readOnly
- 사용자 입력으로부터 시간 텍스트 상자를 보호할지 여부를 나타내는 부울 값입니다.
- selectOnClick
- 시간 텍스트 상자 외부에서 상자 안으로 클릭하면 발생하는 상황을 나타내는 부울 값입니다.
- False(기본값)
- 시간 텍스트 상자의 컨텐츠가 선택되지 않습니다. 업데이트 커서는 클릭 위치에 표시됩니다.
- True
- 시간 텍스트 상자의 컨텐츠가 선택됩니다. 이후에 클릭하면 클릭 위치에 업데이트 커서가 표시되고 시간 텍스트 상자의 컨텐츠가 더 이상 선택되지 않습니다.
- suppressChangeEvent
- 코드에서 이 값을 true로 설정한 후 onChange 이벤트를 방지하는 부울 값입니다.
- text
- 사용 중인 기본 형식과 일치하도록 형식화된 문자열입니다. 위젯 선언에서 특성을 설정하는 경우 문자열은 defaultTimeFormat 빌드 디스크립터
옵션 설정과 일치해야 합니다. 런타임 시 특성을 설정하는 경우 문자열은 defaultTimeFormat
빌드 디스크립터 옵션의 기본값인 StrLib.defaultTimeFormat
시스템 함수의 설정과 일치해야 합니다.
defaultTimeFormat 옵션의 기본값은 HH:mm:ss입니다.
- timePattern
- 시간이 표시되는 방식을 나타내는 문자열 상수입니다.
- TIMEBOX_FORMAT_12HR
- 오전 12:00에서 오전 11:59 사이에 그리고 오후 12:00에서 오후 11:59 사이로 형식화된 시간을 표시합니다.
- TIMEBOX_FORMAT_24HR
- 24시간(군용) 시간을 표시합니다.
- validators
- 배열 요소 순서대로 호출되는 유효성 검증기 함수의 배열입니다. 사용자 입력이 주어진 함수에서 유효성 검증을 통과하면
함수에서 널 또는 공백을 리턴하여 성공을 표시합니다. 이러한 경우에만 배열의 다음 함수가 호출됩니다.
사용자 입력이 유효성 검증을 통과하지 않으면 함수에서 공백이 아닌 문자열을 리턴하여 실패를 표시합니다.
위젯에서 포커스가 유실된 경우 유효성 검증기의 시퀀스가 호출됩니다.
제어기에서 Dojo 시간 텍스트 상자를 참조하는 경우 설명 중인 함수에서 완전히 분리된 제어기 특정 유효성 검증기 함수를 코드할 수 있습니다. 필드 특정 유효성 검증이 성공하고 위젯에서 포커스가 유실된 경우에만 제어기 특정 함수가 호출됩니다.
제어기의 세부사항에 대해서는 "Rich UI 유효성 검증 및 형식화”를 참조하십시오.
각 필드 특정 유효성 검증기 함수는 다음 위임 파트를 따릅니다.Delegate Validator(input String in, constraints dictionary in) returns(string?) end- input
- 사용자의 입력입니다.
- constraints
- 정규식을 구성하거나 유효성 검증기 함수 내에서의 처리를 안내하는 데 사용되는 정보를 제공하는 사전입니다. 예를 들면 사전은 사용자의 보안 레벨을 지정할 수 있습니다.
- string?
- 널 또는 공백(오류가 발생하지 않은 경우) 또는 공백이 아닌 문자열(오류가 발생했음을 나타냄)입니다.
유효성 검증기로부터 DojoLib 라이브러리에 제공된 하나 이상의 함수를 호출하려고 할 수 있습니다.
- value
- 시간 변수(그러나 자동 변환에서 문자열 사용을 허용함)입니다.
- visibleIncrement
- 시간 선택 메뉴에서 표시되는 증분입니다. 또한 시간의 그래픽 목록입니다.
다음 상수 중 하나입니다.
- TIMEBOX_ONE_QUARTER(기본값, 15분 증분 표시)
- TIMEBOX_FIVE_MINUTES
- TIMEBOX_HALF_HOUR
- TIMEBOX_ONE_HOUR
- TIMEBOX_TWO_HOURS
- TIMEBOX_THREE_HOURS
- TIMEBOX_FIVE_HOURS
- TIMEBOX_TEN_HOURS
- TIMEBOX_TWELVE_HOURS
- TIMEBOX_FULL_DAY(24시간 증분 표시)
- visibleRange
- 시간 선택 메뉴에서 표시할 시간 범위입니다. 필요한 경우 다른 시간대로 스크롤할 수 있습니다. 이 상수는 visibleIncrement 특성의 상수와 같습니다.
- getValidState
- 내부에서 단독으로 사용됩니다.
- showErrorIndicator
- 위젯에서 오류 표시기를 설정하거나 지우는 부울 값을 승인합니다. 다음은 함수 프로토타입입니다.
function showErrorIndicator(aboolean boolean in); - showErrorMessage
- 위젯 근처의 오류 메시지 도구 팁에서 표시할 오류 메시지를 승인합니다. 도구 팁은 위젯이 포커스를 획득한 경우 표시되고 포커스가 유실된 경우 숨겨집니다. 다음은 함수 프로토타입입니다.
function showErrorMessage(msg string in);
기타 지원되는 특성과 함수는 “위젯 특성 및 함수”와 “위젯 스타일”에서 설명됩니다.