Popup

Properties

Property	Type	Default	Description
modal	boolean	false	모달 팝업 표시 여부입니다.
contentAlign	AnchorAlign		content 기준으로 정렬할 방향을 지정합니다. 가능한 값: 'left top', 'left center', 'left bottom', 'right top', 'right center', 'right bottom', 'center'.
coordinateMode	'global'|'relative'|'none'	'relative'	팝업의 좌표 시스템을 설정합니다.
anchor	string|HTMLElement		팝업이 열릴 상대적 위치를 지정합니다. 기본값은 body입니다.
anchorAlign	AnchorAlign		anchor 기준으로 정렬할 방향을 지정합니다. 가능한 값: 'left top', 'left center', 'left bottom', 'right top', 'right center', 'right bottom', 'center'.
offsetX	number	0	팝업 X 위치 변경 (픽셀 단위).
offsetY	number	0	팝업 Y 위치 변경 (픽셀 단위).
lockOutside	boolean	false	컨텐츠가 뷰포트 바깥 영역으로 나감을 방지합니다.
alwaysOnTop	boolean	false	z-index 항상 최상위 위치에 팝업을 배치합니다.
priority	number	0	다중 팝업이 열려있을 때 z-index 우선순위를 정의합니다.
nest	boolean	true	중첩된 팝업 구조를 관리합니다.
autoFocus	boolean	true	팝업 열릴 때 자동으로 컨텐츠에 포커스를 설정합니다.
focusTarget	string|HTMLElement		autoFocus가 true인 경우 포커스가 설정될 요소입니다.
hitAreas	Array<HTMLElement>	[]	외부 영역 클릭 시 자동 닫기 방지를 위한 유효 영역을 설정합니다.
closeOnOutsideDown	boolean	false	외부 영역 다운 시 팝업을 닫습니다.
closeOnEscape	boolean	false	ESC 입력 시 팝업을 닫습니다.
closeOnEvents	Array<string>	['close']	특정 이벤트 발생 시 팝업을 닫습니다.
openDelay	number	0	팝업 열릴 때 지연 시간 (ms).
closeDelay	number	0	팝업 닫힐 때 지연 시간 (ms).
openOnTrigger	AnchorTrigger		앵커 엘리먼트의 'click' 또는 'over' 이벤트 발생 시 자동으로 팝업을 엽니다.

Methods

Method	Parameters	Description
open	data?: any	팝업을 엽니다. opening과 opened 콜백 함수의 인자로 사용됩니다.
close	reason?: any	팝업을 닫습니다. closing과 closed 콜백 함수의 인자로 사용됩니다.
opening	(callback: (content: HTMLElement, data: any) => void) => PopupMethods	팝업이 열리기 전에 호출됩니다.
opened	(callback: (content: HTMLElement, data: any) => void) => PopupMethods	팝업이 완전히 열린 후 호출됩니다. open 메소드의 데이터가 콜백 함수의 인자가 됩니다.
closing	(callback: (reason: any) => void) => PopupMethods	팝업이 닫히기 직전에 호출됩니다. close 메소드의 데이터가 reason 값이 됩니다.
closed	(callback: (reason: any) => void) => PopupMethods	팝업이 닫힐 때 호출됩니다. close 메소드의 데이터가 reason 값이 됩니다.
toggle	data?: any	팝업의 열림/닫힘 상태를 전환합니다.
invalidate		팝업의 위치를 갱신합니다.
destroy		이 인스턴스와 관련된 모든 구성 요소를 제거합니다.

Events

Event	Type	Description
open	(event: Event) => void	팝업이 열릴 때 호출됩니다.
close	(event: Event) => void	팝업이 닫힐 때 호출됩니다.
cancel-open	(event: Event) => void	팝업 열기를 취소할 때 호출됩니다.
cancel-close	(event: Event) => void	팝업 닫기를 취소할 때 호출됩니다.