Nexacro Form Previewer

투비소프트(TOBESOFT)의 Nexacro 및 NexaLAP의 Form 파일(*.xfdl)을 VS Code, Antigravity, TheiaIDE 등에서 렌더링하여 디자인을 확인할 수 있는 확장 프로그램입니다.

주요 기능 (Features)

1. Form 미리보기

• xfdl 파일을 열고 단축키(Ctrl + Shift + V) 또는 명령어를 통해 즉시 미리보기 패널을 활성화할 수 있습니다.

2. Nexacro 스타일(XCSS) 적용

• 프로젝트 연동: 프로젝트 파일(.xprj)과 연동하여 실제 프로젝트에서 정의된 테마와 XCSS 스타일을 그대로 적용합니다.
• 컴포넌트 스타일 해석: -nexa-icon, -nexa-border, -nexa-padding, -nexa-icon-position 등 Nexacro 전용 스타일 속성을 해석하여 실제와 유사한 디자인을 제공합니다.
• 이미지 리소스 지원: theme://images/... 및 imagerc::... 형태의 이미지 경로를 자동으로 변환하여 아이콘과 이미지 컴포넌트를 보여줍니다.

3. 다양한 컴포넌트 렌더링 지원

• 주요 컴포넌트 지원: Static, Edit, Button, CheckBox, Combo, Radio, Calendar, MaskEdit, TextArea, ImageViewer, Div, View, Tab, Grid 등 14종 이상의 컴포넌트를 지원합니다.
• 복잡한 레이아웃: 절대 좌표, 퍼센트(%), 상대 좌표(comp:offset), right/bottom 기반 배치 등 Nexacro의 모든 좌표 시스템을 정확하게 해석합니다.
• 그리드(Grid) 시각화: 헤더 셀 병합, 밴드 구조 등 복잡한 그리드 레이아웃을 실제와 유사하게 렌더링합니다.

4. 이벤트 시각화 및 스크립트 이동

• 이벤트 목록 표시: 컴포넌트에 연결된 다양한 이벤트(onclick, onchanged 등)를 미리보기 화면에서 한눈에 확인할 수 있습니다.
• 인터랙티브 하이라이트: 마우스 오버 시 이벤트 태그가 선명하게 강조되며 최상단으로 노출되어 식별이 용이합니다.
• 스크립트 바로가기: 이벤트 태그를 클릭하면 해당 이벤트 핸들러 함수가 정의된 소스 코드 위치로 즉시 이동합니다.

5. Invisible Object 및 OutlineView 용 사이드바

• Invisible Object: Dataset 등 화면에 보이지 않는 오브젝트들을 우측 사이드바(Invisibles 탭)에서 확인할 수 있습니다.
• OutlineView: 화면에 표시되는 컨테이너 및 컴포넌트 계층을 트리 구조의 Outline 탭에서 확인할 수 있습니다.

6. 줌(Zoom) 기능 및 전용 툴바

• 자유로운 배율 조절: 20%부터 300%까지 세밀한 확대/축소를 지원합니다.
• 편리한 조작: 상단 전용 툴바의 버튼, 슬라이더, 드롭다운 메뉴를 이용하거나 Ctrl + 마우스 휠을 통해 직관적으로 조작할 수 있습니다.

사용 방법 (Usage)

1. 미리보기 실행

• 방법 1: xfdl 파일을 열고 단축키 Ctrl + Shift + V를 누릅니다.
• 방법 2: 탐색기에서 xfdl 파일을 선택후 마우스 우클릭 팝업메뉴에서 Nexacro: Form 미리보기를 선택합니다.
• 방법 3: xfdl 파일을 열고 우측 상단의 Nexacro: Form 미리보기 버튼을 클릭합니다.
• 방법 4: 명령 팔레트(F1 또는 Ctrl + Shift + P)에서 Nexacro: Form 미리보기 명령을 실행합니다.

2. 프로젝트 연결 (최초 1회)

• 처음 실행 시 사용 중인 Nexacro 프로젝트 파일(.xprj)을 선택하는 창이 나타납니다.
• 프로젝트를 연결하면 해당 프로젝트의 테마와 리소스(이미지 등)를 자동으로 로드하여 더 정확한 디자인을 보여줍니다.
• 설정 버튼(톱니바퀴)을 통해 언제든지 연결된 프로젝트를 변경하거나 초기화할 수 있습니다.

지원 컴포넌트 목록 (Supported Components)

제한 사항 (Limitations)

• 스크립트 실행 불가: 파일 내 선언된 JavaScript(Script 섹션)는 보안 및 안정성을 위해 실행되지 않습니다. (정적 레이아웃 미리보기 중심)
• 일부 특수 컴포넌트: Menu, ListView 등 일부 복합 컴포넌트는 향후 업데이트 예정입니다.