앱 화면, 팝업, 네비게이션 구성 가이드 | Appbox SDK
화면 구성•팝업•네비게이션
이미지 뷰어
전체 화면으로 전환해 이미지를 더 크게 볼 수 있으며, 여러 장의 이미지는 스와이프 방식으로 자연스럽게 넘기며 탐색할 수 있습니다. 이 기능은 상품 상세 이미지, 갤러리, 이벤트 안내 등 시각 정보가 중요한 화면에 활용하기 좋습니다.
이미지 뷰어 오픈
Request 항목 정의
| Response 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| item[].imageUrl | 필수 | 노출할 이미지 URL | ||
| selectColor | - | 선택된 이미지 테두리 칼라값 | #FFFFFF | |
item 배열 데이터는 메뉴 갯수만큼 등록하며, 최소 한개는 필수 입니다.
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
PDF 뷰어
대용량 PDF도 안정적으로 표시하며, 확대, 축소, 스크롤 등 기본 기능을 제공해 문서를 편하게 읽을 수 있습니다. 공지사항, 이용약관, 매뉴얼, 티켓, 안내서 등 PDF 형식의 자료를 앱 내에서 바로 확인할 수 있어 활용도가 높습니다.
PDF 뷰어로 문서 보기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| pdfUrl | 필수 | 뷰어로 보여줄 PDF의 URL | ||
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
모달 페이지 오픈
전체 화면 이동 없이 필요한 정보나 추가 기능을 표시할 수 있어, 사용자 흐름을 유지한 채 설정, 상세 안내, 폼 입력 등 다양한 작업을 처리할 수 있습니다.
앱 내 새로운 페이지 열기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| openURL | 필수 | 새로운 모달 페이지로 오픈할 페이지 URL | ||
| title | - | 타이틀 (Android에서만 노출) | ||
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
모달은 화면 아래에서 올라오는 시트로 열리며 닫기 버튼이 없습니다. 아래로 쓸어 닫습니다(Android 는 뒤로 가기, 바깥 터치도). 모달 안의 웹에서 모달을 닫거나 원래 페이지로 값을 돌려줄 방법은 없고, 원래 페이지는 닫힐 때 data.result: true 만 받습니다. http, https 공개 주소만 열 수 있습니다(아니면 -1004).
탭 메뉴
화면 하단에 네이티브 탭 메뉴를 생성하여 아이콘과 텍스트를 자유롭게 설정할 수 있습니다. 스크롤 동작에 따라 탭 메뉴를 동적으로 숨기거나 표시할 수 있으며, 항상 고정된 탭 메뉴로 사용자에게 안정감을 제공합니다.
탭메뉴 열기
탭메뉴 닫기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| backColor | - | 백그라운드 칼라 | #FFFFFF | |
| fontSize | - | 폰트 사이즈 | 11 | |
| defTextColor | - | 메뉴 기본 텍스트 칼라 | #000000 | |
| selTextColor | - | 선택 되었을때 텍스트 칼라 | #999999 | |
| autoHidden | - | 자동숨김 (true, false) : 스크롤 시 자동숨김 | true | |
| haptic | - | 메뉴 터치시 진동 햅틱 (true, false) | true | |
| menu | text | - | 메뉴명 | |
| defIcon | - | 메뉴 기본 아이콘 URL | ||
| selIcon | - | 메뉴 선택 아이콘 URL | ||
| action | 필수(탭메뉴 열기) | 이동할 URL, 또는 호출할 javascript 함수명을 입력, 예) functionName | ||
탭메뉴 열기 일때, menu 배열 데이터는 메뉴 갯수만큼 등록하며, 최소 한개는 필수 입니다. menu 배열중 action 항목은 필수입니다.
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
햄버거 메뉴
네이티브 햄버거 메뉴를 상황에 맞게 동적으로 생성할 수 있으며, 프로필 사진과 아이콘을 포함할 수 있습니다. 메뉴 항목도 필요에 따라 완전히 커스터마이징할 수 있습니다.
햄버거 메뉴 띄우기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| direction | 필수 | 노출 위치 선택 (left, right) | right | |
| profileText | 필수 | 프로파일 텍스트 | ||
| profileTexColor | - | 프로파일 텍스트 칼라 | #000000 | |
| profileIcon | - | 프로파일 아이콘 이미지 URL | ||
| profileFontSize | - | 프로파일 텍스트 사이즈 | 17 | |
| profileAction | - | 프로파일 터치시 이동 URL | ||
| backColor | - | 백그라운드 칼라 | #FFFFFF | |
| fontSize | - | 메뉴 폰트 사이즈 | 14 | |
| defTextColor | - | 메뉴 기본 텍스트 칼라 | #000000 | |
| selTextColor | - | 선택되었을때 텍스트 칼라 | #999999 | |
| haptic | - | 메뉴 터치시 진동 햅틱 (true, false) | true | |
| menu | text | 필수 | 메뉴명 | |
| defIcon | - | 메뉴 기본 아이콘 URL | ||
| selIcon | - | 메뉴 선택 아이콘 URL | ||
| action | 필수 | 이동할 URL, 또는 호출할 javascript 함수명을 입력, 예) functionName | ||
menu 배열 데이터는 메뉴 갯수만큼 등록하며, 최소 한개는 필수 입니다.
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
브라우저 메뉴
사용자는 뒤로 가기, 앞으로 가기, 새로고침 등 핵심 웹 탐색 기능을 빠르게 사용할 수 있어, 웹뷰 환경에서도 익숙하고 편리한 탐색 경험을 제공합니다.
브라우저 메뉴 오픈
브라우저 메뉴 닫기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| visible | 필수 | 노출여부 (true, false) : false 이면 이후 항목은 모두 비필수 | true | |
| backColor | - | 백그라운드 칼라 | #FFFFFF | |
| autoHidden | - | 자동 숨김 (true, false) | true | |
| haptic | - | 메뉴 터치시 진동 햅틱 (true, false) | true | |
| menu | function | 필수 | 기능 (back:백 버튼, forward:앞 버튼, home:홈버튼, refresh:새로고침, share:공유버튼) | |
| icon | - | 기본으로 노출되는 아이콘이 있으며,커스텀으로 변경하고 싶을때 아이콘 URL 입력 | ||
menu 배열 데이터는 메뉴 갯수만큼 등록하며, 최소 한개는 필수 입니다.
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
플로팅 메뉴
화면 우측 하단에 고정된 플로팅 버튼을 만들고, 메뉴를 터치하면 서브 메뉴가 확장돼요. 플로팅 메뉴 아이콘도 자유롭게 커스터마이징할 수 있습니다.
플로팅 메뉴 노출하기
플로팅 메뉴 닫기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| icon | 필수 | 화면에 떠 있는 플로팅 버튼 자체의 이미지 주소(http, https). 누르면 아래 menu 항목이 펼쳐지고 접힙니다. 60×60 원형으로 잘리니 정사각형 이미지를 권합니다. 이미지를 불러오지 못하면 빈 버튼이 됩니다. | ||
| haptic | - | 메뉴 터치시 진동 햅틱 (true, false) | true | |
| menu[].icon | 필수 | 노출할 아이콘 이미지 주소(http, https). 40×40 원형으로 표시됩니다. 틀리면 콜백 없이 바로 오류를 던집니다. 자세한 내용은 공통 규칙 › 결과 받는 법을 보세요. | ||
| menu[].action | - | 이동할 URL, 또는 호출할 javascript 함수명을 입력, 예) functionName 또는 https://example.com | ||
menu 배열 데이터는 메뉴 갯수만큼 등록하며, 최소 한개는 필수 입니다.
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
노출 여부(visible)는 SDK 가 넣으니 넘기지 않습니다. 닫을 때는 gmenu.closeFloatingMenu() 를 부르세요.