플로팅 메뉴 | 화면 구성, 팝업, 네비게이션 | 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() 를 부르세요.






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