플로팅 메뉴 | 화면 구성, 팝업, 네비게이션 | Appbox SDK 가이드
플로팅 메뉴
화면 우측 하단에 고정된 플로팅 버튼을 만들고, 메뉴를 터치하면 서브 메뉴가 확장돼요. 플로팅 메뉴 아이콘도 자유롭게 커스터마이징할 수 있습니다.
플로팅 메뉴 노출하기
AppboxSDK.gmenu.openFloatingMenu(...)
Javascript
1
// 플로팅 메뉴 오픈
2
AppboxSDK.gmenu.openFloatingMenu(
3
{
4
icon: "https://www.appboxapp.com/app/floating00.png",
5
menu: [
6
{
7
icon: "https://www.appboxapp.com/app/floating01.png",
8
action: "temp"
9
},
10
{
11
icon: "https://www.appboxapp.com/app/floating02.png",
12
action: "testFunction"
13
}
14
],
15
}, (err, data) => {
16
if (err) {
17
console.error(
"플로팅 메뉴 실패:",
"code:", err.code,
"message:", err.message
);
18
} else {
19
console.log(
"플로팅 메뉴 OK:",
data.result
);
20
}
21
});
플로팅 메뉴 닫기
AppboxSDK.gmenu.closeFloatingMenu()
Javascript
1
// 플로팅 메뉴 숨김
2
AppboxSDK.gmenu.closeFloatingMenu();
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() 를 부르세요.