ScreenOrientation

Baseline 廣泛可用 *

此功能已成熟,並可在許多裝置和瀏覽器版本上執行。自 2023 年 3 月以來,它已在各種瀏覽器中可用。

* 此特性的某些部分可能存在不同級別的支援。

ScreenOrientation 介面是 螢幕方向 API 的一部分,它提供了關於文件當前方向的資訊。

可以透過 screen.orientation 屬性來獲取 ScreenOrientation 例項物件。

EventTarget ScreenOrientation

例項屬性

ScreenOrientation.type 只讀

返回文件的當前方向型別,可以是 portrait-primary(豎屏主方向)、portrait-secondary(豎屏副方向)、landscape-primary(橫屏主方向)或 landscape-secondary(橫屏副方向)之一。

ScreenOrientation.angle 只讀

返回文件的當前方向角度。

例項方法

ScreenOrientation.lock()

將包含文件的方向鎖定為其預設方向,並返回一個 Promise

ScreenOrientation.unlock()

解鎖包含文件的方向,使其恢復為預設方向。

事件

使用 addEventListener() 或透過將事件監聽器分配給此介面的 oneventname 屬性來監聽這些事件。

change

每當螢幕方向發生變化時都會觸發。

示例

在以下示例中,我們監聽方向 change 事件,並記錄新的 螢幕方向型別角度

js
screen.orientation.addEventListener("change", (event) => {
  const type = event.target.type;
  const angle = event.target.angle;
  console.log(`ScreenOrientation change: ${type}, ${angle} degrees.`);
});

規範

規範
螢幕方向
# screenorientation-interface

瀏覽器相容性