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

AutoCorrect files/zh-cn/web/api/d*/ #5933

Merged
merged 4 commits into from
Jun 2, 2022
Merged
Show file tree
Hide file tree
Changes from 2 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
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/datatransfer/datatransfer/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
---
<p>{{APIRef("HTML Drag and Drop API")}}</p>

<p>通过构造函数 <strong><code>DataTransfer</code></strong> 创建一个新的 {{domxref("DataTransfer")}} 对象。注意,单独创建该对象没有意义,且Internet Explorer中 <code>DataTransfer</code> 不是一个构造函数。</p>
<p>通过构造函数 <strong><code>DataTransfer</code></strong> 创建一个新的 {{domxref("DataTransfer")}} 对象。注意,单独创建该对象没有意义,且 Internet Explorer 中 <code>DataTransfer</code> 不是一个构造函数。</p>

<h2 id="语法">语法</h2>

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/datatransfer/dropeffect/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ dataTransfer.dropEffect;
- `link`
- : 在新位置建立源项目的链接
- `none`
- : 项目可能禁止拖放(译者注:还与effectAllowed设置的值相关
- : 项目可能禁止拖放(译者注:还与 effectAllowed 设置的值相关

将任何其他值赋给 `dropEffect` 都没有效果,这种情况下会保留旧值。

Expand Down
8 changes: 4 additions & 4 deletions files/zh-cn/web/api/datatransfer/effectallowed/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<div>{{APIRef("HTML Drag and Drop API")}}</div>

<p><strong><code>DataTransfer.effectAllowed</code></strong> 属性指定拖放操作所允许的一个效果。<em>copy</em> 操作用于指示被拖动的数据将从当前位置复制到放置位置。<em>move操作用于指定被拖动的数据将被移动。 link</em>操作用于指示将在源和放置位置之间创建某种形式的关系或连接。</p>
<p><strong><code>DataTransfer.effectAllowed</code></strong> 属性指定拖放操作所允许的一个效果。<em>copy</em> 操作用于指示被拖动的数据将从当前位置复制到放置位置。<em>move 操作用于指定被拖动的数据将被移动。 link</em>操作用于指示将在源和放置位置之间创建某种形式的关系或连接。</p>

<p>应该在{{event("dragstart")}}事件中设置此属性,以便为拖动源设置所需的拖动效果。在 {{event("dragenter")}} 和{{event("dragover")}} 事件处理程序中,该属性将设置为在{{event("dragstart")}} 事件期间分配的任何值,因此,可以使用<code>effectAllowed</code>来确定允许哪个效果。</p>

Expand Down Expand Up @@ -69,16 +69,16 @@ <h2 id="举个例子">举个例子</h2>
&lt;script&gt;
function dragstart_handler(ev) {
console.log("dragStart: dropEffect = " + ev.dataTransfer.dropEffect + " ; effectAllowed = " + ev.dataTransfer.effectAllowed);
<code>// 将这个元素的id添加到drag载荷中
 // 以便drop事件知道将哪个元素添加到其树中。</code>
<code>// 将这个元素的 id 添加到 drag 载荷中
 // 以便 drop 事件知道将哪个元素添加到其树中。</code>
ev.dataTransfer.setData("text", ev.target.id);
ev.dataTransfer.effectAllowed = "move";
}

function drop_handler(ev) {
console.log("drop: dropEffect = " + ev.dataTransfer.dropEffect + " ; effectAllowed = " + ev.dataTransfer.effectAllowed);
ev.preventDefault();
<code>// 得到目标的id并且将移动的元素添加到目标DOM中</code>
<code>// 得到目标的 id 并且将移动的元素添加到目标 DOM 中</code>
var data = ev.dataTransfer.getData("text");
ev.target.appendChild(document.getElementById(data));
}
Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/datatransfer/files/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,11 @@ <h3 id="返回值">返回值</h3>

<h2 id="举个例子">举个例子</h2>

<p>这个接口有两个实例:</p>
<p>这个接口有两个实例</p>

<ul>
<li>只针对Firfox: <a class="external" href="http://jsfiddle.net/9C2EF/">http://jsfiddle.net/9C2EF/</a></li>
<li>所有浏览器: <a class="external" href="https://jsbin.com/hiqasek/edit?html,js,output">https://jsbin.com/hiqasek/</a></li>
<li>只针对 Firfox: <a class="external" href="http://jsfiddle.net/9C2EF/">http://jsfiddle.net/9C2EF/</a></li>
<li>所有浏览器<a class="external" href="https://jsbin.com/hiqasek/edit?html,js,output">https://jsbin.com/hiqasek/</a></li>
</ul>

<h2 id="规范">规范</h2>
Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/datatransfer/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ <h3 id="Gecko_属性">Gecko 属性</h3>
<h3 id="不推荐的属性">不推荐的属性</h3>
</dt>
<dt>{{domxref("DataTransfer.mozItemCount")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>提供拖动操作中的项目数。在Firefox71中删除。</dd>
<dd>提供拖动操作中的项目数。在 Firefox71 中删除。</dd>
</dl>

<h2 id="Methods" name="Methods">方法</h2>
Expand All @@ -72,7 +72,7 @@ <h3 id="标准方法">标准方法</h3>
<dt>{{domxref("DataTransfer.clearData()")}}</dt>
<dd>删除与给定类型关联的数据。类型参数是可选的。如果类型为空或未指定,则删除与所有类型关联的数据。如果指定类型的数据不存在,或者 data transfer 中不包含任何数据,则该方法不会产生任何效果。</dd>
<dt>{{domxref("DataTransfer.getData()")}}</dt>
<dd>检索给定类型的数据,如果该类型的数据不存在或 data transfer不包含数据,则返回空字符串。</dd>
<dd>检索给定类型的数据,如果该类型的数据不存在或 data transfer 不包含数据,则返回空字符串。</dd>
<dt>{{domxref("DataTransfer.setData()")}}</dt>
<dd>设置给定类型的数据。如果该类型的数据不存在,则将其添加到末尾,以便类型列表中的最后一项将是新的格式。如果该类型的数据已经存在,则在相同位置替换现有数据。</dd>
<dt>{{domxref("DataTransfer.setDragImage()")}}</dt>
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/datatransfer/items/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ <h3 id="返回值">返回值</h3>

<h2 id="示例">示例</h2>

<p>这个例子演示了 <code>items</code> 和 {{domxref("DataTransfer.types","types")}} 属性的用法.</p>
<p>这个例子演示了 <code>items</code> 和 {{domxref("DataTransfer.types","types")}} 属性的用法</p>

<pre class="brush: js">&lt;!DOCTYPE html&gt;
&lt;html lang=en&gt;
Expand Down
10 changes: 5 additions & 5 deletions files/zh-cn/web/api/datatransfer/setdragimage/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@



<p>发生拖动时,从拖动目标({{event("dragstart")}}事件触发的元素)生成半透明图像,并在拖动过程中跟随鼠标指针。这个图片是自动创建的,你不需要自己去创建它。然而,如果想要设置为自定义图像,那么 <strong><code>DataTransfer.setDragImage()</code></strong> 方法就能派上用场。</p>
<p>发生拖动时,从拖动目标 ({{event("dragstart")}}事件触发的元素) 生成半透明图像,并在拖动过程中跟随鼠标指针。这个图片是自动创建的,你不需要自己去创建它。然而,如果想要设置为自定义图像,那么 <strong><code>DataTransfer.setDragImage()</code></strong> 方法就能派上用场。</p>

<p>图像通常是一个 {{HTMLElement("image")}} 元素,但也可以是{{HTMLElement("canvas")}} 或任何其他图像元素。该方法的x和y坐标是图像应该相对于鼠标指针出现的偏移量。</p>
<p>图像通常是一个 {{HTMLElement("image")}} 元素,但也可以是{{HTMLElement("canvas")}} 或任何其他图像元素。该方法的 x 和 y 坐标是图像应该相对于鼠标指针出现的偏移量。</p>

<p>坐标指定鼠标指针相对于图片的偏移量。例如,要使图像居中,请使用图像宽度和高度的一半。</p>

Expand All @@ -27,7 +27,7 @@ <h3 id="参数">  参数</h3>
<dd>用于拖曳反馈图像的图像 {{domxref("Element")}} 元素。</dd>
</dl>

<p>     如果Element是一个img元素,则将拖动位图设置为该元素的图像(保持大小);否则,将拖动数位图设置为从给定元素所生成的图片(<a href="https://html.spec.whatwg.org/multipage/dnd.html#the-datatransfer-interface">当前尚未指定执行此操作的确切机制</a>)</p>
<p>     如果 Element 是一个 img 元素,则将拖动位图设置为该元素的图像(保持大小);否则,将拖动数位图设置为从给定元素所生成的图片(<a href="https://html.spec.whatwg.org/multipage/dnd.html#the-datatransfer-interface">当前尚未指定执行此操作的确切机制</a>)</p>
yin1999 marked this conversation as resolved.
Show resolved Hide resolved

<dl>
<dt><em>xOffset</em></dt>
Expand Down Expand Up @@ -69,7 +69,7 @@ <h2 id="举个例子">举个例子</h2>
&lt;script&gt;
function dragstart_handler(ev) {
console.log("dragStart");
 // 设置拖动的格式和数据。使用事件目标的id作为数据
 // 设置拖动的格式和数据。使用事件目标的 id 作为数据
ev.dataTransfer.setData("text/plain", ev.target.id);
 // 创建一个图像并且使用它作为拖动图像
 // 请注意: 改变 "example.gif" 为一个已经存在的图片
Expand All @@ -88,7 +88,7 @@ <h2 id="举个例子">举个例子</h2>
function drop_handler(ev) {
console.log("Drop");
ev.preventDefault();
 // 获取拖放目标的id数据
 // 获取拖放目标的 id 数据
var data = ev.dataTransfer.getData("text");
ev.target.appendChild(document.getElementById(data));
}
Expand Down
14 changes: 7 additions & 7 deletions files/zh-cn/web/api/datatransfer/types/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@
<div>
<p>{{APIRef("HTML Drag and Drop API")}}</p>

<p><strong><code>DataTransfer.types</code></strong> 是只读属性。它返回一个我们在{{event("dragstart")}}事件中设置的拖动数据格式(如 {{domxref("DOMString","字符串")}}) 的数组。 格式顺序与拖动操作中包含的数据顺序相同。  </p>
<p><strong><code>DataTransfer.types</code></strong> 是只读属性。它返回一个我们在{{event("dragstart")}}事件中设置的拖动数据格式 (如 {{domxref("DOMString","字符串")}}) 的数组。 格式顺序与拖动操作中包含的数据顺序相同。  </p>

<p>这些格式是指定数据类型或格式的Unicode字符串,通常由MIME类型给出。 一些非MIME类型的值是由于历史遗留原因(例如“text”)而特殊设置的。</p>
<p>这些格式是指定数据类型或格式的 Unicode 字符串,通常由 MIME 类型给出。 一些非 MIME 类型的值是由于历史遗留原因(例如“text”)而特殊设置的。</p>

<h2 id="语法">语法</h2>

Expand Down Expand Up @@ -39,16 +39,16 @@ <h2 id="举个例子">举个例子</h2>
&lt;script&gt;
function dragstart_handler(ev) {
console.log("dragStart: target.id = " + ev.target.id);
 // 将这个元素的id添加到drag载荷中
// 以便drop事件知道将哪个元素添加到其树中
 // 将这个元素的 id 添加到 drag 载荷中
// 以便 drop 事件知道将哪个元素添加到其树中
ev.dataTransfer.setData("text/plain", ev.target.id);
ev.dataTransfer.effectAllowed = "move";
}

function drop_handler(ev) {
console.log("drop: target.id = " + ev.target.id);
ev.preventDefault();
// 得到目标的id并且将移动的元素添加到目标DOM中
// 得到目标的 id 并且将移动的元素添加到目标 DOM 中
var data = ev.dataTransfer.getData("text");
ev.target.appendChild(document.getElementById(data));
 // 打印每种格式类型
Expand All @@ -57,7 +57,7 @@ <h2 id="举个例子">举个例子</h2>
console.log("... types[" + i + "] = " + ev.dataTransfer.types[i]);
}
}
 // 打印每个item的“kind”和“type”属性值
 // 打印每个 item 的“kind”和“type”属性值
if (ev.dataTransfer.items != null) {
for (var i=0; i &lt; ev.dataTransfer.items.length; i++) {
console.log("... items[" + i + "].kind = " + ev.dataTransfer.items[i].kind + " ; type = " + ev.dataTransfer.items[i].type);
Expand All @@ -68,7 +68,7 @@ <h2 id="举个例子">举个例子</h2>
function dragover_handler(ev) {
console.log("dragOver");
ev.preventDefault();
// 设置dropEffect属性值为move
// 设置 dropEffect 属性值为 move
ev.dataTransfer.dropEffect = "move"
}
&lt;/script&gt;
Expand Down
10 changes: 5 additions & 5 deletions files/zh-cn/web/api/datatransferitem/getasfile/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
---
<div>{{APIRef("HTML Drag and Drop API")}}</div>

<p>如果<strong><code>DataTransferItem</code></strong>是一个文件, 那 <strong><code>DataTransferItem.getAsFile()</code></strong>  方法将返回拖拽项数据的 {{domxref("File")}} 对象. 如果拖拽项的数据不是一个文件,则返回 <code>null</code>.</p>
<p>如果<strong><code>DataTransferItem</code></strong>是一个文件那 <strong><code>DataTransferItem.getAsFile()</code></strong>  方法将返回拖拽项数据的 {{domxref("File")}} 对象如果拖拽项的数据不是一个文件,则返回 <code>null</code>.</p>

<h2 id="语法">语法</h2>

Expand All @@ -17,18 +17,18 @@ <h2 id="语法">语法</h2>

<h3 id="参数">参数</h3>

<p><em>无.</em></p>
<p><em>无</em></p>

<h3 id="返回值">返回值</h3>

<dl>
<dt>{{domxref("File")}}</dt>
<dd>如果拖拽项的对象是一个文件, 则返回 {{domxref("File")}} 对象; 否则返回 <code>null</code> .</dd>
<dd>如果拖拽项的对象是一个文件则返回 {{domxref("File")}} 对象; 否则返回 <code>null</code> .</dd>
</dl>

<h2 id="例子">例子</h2>

<p>下面这个例子中使用 <code>getAsFile()</code> 。放在 {{event("drop")}} 事件处理里面.</p>
<p>下面这个例子中使用 <code>getAsFile()</code> 。放在 {{event("drop")}} 事件处理里面</p>

<pre class="brush: js">function drop_handler(ev) {
console.log("Drop");
Expand All @@ -47,7 +47,7 @@ <h2 id="例子">例子</h2>
console.log("... Drop: HTML");
} else if ((data[i].kind == 'string') &amp;&amp;
(data[i].type.match('^text/uri-list'))) {
// 拖拽项的数据是URI
// 拖拽项的数据是 URI
console.log("... Drop: URI");
} else if ((data[i].kind == 'file') &amp;&amp;
(data[i].type.match('^image/'))) {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<div>{{APIRef("HTML Drag and Drop API")}}</div>

<p> <strong><code>DataTransferItem.getAsString()</code></strong>  当DataTransferItem对象的kind属性是一个普通Unicode字符串时,该方法会用 DataTransferItem对象的kind属性作为入参来执行传入的回调函数 (i.e. <code>kind</code> is <code>string</code>).</p>
<p> <strong><code>DataTransferItem.getAsString()</code></strong>  当 DataTransferItem 对象的 kind 属性是一个普通 Unicode 字符串时,该方法会用 DataTransferItem 对象的 kind 属性作为入参来执行传入的回调函数 (i.e. <code>kind</code> is <code>string</code>).</p>

<h2 id="示例">示例</h2>

Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/datatransferitem/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -15,18 +15,18 @@ <h2 id="属性">属性</h2>
<dt>{{domxref("DataTransferItem.kind")}} {{readonlyInline}}</dt>
<dd>拖拽项的种类,<code>string</code> 或是 <code>file。</code></dd>
<dt>{{domxref("DataTransferItem.type")}} {{readonlyInline}}</dt>
<dd>拖拽项的类型,一般是一个MIME 类型.</dd>
<dd>拖拽项的类型,一般是一个 MIME 类型。</dd>
</dl>

<h2 id="方法">方法</h2>

<dl>
<dt>{{domxref("DataTransferItem.getAsFile()")}}</dt>
<dd>返回一个关联拖拽项的 {{domxref("File")}} 对象 (当拖拽项不是一个文件时返回 null)。</dd>
<dd>返回一个关联拖拽项的 {{domxref("File")}} 对象(当拖拽项不是一个文件时返回 null)。</dd>
<dt>{{domxref("DataTransferItem.getAsString()")}}</dt>
<dd>使用拖拽项的字符串作为参数执行指定回调函数。</dd>
<dt>{{domxref("DataTransferItem.webkitGetAsEntry()")}} {{Non-standard_inline}}</dt>
<dd>返回一个基于 {{domxref("FileSystemEntry")}} 的对象来表示文件系统中选中的项目。通常是返回一个{{domxref("FileSystemFileEntry")}} 或是 {{domxref("FileSystemDirectoryEntry")}} 对象.</dd>
<dd>返回一个基于 {{domxref("FileSystemEntry")}} 的对象来表示文件系统中选中的项目。通常是返回一个{{domxref("FileSystemFileEntry")}} 或是 {{domxref("FileSystemDirectoryEntry")}} 对象</dd>
</dl>

<h2 id="例子">例子</h2>
Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/datatransferitem/kind/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
---
<div>{{APIRef("HTML Drag and Drop API")}}</div>

<p><strong><code>DataTransferItem.kind</code></strong> 是一个只读属性,它返回一个 {{domxref("DataTransferItem")}} 用来表示拖拽项(<em>drag data item)的类型</em>: 一些文本或者一些文件。</p>
<p><strong><code>DataTransferItem.kind</code></strong> 是一个只读属性,它返回一个 {{domxref("DataTransferItem")}} 用来表示拖拽项 (<em>drag data item) 的类型</em>: 一些文本或者一些文件。</p>

<h2 id="语法">语法</h2>

Expand All @@ -23,7 +23,7 @@ <h2 id="语法">语法</h2>

<h3 id="返回值">返回值</h3>

<p>{{domxref("DOMString")}} 用来表示拖拽项(<em>drag data item)的类型</em>. 它的值必须是以下值中的一个:</p>
<p> {{domxref("DOMString")}} 用来表示拖拽项 (<em>drag data item) 的类型</em>. 它的值必须是以下值中的一个</p>

<dl>
<dt><code>'file'</code></dt>
Expand All @@ -34,7 +34,7 @@ <h3 id="返回值">返回值</h3>

<h2 id="例子">例子</h2>

<p>下面这个例子是 <code>kind</code> 属性的用法.</p>
<p>下面这个例子是 <code>kind</code> 属性的用法</p>

<pre class="brush: js">function drop_handler(ev) {
console.log("Drop");
Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/datatransferitem/type/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@
---
<div>{{APIRef("HTML Drag and Drop API")}}</div>

<p>只读属性<strong><code>DataTransferItem.type</code></strong> 返回代表拖动数据项的 {{domxref("DataTransferItem")}} 对象的类型(格式)。  <code>type</code> 是一个Unicode字符串,通常由MIME给出,不过不需要MIME类型。</p>
<p>只读属性<strong><code>DataTransferItem.type</code></strong> 返回代表拖动数据项的 {{domxref("DataTransferItem")}} 对象的类型(格式)。  <code>type</code> 是一个 Unicode 字符串,通常由 MIME 给出,不过不需要 MIME 类型。</p>

<p>举例一些类型: <code>text/plain</code> 和 <code>text/html</code>.</p>
<p>举例一些类型<code>text/plain</code> 和 <code>text/html</code>.</p>

<h2 id="语法">语法</h2>

Expand Down Expand Up @@ -65,5 +65,5 @@ <h2 id="另见">另见</h2>

<ul>
<li>{{domxref("DataTransfer.type()")}}</li>
<li><a href="/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types">MIME类型不完整列表</a></li>
<li><a href="/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types">MIME 类型不完整列表</a></li>
</ul>
Loading