螢幕:lockOrientation() 方法
已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。
Screen 介面的 lockOrientation() 方法會將螢幕鎖定為指定的方向。
警告:此功能已棄用,應避免使用。請改用 ScreenOrientation.lock() 方法。
注意:此方法僅適用於已安裝的 Web 應用或處於 全屏模式下的網頁。
語法
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
}
使用 Array 引數
screen.lockOrientationUniversal =
screen.lockOrientation ||
screen.mozLockOrientation ||
screen.msLockOrientation;
if (
screen.lockOrientationUniversal(["landscape-primary", "landscape-secondary"])
) {
// Orientation was locked
} else {
// Orientation lock failed
}
規範
此功能不是任何規範的一部分。它已不再是成為標準的軌道上。
瀏覽器相容性
載入中…