Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

zh-cn: init the translation of the Document.createTouch() method #23978

Merged
merged 2 commits into from
Oct 20, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 88 additions & 0 deletions files/zh-cn/web/api/document/createtouch/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
---
title: Document:createTouch() 方法
slug: Web/API/Document/createTouch
l10n:
sourceCommit: be8f7f155a48e11b30c240f8731afb1845f85378
---

{{APIRef("DOM")}}{{Deprecated_Header}}{{Non-standard_header}}

**`Document.createTouch()`** 方法创建并返回一个新的 {{DOMxRef("Touch")}} 对象。

> [!NOTE]
> 建议使用 {{domxref("TouchEvent.TouchEvent", "TouchEvent()")}} 构造函数。

## 语法

```js-nolint
createTouch(view, target, identifier, pageX, pageY, screenX, screenY)
```

### 语法

> [!NOTE]
> 所有参数都是可选的。

- `view`
- : 发生触摸的 {{DOMxRef("window")}}。
- `target`
- : 触摸的 {{DOMxRef("EventTarget")}}。
- `identifier`
- : {{DOMxRef("Touch.identifier")}} 的值。
- `pageX`
- : {{DOMxRef("Touch.pageX")}} 的值。
- `pageY`
- : {{DOMxRef("Touch.pageY")}} 的值。
- `screenX`
- : {{DOMxRef("Touch.screenX")}} 的值。
- `screenY`
- : {{DOMxRef("Touch.screenY")}} 的值。

> [!NOTE]
> 该方法的先前版本包括以下附加参数,但这些参数未包含在下面列出的任何标准中。因此,这些参数应被视为已弃用且不应再被使用。

- `clientX`
- : {{DOMxRef("Touch.clientX")}} 的值。
- `clientY`
- : {{DOMxRef("Touch.clientY")}} 的值。
- `radiusX`
- : {{DOMxRef("Touch.radiusX")}} 的值。
- `radiusY`
- : {{DOMxRef("Touch.radiusY")}} 的值。
- `rotationAngle`
- : {{DOMxRef("Touch.rotationAngle")}} 的值。
- `force`
- : {{DOMxRef("Touch.force")}} 的值。

### 返回值

- `touch`
- : 按照输入参数的描述配置的 {{DOMxRef("Touch")}} 对象。

## 示例

此示例说明了如何使用 `Document.createTouch()` 方法创建 {{DOMxRef("Touch")}} 对象。

在下面的代码片段中,为 `target` 元素创建了两个 {{DOMxRef("Touch")}} 对象。

```js
const target = document.getElementById("target");

const touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
const touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);
```

## 规范

此特性属于任何当前的规范。它不再有望成为标准。

## 浏览器兼容性

{{Compat}}

## 参见

- [触摸事件](/zh-CN/docs/Web/API/Touch_events)
- {{DOMxRef("TouchList")}}
- {{DOMxRef("Touch")}}
- {{DOMxRef("Document.createTouchList()")}}