로딩 인디케이터 | 사용자 경험, 알림, 인터랙션 | Appbox SDK 가이드

로딩 인디케이터

화면이 로딩되는 동안 진행 상황을 보여주는 인디케이터를 추가하세요.
웹페이지 로딩 시 웹페이지의 로딩 상태를 시각적으로 표시하는 애니메이션을 지원합니다. 화면이 진행중 일때 다른 터치로 인해 오작동을 막고, 웹페이지가 확실히 실행되고 있다는 신뢰를 줄 수 있습니다.

로딩 인디케이터

AppboxSDK.application.loadingShow(...)

Javascript
1 // 로딩 인디케이터
2 AppboxSDK.application.loadingShow(
3 {
4 loadingIcon: "https://www.appboxapp.com/app/load0.gif",
5 sizePercentage: 30,
6 backColor: "#4D000000"
7 }, (err, data) => {
8 if (err) {
9 console.error( "로딩 실패:", "code:", err.code, "message:", err.message );
10 } else {
11 console.log( "로딩 표시 OK:", data.result );
12 }
13 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
loadingIcon 필수 로딩시 노출될 gif 이미지 URL
sizePercentage 필수 아이콘 크기(화면 가로 폭 대비 %)
backColor - 로딩 아이콘이 뜰 때 화면을 덮는 배경색. #RRGGBB 또는 투명도를 넣은 #AARRGGBB(투명도가 앞, 예: #4D000000 = 검정 30%). iOS 는 이 두 형식 외에는 불투명 검정이 됩니다 #1A000000(검정 10%)

로딩 인디케이 아이콘 이미지는 한번 다운로드 받은 후 앱내 저장되어 다시 변경전까지 사용됩니다.



Response 항목 정의

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

로딩 설정은 저장돼 이후 페이지를 이동할 때마다 뜹니다. 페이지 로드가 끝나거나(실패 포함) 10초가 지나면 사라지며, 웹에서 닫는 함수는 없습니다. iOS 는 호출할 때 1.5초 미리보기로 보여 주고 화면만 바뀌는 SPA 전환(pushState)에는 뜨지 않습니다. Android 는 호출하면 바로 뜨고, 당겨서 새로고침하거나 다른 로딩 표시로 바뀔 때도 사라집니다.






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