모달 페이지 오픈 | 화면 구성, 팝업, 네비게이션 | Appbox SDK 가이드

모달 페이지 오픈

현재 화면 위에 새로운 모달 형태의 웹페이지를 띄울 수 있는 기능입니다.
전체 화면 이동 없이 필요한 정보나 추가 기능을 표시할 수 있어, 사용자 흐름을 유지한 채 설정, 상세 안내, 폼 입력 등 다양한 작업을 처리할 수 있습니다.

앱 내 새로운 페이지 열기

AppboxSDK.ui.modalPageOpen(...)

Javascript
1 // 모달 페이지 오픈
2 AppboxSDK.ui.modalPageOpen(
3 {
4 openURL: "https://www.google.com",
5 title: "프로모션"
6 }, (err, data) => {
7 if (err) {
8 console.error( "모달 오픈 실패:", "code:", err.code, "message:", err.message );
9 } else {
10 console.log( "모달 오픈 OK:", data.result );
11 }
12 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
openURL 필수 새로운 모달 페이지로 오픈할 페이지 URL
title - 타이틀 (Android에서만 노출)


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)

모달은 화면 아래에서 올라오는 시트로 열리며 닫기 버튼이 없습니다. 아래로 쓸어 닫습니다(Android 는 뒤로 가기, 바깥 터치도). 모달 안의 웹에서 모달을 닫거나 원래 페이지로 값을 돌려줄 방법은 없고, 원래 페이지는 닫힐 때 data.result: true 만 받습니다. http, https 공개 주소만 열 수 있습니다(아니면 -1004).






www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.