validate 이벤트 핸들러

validate 함수는 보기의 데이터로 인해 발생하는 유효성 검증 오류를 처리합니다.

사용량

validate 함수에는 데이터에 문제점이 있다는 표시기 또는 다른 알리미를 표시하기 위한 로직이 있습니다. 프레임워크는 해당되는 하위 보기에서 validate 함수를 호출하기 전에 상위 보기에서 validate 함수로 시작합니다.

validate 이벤트 핸들러는 사용자 정의 오류 시각화 및 동작을 제공하려는 경우를 위한 것입니다. 프리젠테이션 로직의 예제에 대해서는 재고 제어를 참조하십시오. 예를 들어, 텍스트 재고 제어는 색상을 변경하고 올바르지 않은 데이터가 있는 경우 오류 아이콘을 표시합니다. 오류 아이콘에는 오류 상태와 연관되는 메시지를 표시하는 풍선 도움말이 있습니다.

이벤트 오브젝트

validate 함수는 단일 이벤트 오브젝트를 사용합니다. 이벤트 오브젝트의 유형은 error 또는 clear입니다. error 이벤트는 유효성 검증 서비스 또는 스크립트가 하나 이상의 오류를 발견했고 보기는 오류를 처리하여 적절한 시각화를 표시해야 함을 의미합니다. clear 이벤트는 보기가 이전 error 이벤트로 인해 발생된 시각화를 제거해야 함을 의미합니다.

error 이벤트에는 두 개의 오류 오브젝트 목록이 있을 수 있습니다. 하나의 목록 이름은 errors이고, 다른 목록은 errors_subscription입니다. 비즈니스 오브젝트에 바인드되는 보기는 자동으로 오류를 수신합니다. 또한 동일한 비즈니스 오브젝트에 바인드되는 모든 종속 보기에 대해 오류를 자동으로 수신합니다.

표 1. 오류 목록에 있는 오류 오브젝트의 특성
특성 유형 설명
binding String 현재 보기의 데이터 바인딩에 상대적인 데이터 바인딩에 대한 경로를 포함합니다.
message String 오류를 설명하는 자국어 메시지가 있습니다.
view_dom_ids[] String[List] 동일한 오류 메시지를 수신하는 보기의 DOM ID 목록을 포함합니다. 이 목록은 현재 보기와 그 종속 보기 중 임의의 보기를 포함할 수 있습니다.
subscribeValidation()를 호출하는 보기는 errors_subscription 목록의 특정 오류를 수신합니다. 이러한 오류는 현재 보기와 다른 비즈니스 오브젝트에 바인드되는 종속 보기에서 발생합니다. 데이터 바인딩이 없는 보기(예: 탭 재고 제어)는 오류를 수신하기 위해 subscribeValidation()를 호출해야 합니다.
표 2. errors_subscription 목록에 있는 오류 오브젝트의 특성
특성 유형 설명
messages String[List] 자국어 오류 메시지의 목록이 있습니다.
view_dom_id String 올바르지 않은 데이터가 있는 보기의 DOM ID를 포함합니다.
error 이벤트 오브젝트는 다음 예제와 유사합니다.
type: "error",
errors: 
	[
		{
			binding: "birthday.year"
			message: "The year you entered, 2013, is after current year of 2012.",
			view_dom_ids: ["domId_ProfileView", "domId_yearView"]
		}
	]
errors_subcription: 
	[
		{
			view_dom_id: "domId_accountView",
			messages: ["Enter your account number."]
		}
	]

clear 이벤트 오브젝트에는 특성이 없습니다. 보기는 clear 오브젝트를 사용하여 지금은 올바른 데이터가 있는 보기에 대한 오류 표시기를 제거합니다.