핀치 줌 | 사용자 경험, 알림, 인터랙션 | Appbox SDK 가이드
핀치 줌
boolean 값 하나로 웹뷰의 확대/축소 허용 여부를 네이티브에 전달합니다.
브릿지로 변경한 값은 SDK 내부 저장소에 보관되며, 이후 웹뷰 생성/페이지 로드 시에도 계속 재적용됩니다.
SDK 기본값은 비활성화입니다.
ui.setZoomEnabled 확대 허용과 막기
AppboxSDK.ui.setZoomEnabled(enabled)
Javascript
1
// ui.setZoomEnabled - 핀치 줌 활성화(비활성화는 첫 번째 인자에 false 전달)
2
AppboxSDK.ui.setZoomEnabled( true, (
err, data
) => {
3
if (err) {
4
console.error(
"setZoomEnabled 실패:",
"code:", err.code,
"message:", err.message
);
5
} else {
6
console.log(
"setZoomEnabled 결과:",
data.enabled
);
7
}
8
});
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| enabled(첫 번째 인자) | - | 첫 번째 인자(boolean). false 면 확대를 막고, true 또는 빼면 허용합니다. { enabled: false } 처럼 객체로 넘기면 막히지 않습니다 | 요청값 생략시 true(SDK 최초 상태는 false) | |
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.enabled | 적용된 줌 허용 여부. 예) true |
| err.code | 에러코드 |
| err.message | 에러 메시지 |
동작 설명
- 설정은 호출 즉시 현재 WebView에 반영되며 새로고침이 필요하지 않습니다.
- 마지막 설정값은 SDK 내부 저장소에 보관되며 앱 재실행, 화면 복귀, 페이지 이동 및 새 WebView 생성 시 다시 적용됩니다.
- SDK 최초 상태는 핀치 줌 비활성화입니다.