로딩 인디케이터 | 사용자 경험, 알림, 인터랙션 | 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 는 호출하면 바로 뜨고, 당겨서 새로고침하거나 다른 로딩 표시로 바뀔 때도 사라집니다.