Skip to content

Commit

Permalink
[zh-cn]: update the translation of Document.exitFullscreen() method (
Browse files Browse the repository at this point in the history
  • Loading branch information
tianyeeT authored Jul 13, 2024
1 parent 7bc82cb commit 347d32f
Showing 1 changed file with 28 additions and 15 deletions.
43 changes: 28 additions & 15 deletions files/zh-cn/web/api/document/exitfullscreen/index.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,47 @@
---
title: Document.exitFullscreen()
title: DocumentexitFullscreen() 方法
slug: Web/API/Document/exitFullscreen
l10n:
sourceCommit: 41a8b9c9832359d445d136b6d7a8a28737badc6b
---

{{ApiRef("Fullscreen API")}}

**`Document.exitFullscreen()`** 方法用于让当前文档退出全屏模式(原文表述不准确,详见备注)。调用这个方法会让文档回退到上一个调用{{domxref("Element.requestFullscreen()")}}方法进入全屏模式之前的状态。

> **备注:** 如果一个元素 A 在请求进去全屏模式之前,已经存在其他元素处于全屏状态,当这个元素 A 退出全屏模式之后,之前的元素仍然处于全屏状态。浏览器内部维护了一个全屏元素栈用于实现这个目的。
{{domxref("Document")}} 的 **`exitFullscreen()`** 方法请求将当前在全屏模式下呈现的文档元素退出全屏模式,恢复屏幕的先前状态。这通常会逆转先前调用 {{domxref("Element.requestFullscreen()")}} 的效果。

## 语法

```js-nolint
exitFullscreen()
```
document.exitFullscreen();
```

### 参数

无。

### 返回值

一个 {{jsxref("Promise")}},在{{Glossary("user agent", "用户代理")}}完成退出全屏模式后被兑现。如果在尝试退出全屏模式时发生错误,promise 的 `catch()` 处理器将被调用。

## 示例

此示例使当前文档在鼠标按钮点击其内部时切换进出全屏显示模式。

```js
// 点击切换全屏模式
document.onclick = function (event) {
document.onclick = (event) => {
if (document.fullscreenElement) {
document.exitFullscreen();
document
.exitFullscreen()
.then(() => console.log("文档已退出全屏模式"))
.catch((err) => console.error(err));
} else {
document.documentElement.requestFullscreen();
}
};
```

> **备注:** 有关更完整的示例,请参阅 [`Element.requestFullscreen()` 示例](/zh-CN/docs/Web/API/Element/requestFullscreen#示例)
## 规范

{{Specifications}}
Expand All @@ -36,12 +50,11 @@ document.onclick = function (event) {

{{Compat}}

## 参阅
## 参见

- [Using full-screen mode](/zh-CN/DOM/Using_full-screen_mode)
- [全屏 API](/zh-CN/docs/Web/API/Fullscreen_API)
- [全屏 API 指南](/zh-CN/docs/Web/API/Fullscreen_API/Guide)
- {{ domxref("Element.requestFullscreen()") }}
- {{ domxref("Document.exitFullscreen()") }}
- {{ domxref("Document.fullscreen") }}
- {{ domxref("Document.fullscreenElement") }}
- {{ cssxref(":fullscreen") }}
- [`allowfullscreen`](/zh-CN/docs/Web/HTML/Element/iframe#allowfullscreen)
- {{ cssxref(":fullscreen") }} 和 {{cssxref("::backdrop")}}
- {{HTMLElement("iframe")}} [`allowfullscreen`](/zh-CN/docs/Web/HTML/Element/iframe#allowfullscreen) 属性

0 comments on commit 347d32f

Please sign in to comment.