네이티브 유형과 기본 동작
ScriptInterface는 Context, Element, RmlEvent의 형식화된 기본 클래스이며 독립적인 네이티브 생성 진입점은 없습니다. ScriptInterface.getStaticClassIdentifier()는 실제 네이티브 기본 토큰을 반환합니다. 네이티브 Event는 같은 토큰을 상속하므로 RmlEvent.getStaticClassIdentifier()도 같은 값입니다. 요소는 자체 토큰을 가지며 ScriptInterface 기본 클래스에 대한 isClass 검사도 통과합니다.
getScriptObject()는 유효한 객체의 네이티브 가상 메서드를 호출합니다. 상위 기본 구현은 미등록 컨텍스트, 요소와 이벤트에서 null을 반환합니다. setScriptObject(object)는 관리되는 호스트 연결을 등록하고 null은 연결을 해제합니다. JS 상속만으로 네이티브 스크립트를 생성하지 않습니다. 스크립트 객체도 참고하세요. 이벤트 RTTI 및 스크립트 조회에는 유효한 소유 이벤트 또는 현재 콜백의 빌린 이벤트가 필요합니다. 요소 파괴, 소유 이벤트 해제, 콜백 반환 및 종료 후의 네이티브 조회는 거부합니다. 보관한 이벤트 스냅샷은 읽을 수 있습니다. release()는 구체 클래스의 기존 생성 및 소유권 규칙을 유지합니다.
Element.getStaticClassIdentifier()는 래퍼에 해당하는 네이티브 유형의 불투명한 ClassIdentifier 심볼을 반환합니다. 내보낸 모든 요소 하위 클래스가 상속합니다. JS 전용 하위 클래스는 가장 가까운 등록된 네이티브 기본 유형을 사용합니다. 정적 토큰은 초기화 전에도 얻을 수 있으며 같은 모듈의 런타임 재시작 후에도 유효합니다. 직렬화하거나 문자열에서 직접 만들 수 없습니다.
element.getClassIdentifier()는 실제 네이티브 유형을 조회하고, element.isClass(token)은 상속 관계를 확인합니다. 파괴된 요소는 거부합니다. 토큰은 포인터 주소를 노출하거나 요소의 수명을 연장하지 않습니다. 전용 래퍼가 없는 네이티브 하위 유형도 Element로 감싸져 있어도 별도의 토큰을 갖습니다. RML 태그와 JS 프로토타입은 네이티브 유형을 결정하지 않습니다.
const controlType = rmlui.ElementFormControl.getStaticClassIdentifier();
if (element.isClass(controlType)) {
// The native element derives from ElementFormControl.
}element.processDefaultAction(event)는 입력 및 탭 구현을 포함한 가상 Rml::Element::ProcessDefaultAction을 호출합니다. 해당 요소의 리스너에서 동기적으로 호출해야 하며 수신자는 유효한 이벤트의 currentTarget과 같아야 합니다. 리스너가 반환하면 저장한 이벤트는 만료되며 같은 발송의 다른 리스너에서도 사용할 수 없습니다.
tabs.addEventListener('click', event => {
event.stopPropagation();
tabs.processDefaultAction(event);
});이 예제는 탭 클릭 동작을 수동으로 한 번 실행합니다. 단계, 대상, 매개변수, 전파 상태를 유지하며 전파가 중단되어도 명시적인 호출은 동작합니다. 수동 실행은 후속 자동 동작을 취소하지 않습니다. 수동으로만 실행하려면 중단 가능한 이벤트에서 stopPropagation()을 호출합니다. 중단 불가능한 이벤트의 자동 동작은 멈출 수 없습니다.
순차 호출은 부작용을 반복하며 체크박스는 두 번 전환될 수 있습니다. 같은 이벤트의 수동 동작 실행 중 재진입은 거부합니다. 별도의 중첩 이벤트는 자체 동작을 실행할 수 있습니다. 기존 요소 및 콜백 수명 보호는 유지되며 리스너 예외는 가장 바깥쪽 네이티브 호출 경계에서 전달됩니다.