螢幕:lockOrientation() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

Screen 介面的 lockOrientation() 方法會將螢幕鎖定為指定的方向。

警告:此功能已棄用,應避免使用。請改用 ScreenOrientation.lock() 方法。

注意:此方法僅適用於已安裝的 Web 應用或處於 全屏模式下的網頁。

語法

js
lockOrientation(orientation)

引數

orientation

螢幕要鎖定的方向。可以是一個字串或字串陣列。傳遞多個字串可讓螢幕僅在選定的方向之間旋轉。

以下字串代表您可以指定的可能方向要求:

portrait-primary

表示螢幕在其主縱向模式下的方向。當裝置處於正常位置且該位置為縱向時,或者當裝置的正常位置為橫向且裝置順時針旋轉 90° 時,螢幕被視為處於其主縱向模式。正常位置取決於裝置。

portrait-secondary

表示螢幕在其次縱向模式下的方向。當裝置處於正常位置的 180° 且該位置為縱向時,或者當裝置的正常位置為橫向且裝置逆時針旋轉 90° 時,螢幕被視為處於其次縱向模式。正常位置取決於裝置。

landscape-primary

表示螢幕在其主橫向模式下的方向。當裝置處於正常位置且該位置為橫向時,或者當裝置的正常位置為縱向且裝置順時針旋轉 90° 時,螢幕被視為處於其主橫向模式。正常位置取決於裝置。

landscape-secondary

表示螢幕在其次橫向模式下的方向。當裝置處於正常位置的 180° 且該位置為橫向時,或者當裝置的正常位置為縱向且裝置逆時針旋轉 90° 時,螢幕被視為處於其次橫向模式。正常位置取決於裝置。

portrait(縱向)

表示 portrait-primaryportrait-secondary

landscape(橫向)

表示 landscape-primarylandscape-secondary

default

表示 portrait-primarylandscape-primary,具體取決於裝置的自然方向。例如,如果面板解析度為 1280*800,則 default 會使其變為橫向;如果解析度為 800*1280,則 default 會使其變為縱向。

注意:可以同時設定多個鎖定。因此,如果僅為一個方向設定了鎖定,則螢幕方向將永遠不會改變,直到螢幕方向被解鎖。否則,只要方向在裝置已鎖定的方向之內,螢幕方向就會在不同方向之間切換。

返回值

如果方向被授權鎖定,則返回 true,如果方向鎖定被拒絕,則返回 false。請注意,返回值並不表示螢幕方向確實已鎖定:可能存在延遲。

示例

使用字串引數

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

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

使用 Array 引數

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

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

規範

此功能不是任何規範的一部分。它已不再是成為標準的軌道上。

請改用 ScreenOrientation.lock()

瀏覽器相容性

另見