모달 페이지 오픈 | 화면 구성, 팝업, 네비게이션 | 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).