diff --git a/files/zh-cn/web/api/document/createtouch/index.md b/files/zh-cn/web/api/document/createtouch/index.md new file mode 100644 index 00000000000000..87d62e4f0f2fcd --- /dev/null +++ b/files/zh-cn/web/api/document/createtouch/index.md @@ -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()")}}