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]: update the translation of Document adoptNode() method #20215

Merged
merged 5 commits into from
May 16, 2024
Merged
Changes from 1 commit
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
43 changes: 27 additions & 16 deletions files/zh-cn/web/api/document/adoptnode/index.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,32 @@
---
title: Document.adoptNode()
title: DocumentadoptNode() 方法
slug: Web/API/Document/adoptNode
l10n:
sourceCommit: 0a881eea07f0cec6ca4ed85a24af43b367a9f80d
---

{{ ApiRef("DOM") }}

从其他的 document 文档中获取一个节点。该节点以及它的子树上的所有节点都会从原文档删除 (如果有这个节点的话), 并且它的[`ownerDocument`](/zh-CN/docs/DOM/Node.ownerDocument) 属性会变成当前的 document 文档。之后你可以把这个节点插入到当前文档中
**`Document.adoptNode()`** 将{{Glossary("node/dom", "节点(DOM)")}}从另一个 {{domxref("Document", "document", "", "1")}} 文档转移至调用该方法的文档中。被采纳的节点及其子树将会从原始文档(如果存在的话)中移除,并且它们的 {{domxref("Node.ownerDocument", "ownerDocument")}} 会变更为当前文档。然后就可以将节点插入到当前文档中
T34-active marked this conversation as resolved.
Show resolved Hide resolved

## 语法

```js-nolint
adoptNode(externalNode)
```

### 参数

- `externalNode`
- : 将要从外部文档导入的节点。
- : 采用另一份文件中的节点。
T34-active marked this conversation as resolved.
Show resolved Hide resolved

### 返回值

在导入文档的作用域中复制的 `importedNode`。

调用此方法后,`importedNode` 和 `externalNode` 是同个对象。

> **备注:** `importedNode` 的 {{domxref("Node.parentNode")}} 为 `null`,因为它尚未插入文档树中!

## 示例

Expand All @@ -28,26 +40,25 @@ iframeImages.forEach((imgEl) => {
});
```

## 笔记

有时候调用 adopNode 可能会失败因为节点资源来自不同的源,但是这不应该是浏览器的实现问题。
## 备注

In general the `adoptNode` call may fail due to the source node coming from a different implementation, however this should not be a problem with browser implementations.
在将来自外部文档的节点插入到当前文档之前,应该先进行以下操作之一:

> 译者注:
>
> 该方法不但可以从 iframe 中获取 adopt 元素,在同一 document 文档下的不同两个元素中也可以使用,该方法可以实现从左边栏列表中选取某些元素加载到右边栏的功能。
- 使用 {{domXref("document.importNode()")}} 克隆;或
- 使用 {{domXref("document.adoptNode()")}} 采用
T34-active marked this conversation as resolved.
Show resolved Hide resolved

将外部文档的节点插入当前文档之前,你必须使用 [`document.importNode()`](/zh-CN/docs/Web/API/Document/importNode) 从外部文档导入源节点,或者使用 [`document.adoptNode()`](/zh-CN/docs/Web/API/Document/adoptNode)导入源节点,
想要了解更多的 [`Node.ownerDocument`](/zh-CN/docs/Web/API/Node/ownerDocument) 问题,请参考 [W3C DOM FAQ](http://www.w3.org/DOM/faq.html#ownerdoc).
> **备注:** 虽然 Firefox 目前没有强制执行这一规则,但我们鼓励你遵守这一规则,以提高未来的兼容性。

即使你不执行导入动作,就执行插入外部文档中的节点.Firefox 目前也不会报错 (如果严格按标准执行,很多已有的网站都无法正常运行).
我们鼓励开发者严格按标准修改自己已有的不符合上述标准的代码。
有关 {{domXref("Node.ownerDocument")}} 问题的更多信息,请参阅 W3C DOM 常见问题。
T34-active marked this conversation as resolved.
Show resolved Hide resolved

## 规范

- [DOM Level 3 Core: Document.adoptNode](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-adoptNode)
{{Specifications}}

## 浏览器兼容性

{{Compat}}

## 参见

- [document.importNode](/zh-CN/docs/DOM/document.importNode)
- {{domxref("document.importNode()")}}
Loading