Экран: метод lockOrientation()

Устаревший: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она может быть удалена из соответствующих веб-стандартов, может быть в процессе удаления или поддерживаться только для совместимости. Избегайте её использования и обновляйте существующий код, если это возможно; см. таблицу совместимости внизу этой страницы, чтобы принять правильное решение. Помните, что эта функция может перестать работать в любой момент.

Метод lockOrientation() интерфейса Screen блокирует экран в указанной ориентации.

Предупреждение: Эта функция устарела и её следует избегать. Используйте метод ScreenOrientation.lock() вместо этого.

Примечание: Этот метод работает только для установленных веб-приложений или для веб-страниц в режиме полноэкранного режима.

Синтаксис

lockOrientation(orientation)

Параметры

orientation

Ориентация, в которую нужно заблокировать экран. Это может быть строка или массив строк. Передача нескольких строк позволяет экрану поворачиваться только в выбранных ориентациях.

Следующие строки представляют возможные требования к ориентации, которые вы можете указать:

portrait-primary: Представляет ориентацию экрана, когда он находится в основном портретном режиме. Экран считается в основном портретном режиме, если устройство удерживается в своём нормальном положении, а это положение — портретное, или если нормальное положение устройства — ландшафтное, а устройство повернуто на 90° по часовой стрелке. Нормальное положение зависит от устройства.
portrait-secondary: Представляет ориентацию экрана, когда он находится во вторичном портретном режиме. Экран считается во вторичном портретном режиме, если устройство удерживается на 180° от своего нормального положения, и это положение — портретное, или если нормальное положение устройства — ландшафтное, а устройство повернуто на 90° против часовой стрелки. Нормальное положение зависит от устройства.
landscape-primary: Представляет ориентацию экрана, когда он находится в основном ландшафтном режиме. Экран считается в основном ландшафтном режиме, если устройство удерживается в своём нормальном положении, а это положение — ландшафтное, или если нормальное положение устройства — портретное, а устройство повернуто на 90° по часовой стрелке. Нормальное положение зависит от устройства.
landscape-secondary: Представляет ориентацию экрана, когда он находится во вторичном ландшафтном режиме. Экран считается во вторичном ландшафтном режиме, если устройство удерживается на 180° от своего нормального положения, а это положение — ландшафтное, или если нормальное положение устройства — портретное, а устройство повернуто на 90° против часовой стрелки. Нормальное положение зависит от устройства.
portrait: Представляет как portrait-primary , так и portrait-secondary.
landscape: Представляет как landscape-primary , так и landscape-secondary.
default: Представляет либо portrait-primary , либо landscape-primary в зависимости от естественной ориентации устройств. Например, если разрешение панели составляет 1280*800, default сделает её ландшафтной, если разрешение составляет 800*1280, default сделает её портретной.

Примечание: Можно установить несколько блокировок одновременно. Таким образом, если блокировка установлена только для одной ориентации, ориентация экрана не изменится до тех пор, пока ориентация экрана не будет разблокирована. В противном случае ориентация экрана будет меняться с одной ориентации на другую, пока ориентации будут среди ориентаций, к которым было заблокировано устройство.

Возвращаемое значение

Возвращает true , если ориентация была разрешена для блокировки, или false , если блокировка ориентации была отклонена. Обратите внимание, что возвращаемое значение не указывает, что ориентация экрана действительно заблокирована: может быть задержка.

Примеры

Использование со строковым аргументом

screen.lockOrientationUniversal =
  screen.lockOrientation ||
  screen.mozLockOrientation ||
  screen.msLockOrientation;

if (screen.lockOrientationUniversal("landscape-primary")) {
  // Orientation was locked
} else {
  // Orientation lock failed
}

Использование с массивом аргументов

screen.lockOrientationUniversal =
  screen.lockOrientation ||
  screen.mozLockOrientation ||
  screen.msLockOrientation;

if (
  screen.lockOrientationUniversal(["landscape-primary", "landscape-secondary"])
) {
  // Orientation was locked
} else {
  // Orientation lock failed
}

Спецификации

Эта функция не является частью какой-либо спецификации. Она больше не находится на пути к стандартизации.

Используйте ScreenOrientation.lock() вместо этого.

Совместимость с браузерами

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`lockOrientation`	Нет	12–79	14	Нет	Нет	Нет	14	Нет	Нет	Нет	Нет

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Screen/lockOrientation