Screen

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

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

Screen 介面表示一個螢幕,通常是當前視窗正在渲染的螢幕,透過 window.screen 獲取。

請注意,瀏覽器透過檢測哪個螢幕擁有瀏覽器視窗的中心來確定要報告哪個螢幕為當前螢幕。

例項屬性

還繼承了其父級 EventTarget 的屬性.

Screen.availHeight

指定螢幕的高度(以畫素為單位),減去作業系統顯示的永久性或半永久性使用者介面元素(如 Windows 上的工作列)後的高度。

Screen.availWidth

返回視窗可用的水平空間(以畫素為單位)。

Screen.colorDepth

返回螢幕的顏色深度。

Screen.height

返回螢幕的高度(以畫素為單位)。

Screen.isExtended 實驗性 安全上下文

如果使用者的裝置有多個螢幕,則返回 true,否則返回 false

Screen.orientation

返回與此螢幕關聯的 ScreenOrientation 例項。

Screen.pixelDepth

獲取螢幕的位深度。

Screen.width

返回螢幕的寬度。

Screen.mozEnabled 非標準 已棄用

布林值。設定為 false 將關閉裝置的螢幕。

Screen.mozBrightness 非標準 已棄用

控制裝置螢幕的亮度。預期值為 0 到 1.0 之間的雙精度浮點數。

非標準屬性

以下屬性是 視窗管理 API 的一部分,它們在 ScreenDetailed 介面上可用;我們選擇在此處記錄它們。但是,在不支援該 API 的瀏覽器中,這些屬性的非標準版本在 Screen 介面上可用。有關非標準支援的詳細資訊,請參閱此頁面的 瀏覽器相容性 表。

Screen.availLeft 只讀 非標準 安全上下文

一個數字,表示可用螢幕區域的 x 座標(左邊緣)。

Screen.availTop 只讀 非標準 安全上下文

一個數字,表示可用螢幕區域的 y 座標(頂邊緣)。

Screen.left 只讀 非標準 安全上下文

一個數字,表示整個螢幕區域的 x 座標(左邊緣)。

Screen.top 只讀 非標準 已棄用 安全上下文

一個數字,表示整個螢幕區域的 y 座標(頂邊緣)。

例項方法

還繼承了其父級 EventTarget 的方法.

Screen.lockOrientation 已棄用

鎖定螢幕方向(僅在全屏模式或已安裝的應用中有效)

Screen.unlockOrientation 已棄用

解鎖螢幕方向(僅在全屏模式或已安裝的應用中有效)

事件

change 實驗性 安全上下文

在特定螢幕發生某些變化時觸發,例如寬度或高度、可用寬度或高度、顏色深度或方向。

orientationchange 已棄用 非標準

螢幕方向改變時觸發。

示例

js
if (screen.colorDepth < 8) {
  // use low-color version of page
} else {
  // use regular, colorful page
}

規範

規範
CSSOM 檢視模組
# the-screen-interface

瀏覽器相容性