Объект ScreenOrientation.

  ScreenOrientation - Является интерфейсом к ориентации пользовательского устройства отображения информации.
  Экземпляр доступен:

  1. Через свойство orientation объекта Screen
  Свойства.
  angle - Содержит угол отклонения (в градусах) проекции вертикальной оси устройства отображения на вертикальную плоскость от физической вертикали.
  Значение имеет числовой формат.

Формат записи в коде скрипта:

  • Экземпляр объекта ScreenOrientation.angle

Значения формата записи:

  • Экземпляр объекта ScreenOrientation - Любой операнд значения со значением экземпляра объекта ScreenOrientation.
  • . - Оператор доступа к свойству объекта.
  • angle - Ключевое слово.
      Если устройство отображения не имеет встроенного датчика вращения, то свойство angle всегда имеет значение 0.
  onchange - Содержит функцию, которая должна быть вызвана, когда устройство отображения меняет ориентацию.
  То есть меняются значения других свойств объекта ScreenOrientation.

Формат записи в коде скрипта:

  • Экземпляр объекта ScreenOrientation.onchange[= Функция]

Значения формата записи:

  type - Содержит характеристику положения устройства.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта ScreenOrientation.type

Значения формата записи:

  • Экземпляр объекта ScreenOrientation - Любой операнд значения со значением экземпляра объекта ScreenOrientation.
  • . - Оператор доступа к свойству объекта.
  • type - Ключевое слово.
      ссылается на одно из значений:
    • portrait-primary - Первичная портретная ориентация.
    • portrait-secondary - Вторичная портретная ориентация ("вниз головой").
    • landscape-primary - Первичная ландшафтная ориентация. Если устройство отображения не имеет встроенного датчика вращения, то свойство type всегда имеет значение landscape-primary.
    • landscape-secondary - Вторичная ландшафтная ориентация ("вниз головой").
  Методы.
  addEventListener - Устанавливает функцию обработчик событий связанных с ориентацией устройства отображения.
  Возвращает значение undefined.

Формат записи в коде скрипта:

  • Экземпляр объекта ScreenOrientation.addEventListener(Событие, Функция, false)

Значения формата записи:

  • Экземпляр объекта ScreenOrientation - Любой операнд значения со значением экземпляра объекта ScreenOrientation.
  • . - Оператор доступа к методу объекта.
  • addEventListener - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Событие - Имя события, предусмотренного для объекта ScreenOrientation, заданное в любом строковом формате.
  • Функция - Любой операнд значения со значением функция.
      Значением первого аргумента этой функции, при ее вызове браузером, всегда является экземпляр объекта Event обрабатываемого события.
      Одна функция-обработчик устанавливается методом addEventListener только один раз и повторные вызовы метода для этой же функции не имеют значения.
      Однако другие функции могут быть установлены устройству методом addEventListener для этого же события, причем выполняться, в случае возникновения события, они будут в том же порядке, как записаны в скрипте.
      Если же обработчики для этого устройства и этого события установлены методом addEventListener в разных скриптах, то порядок их выполнения не предсказуем.
  • false - Логическое значение.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  dispatchEvent - Инициализирует возникновение заданного события.
  Возвращает значение undefined.
  Инициализированное событие не происходит на самом деле, но инициализация приводит к вызову его обработчика.

Формат записи в коде скрипта:

  • Экземпляр объекта ScreenOrientation.dispatchEvent(Событие)

Значения формата записи:

  lock - Блокирует отображение на устройстве в заданном положении, несмотря на возможное физическое изменение его ориентации.
  Возвращает значение undefined.
  Разблокировать отображение можно методом unlock.

Формат записи в коде скрипта:

  • Экземпляр объекта ScreenOrientation.lock(Положение)

Значения формата записи:

  • Экземпляр объекта ScreenOrientation - Любой операнд значения со значением экземпляра объекта ScreenOrientation.
  • . - Оператор доступа к методу объекта.
  • lock - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Положение - Одно из значений в любом строковом формате:
      
    • any - Отображение блокируется в положении, которое допускает устройство.
    • natural - Отображение блокируется в положении, которое естественно для устройства.
    • portrait-primary - Отображение блокируется в положении первичной портретной ориентации.
    • portrait-secondary - Отображение блокируется в положении вторичной портретной ориентации ("вниз головой").
    • landscape-primary - Отображение блокируется в положении первичной ландшафтной ориентации.
    • landscape-secondary - Отображение блокируется в положении вторичной ландшафтной ориентации ("вниз головой").
  • ) - Оператор группировки. Ключевое слово в этом формате.
  removeEventListener - Отменяет функцию обработчик событий установленную методом addEventListener для этого устройства.
  Возвращает значение undefined.

Формат записи в коде скрипта:

  • Экземпляр объекта ScreenOrientation.removeEventListener(Событие, Функция, false)

Значения формата записи:

  unlock - Разблокирует отображение на этом устройстве после блокировки методом lock.
  Возвращает значение undefined.

Формат записи в коде скрипта:

  • Экземпляр объекта ScreenOrientation.unlock()

Значения формата записи: