在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

弃用
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the 兼容性表格 at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

lockOrientation() 方法在 Screen interface locks the screen into a specified orientation. The ScreenOrientation.lock() method should be used instead.

注意： This method only works for installed Web apps or for Web pages in full-screen mode .

句法

lockAllowed = window.screen.lockOrientation(orientation);
					

参数

orientation

The orientation into which to lock the screen. This is either a string or an array of strings. Passing several strings lets the screen rotate only in the selected orientations.

The following strings represent the possible orientation requirements you may specify:

portrait-primary

It represents the orientation of the screen when it is in its primary portrait mode. A screen is considered in its primary portrait mode if the device is held in its normal position and that position is in portrait, or if the normal position of the device is in landscape and the device held turned by 90° clockwise. The normal position is device dependant.

portrait-secondary

It represents the orientation of the screen when it is in its secondary portrait mode. A screen is considered in its secondary portrait mode if the device is held 180° from its normal position and that position is in portrait, or if the normal position of the device is in landscape and the device held is turned by 90° anticlockwise. The normal position is device dependant.

landscape-primary

It represents the orientation of the screen when it is in its primary landscape mode. A screen is considered in its primary landscape mode if the device is held in its normal position and that position is in landscape, or if the normal position of the device is in portrait and the device held is turned by 90° clockwise. The normal position is device dependant.

landscape-secondary

It represents the orientation of the screen when it is in its secondary landscape mode. A screen is considered in its secondary landscape mode if the device held is 180° from its normal position and that position is in landscape, or if the normal position of the device is in portrait and the device held is turned by 90° anticlockwise. The normal position is device dependant.

portrait

It represents both portrait-primary and portrait-secondary .

landscape

It represents both landscape-primary and landscape-secondary .

default

It represents either portrait-primary and landscape-primary depends on natural orientation of devices. For example, if the panel resolution is 1280*800, default will make it landscape, if the resolution is 800*1280, default will make it to portrait.

注意： It's possible to set several locks at the same time. So, if the lock is set for only one orientation, the screen orientation will never change until the screen orientation is unlocked. Otherwise, the screen orientation will change from an orientation to another as long as the orientations are amongst the orientations the device has been locked to.

返回值

返回 true if the orientation was authorized to be locked or false if the orientation locking was denied. Note that the return value doesn't indicate that the screen orientation is indeed locked: there may be a delay.

范例

Usage with a DOMString argument

screen.lockOrientationUniversal = screen.lockOrientation || screen.mozLockOrientation || screen.msLockOrientation;
if (screen.lockOrientationUniversal("landscape-primary")) {
  // Orientation was locked
} else {
  // Orientation lock failed
}
					

Usage with an 数组 argument

screen.lockOrientationUniversal = screen.lockOrientation || screen.mozLockOrientation || screen.msLockOrientation;
if (screen.lockOrientationUniversal(["landscape-primary", "landscape-secondary"])) {
  // Orientation was locked
} else {
  // Orientation lock failed
}
					

规范

规范	状态	注释
Screen Orientation API The definition of 'lockOrientation()' in that specification.	工作草案	Initial definition (Not present in the draft anymore)

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
lockOrientation	Chrome 38	Edge 12 Prefixed 12 Prefixed Prefixed Implemented with the vendor prefix: ms	Firefox Yes Prefixed Yes Prefixed Prefixed Implemented with the vendor prefix: moz	IE 11 Prefixed 11 Prefixed Prefixed Implemented with the vendor prefix: ms	Opera Yes	Safari No	WebView Android 38	Chrome Android 38	Firefox Android Yes Prefixed Yes Prefixed Prefixed Implemented with the vendor prefix: moz	Opera Android Yes	Safari iOS No	Samsung Internet Android 3.0

图例

完整支持

完整支持

不支持

不支持

要求使用供应商前缀或不同名称。

要求使用供应商前缀或不同名称。

另请参阅

• Screen.orientation
• Screen.unlockOrientation()
• Screen.onorientationchange
• Managing screen orientation

元数据

• 最后修改： May 18, 2019

相关话题

1. Screen
2. 特性

   1. availHeight
   2. availLeft
   3. availTop
   4. availWidth
   5. colorDepth
   6. height
   7. left
   8. mozBrightness
   9. mozEnabled
   10. onorientationchange
   11. orientation
   12. pixelDepth
   13. top
   14. width
3. 方法

   1. lockOrientation()
   2. unlockOrientation()
4. 继承：

   1. EventTarget
5. Related pages for Screen Orientation API

   1. Screen.orientation
   2. ScreenOrientation