From 8d30d00ee0443d71b9666394070b5205e785eacc Mon Sep 17 00:00:00 2001 From: allo Date: Tue, 11 Jan 2022 15:23:11 +0800 Subject: convert to markdown for `DataTransfer.clearData()` --- .../zh-cn/web/api/datatransfer/cleardata/index.md | 214 ++++++--------------- 1 file changed, 63 insertions(+), 151 deletions(-) (limited to 'files/zh-cn/web/api/datatransfer') diff --git a/files/zh-cn/web/api/datatransfer/cleardata/index.md b/files/zh-cn/web/api/datatransfer/cleardata/index.md index 66f518db63..adbe58825c 100644 --- a/files/zh-cn/web/api/datatransfer/cleardata/index.md +++ b/files/zh-cn/web/api/datatransfer/cleardata/index.md @@ -2,109 +2,101 @@ title: DataTransfer.clearData() slug: Web/API/DataTransfer/clearData tags: - - DataTransfer.clearData() + - API + - DataTransfer + - HTML DOM + - Method + - Reference + - clearData + - drag and drop translation_of: Web/API/DataTransfer/clearData --- -
{{APIRef("HTML Drag and Drop API")}}
+{{APIRef("HTML Drag and Drop API")}} -

DataTransfer.clearData() 方法删除给定类型的拖动操作的{{domxref("DataTransfer","drag data")}}。如果给定类型的数据不存在，则此方法不执行任何操作。

+**`DataTransfer.clearData()`** 方法删除给定类型的拖动操作的 {{domxref("DataTransfer","drag data")}}。如果给定类型的数据不存在，则此方法不执行任何操作。 -

如果没有参数调用此方法，或者格式为空 ，则将删除所有类型的数据。

+如果调用此方法时没有传入参数，或者参数为空{{domxref("DOMString","字符串")}}，则将删除所有类型的数据。 -

此方法不会从拖动操作中删除文件，因此如果有任何文件包含在对象的{{domxref("DataTransfer.types")}}列表中，仍然可能有一个类型为“Files”的条目在拖动。 

+此方法不会从拖动操作中删除文件，因此如果有任何文件包含在对象的 {{domxref("DataTransfer.types")}} 列表中，仍然可能有一个类型为“Files”的条目在拖动。 -
-

该方法只能在{{event("dragstart")}} 事件的处理程序中使用，因为这是拖动操作的数据存储只能写入的时间。

-
+> **备注：** 该方法只能在 {{event("dragstart")}} 事件的处理程序中使用，因为这是拖动操作的数据存储唯一能写入的时间。 +## 语法 -

句法

+```js +DataTransfer.clearData([format]); +``` -
DataTransfer.clearData([format]);
-
+### 参数 -

参数

+- `format` {{optional_inline}} + - : 一个 {{domxref("DOMString","string")}} 指定要删除的数据类型。如果此参数为空字符串或未提供，则将删除所有类型的数据。 -
-
format {{optional_inline}}
-
一个 {{domxref("DOMString","string")}}指定要删除的数据类型。如果此参数为空字符串或未提供，则将删除所有类型的数据。
-
+## 示例 -

范例

+这个例子显示了使用 {{domxref("DataTransfer")}} 对象的 {{domxref("DataTransfer.getData()","getData()")}}、{{domxref("DataTransfer.setData()","setData()")}} 以及 {{domxref("DataTransfer.clearData()","clearData()")}} 方法。 -

这个例子显示了使用{{domxref("DataTransfer")}}对象的{{domxref("DataTransfer.getData()","getData()")}}, {{domxref("DataTransfer.setData()","setData()")}} 和{{domxref("DataTransfer.clearData()","clearData()")}} 和

+### HTML -

HTML

- -
<span class="tweaked" id="source" draggable="true">
+```html
+
   Select this element, drag it to the Drop Zone and then release the selection to move the element.
-</span>
-<span class="tweaked" id="target">Drop Zone</span>
-<div>Status: <span id="status">Drag to start</span></div>
-<div>Data is: <span id="data">uninitialized</span></div>
-
+ +Drop Zone +
Status: Drag to start
+
Data is: uninitialized
+``` -

CSS

+### CSS -
span.tweaked {
+```css
+span.tweaked {
   display: inline-block;
   margin: 1em 0;
   padding: 1em 2em;
 }
-
 #source {
   color: blue;
   border: 1px solid black;
 }
-
 #target {
   border: 1px solid black;
 }
-
+``` -

JavaScript

+### JavaScript -
window.addEventListener('DOMContentLoaded', function () {
+```js
+window.addEventListener('DOMContentLoaded', function () {
   // Select HTML elements
   var draggable = document.getElementById('source');
   var dropable = document.getElementById('target');
   var status = document.getElementById('status');
   var data = document.getElementById('data');
   var dropped = false;
-
   // Register event handlers
   draggable.addEventListener('dragstart', dragStartHandler);
   draggable.addEventListener('dragend', dragEndHandler);
   dropable.addEventListener('dragover', dragOverHandler);
   dropable.addEventListener('dragleave', dragLeaveHandler);
   dropable.addEventListener('drop', dropHandler);
-
   function dragStartHandler (event) {
-    status.innerHTML = 'Drag in process';
-
+    status.textContent = 'Drag in process';
     // Change target element's border to signify drag has started
     event.currentTarget.style.border = '1px dashed blue';
-
     // Start by clearing existing clipboards; this will affect all types since we
     // don't give a specific type.
-
     event.dataTransfer.clearData();
-
     // Set the drag's format and data (use event target's id for data)
     event.dataTransfer.setData('text/plain', event.target.id);
-
-    data.innerHTML = event.dataTransfer.getData('text/plain');
+    data.textContent = event.dataTransfer.getData('text/plain');
   }
-
   function dragEndHandler (event) {
     if (!dropped) {
-      status.innerHTML = 'Drag canceled';
+      status.textContent = 'Drag canceled';
     }
-
-    data.innerHTML = event.dataTransfer.getData('text/plain') || 'empty';
-
+    data.textContent = event.dataTransfer.getData('text/plain') || 'empty';
     // Change border to signify drag is no longer in process
     event.currentTarget.style.border = '1px solid black';
-
     if (dropped) {
       // Remove all event listeners
       draggable.removeEventListener('dragstart', dragStartHandler);
@@ -114,124 +106,44 @@ translation_of: Web/API/DataTransfer/clearData
       dropable.removeEventListener('drop', dropHandler);
     }
   }
-
   function dragOverHandler (event) {
-    status.innerHTML = 'Drop available';
-
+    status.textContent = 'Drop available';
     event.preventDefault();
   }
-
   function dragLeaveHandler (event) {
-    status.innerHTML = 'Drag in process (drop was available)';
-
+    status.textContent = 'Drag in process (drop was available)';
     event.preventDefault();
   }
-
   function dropHandler (event) {
     dropped = true;
-
-    status.innerHTML = 'Drop done';
-
+    status.textContent = 'Drop done';
     event.preventDefault();
-
     // Get data linked to event format « text »
     var _data = event.dataTransfer.getData('text/plain');
     var element = document.getElementById(_data);
-
     // Append drag source element to event's target element
     event.target.appendChild(element);
-
     // Change CSS styles and displayed text
     element.style.cssText = 'border: 1px solid black;display: block; color: red';
-    element.innerHTML = "I'm in the Drop Zone!";
+    element.textContent = "I'm in the Drop Zone!";
   }
 })
-
- -

{{EmbedLiveSample('Example', 300, 250)}}

- -

规范

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('HTML WHATWG', 'interaction.html#dom-datatransfer-cleardata','DataTransfer.clearData()')}}{{Spec2('HTML WHATWG')}} 
{{SpecName('HTML5.1', 'editing.html#dom-datatransfer-cleardata','DataTransfer.clearData()')}}{{Spec2('HTML5.1')}}Initial definition
- -

浏览器兼容性

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support4{{CompatVersionUnknown}}{{CompatGeckoDesktop("1.9.1")}}10123.1
-
- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidAndroid WebviewChrome for AndroidEdgeFirefox Mobile (Gecko)Firefox OSIE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatIE("10")}}{{CompatNo}}{{CompatNo}}
-
- -

也可以看看

- -

{{page("/en-US/docs/Web/API/DataTransfer", "See also")}}

+``` + +{{EmbedLiveSample('示例', 300, 250)}} + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [Drag and drop](/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API) +- [Drag Operations](/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations) +- [Recommended Drag Types](/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API/Recommended_drag_types) +- [Dragging and Dropping Multiple Items](/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API/Multiple_items) +- [DataTransfer test - Paste or Drag](https://codepen.io/tech_query/pen/MqGgap) -- cgit v1.2.3-54-g00ecf