핀치 줌 | 사용자 경험, 알림, 인터랙션 | Appbox SDK 가이드

핀치 줌

웹(WebView)에서 핀치 줌 활성화/비활성화를 제어하기 위한 브릿지 액션입니다.
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 최초 상태는 핀치 줌 비활성화입니다.





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