본문으로 건너뛰기

setScreenOrientation

setScreenOrientation

이 폼이 열린 동안 화면 방향을 잠급니다.

파라미터

  • orientation (string | string[]): 허용할 방향 토큰 또는 토큰 배열

허용 토큰:

  • 'portrait' — 세로 (portraitUp + portraitDown)
  • 'landscape' — 가로 (landscapeLeft + landscapeRight)
  • 'portraitUp' — 세로 정방향
  • 'portraitDown' — 세로 역방향
  • 'landscapeLeft' — 가로 왼쪽
  • 'landscapeRight' — 가로 오른쪽
  • 'auto' 또는 빈 배열 [] — 잠금 해제

반환: 없음 (void)

설명

이 폼이 활성화된 동안 화면 방향을 지정한 방향으로 제한합니다. 폼이 닫힐 때(뒤로가기, 슬라이드 백 포함) 방향 제한이 자동으로 auto(해제)로 복원됩니다.

정보

모바일(Android / iOS)에서만 유효합니다. 데스크탑에서는 무시됩니다.

Example

// 가로 모드로 고정
$form.setScreenOrientation("landscape");

// 세로 정방향만 허용
$form.setScreenOrientation("portraitUp");

// 복수 방향 허용
$form.setScreenOrientation(["portraitUp", "landscapeLeft"]);

// 방향 잠금 해제
$form.setScreenOrientation("auto");