diff options
author | allo <yin199909@aliyun.com> | 2022-01-19 09:06:59 +0800 |
---|---|---|
committer | Irvin <irvinfly@gmail.com> | 2022-02-15 20:50:25 +0800 |
commit | bd2461ffa1ea78c51016fa14c1e94f87b6552214 (patch) | |
tree | 3f6d2dab391030f234189add97d54553649dadd0 /files/zh-cn/web | |
parent | 6cea64fc1b10c4fbf759937d3c1df4b27e9d250b (diff) | |
download | translated-content-bd2461ffa1ea78c51016fa14c1e94f87b6552214.tar.gz translated-content-bd2461ffa1ea78c51016fa14c1e94f87b6552214.tar.bz2 translated-content-bd2461ffa1ea78c51016fa14c1e94f87b6552214.zip |
sync with english version
Diffstat (limited to 'files/zh-cn/web')
-rw-r--r-- | files/zh-cn/web/api/datatransfer/dropeffect/index.md | 120 |
1 files changed, 55 insertions, 65 deletions
diff --git a/files/zh-cn/web/api/datatransfer/dropeffect/index.md b/files/zh-cn/web/api/datatransfer/dropeffect/index.md index e6c14a9e4a..f3f8e0e8d6 100644 --- a/files/zh-cn/web/api/datatransfer/dropeffect/index.md +++ b/files/zh-cn/web/api/datatransfer/dropeffect/index.md @@ -1,57 +1,64 @@ --- title: DataTransfer.dropEffect slug: Web/API/DataTransfer/dropEffect +tags: + - API + - HTML DOM + - Property + - Reference + - drag and drop translation_of: Web/API/DataTransfer/dropEffect --- -<div> {{APIRef("HTML Drag and Drop API")}}</div> +{{APIRef("HTML Drag and Drop API")}} -<p><strong><code>DataTransfer.dropEffect</code></strong> 属性控制在拖放操作中给用户的反馈(通常是视觉上的)。它会影响在拖拽过程中光标的手势。例如,当用户 hover 在一个放置目标元素上,浏览器的光标可能会预示了将会发生什么操作。</p> +**`DataTransfer.dropEffect`** 属性控制在拖放操作中给用户的反馈(通常是视觉上的)。它会影响在拖拽过程中光标的手势。例如,当用户 hover 在一个放置目标元素上,浏览器的光标可能会预示了将会发生什么操作。 -<p>当 {{domxref("DataTransfer")}} 被创建时, <code>dropEffect</code> 被设置为一个字符串。读这个值时会返回它的当前值。设置这个值时,如果这个新的值是下面列出的值中的一个,这个属性的值就会被设置为这个新的值,其他的值都会被忽略。</p> +当 {{domxref("DataTransfer")}} 被创建时,`dropEffect` 被设置为一个字符串。读这个值时会返回它的当前值。设置这个值时,如果这个新的值是下面列出的值中的一个,这个属性的值就会被设置为这个新的值,其他的值都会被忽略。 -<p>对于 {{event("dragenter")}} 和 {{event("dragover")}} 事件, <code>dropEffect</code> 会根据用户的请求的行为进行初始化。具体如何初始化和浏览器平台有关,但是通常来讲,用户可以通过按住修改键,比如 alt 键来修改想要的行为。当我们期望得到一个指定的行为时而不是用户的请求行为时,可以通过 {{event("dragenter")}} 和 {{event("dragover")}} 事件处理修改 <code>dropEffect</code> 的值。</p> +对于 {{event("dragenter")}} 和 {{event("dragover")}} 事件,`dropEffect` 会根据用户的请求的行为进行初始化。具体如何初始化和浏览器平台有关,但是通常来讲,用户可以通过按住修改键,比如 alt 键来修改想要的行为。当我们期望得到一个指定的行为时而不是用户的请求行为时,可以通过 {{event("dragenter")}} 和 {{event("dragover")}} 事件处理修改 `dropEffect` 的值。 -<p>对于 {{event("drop")}} 和 {{event("dragend")}} 事件,<code>dropEffect</code> 会被设置为想要得到的值,即最后一次 {{event("dragenter")}} 或 {{event("dragover")}} 事件后 <code>dropEffect</code> 的值。例如,在一个 {{event("dragend")}} 事件中,如果期望得到的 dropEffect 是 “move”,那么被拖拽的数据会从源中移除。</p> +对于 {{event("drop")}} 和 {{event("dragend")}} 事件,`dropEffect` 会被设置为想要得到的值,即最后一次 {{event("dragenter")}} 或 {{event("dragover")}} 事件后 `dropEffect` 的值。例如,在一个 {{event("dragend")}} 事件中,如果期望得到的 dropEffect 是 “move”,那么被拖拽的数据会从源中移除。 -<h2 id="语法">语法</h2> +## 语法 -<pre class="syntaxbox"><var>dataTransfer</var>.dropEffect; -</pre> +```js +dataTransfer.dropEffect; +``` -<h3 id="值">值</h3> +### 值 -<p>一个代表拖动操作效果的{{domxref("DOMString")}},可能的值有:</p> +一个代表拖动操作效果的 {{domxref("DOMString")}},可能的值有: -<dl> - <dt><code>copy</code></dt> - <dd>在新位置生成源项的副本</dd> - <dt><code>move</code></dt> - <dd>将项目移动到新位置</dd> - <dt><code>link</code></dt> - <dd>在新位置建立源项目的链接</dd> - <dt><code>none</code></dt> - <dd>项目可能禁止拖放(译者注:还与effectAllowed设置的值相关)</dd> -</dl> +- `copy` + - : 在新位置生成源项的副本 +- `move` + - : 将项目移动到新位置 +- `link` + - : 在新位置建立源项目的链接 +- `none` + - : 项目可能禁止拖放(译者注:还与effectAllowed设置的值相关) -<p>将任何其他值赋给<code>dropEffect</code> 都没有效果,这种情况下会保留旧值。</p> +将任何其他值赋给 `dropEffect` 都没有效果,这种情况下会保留旧值。 -<h2 id="示例">示例</h2> +## 示例 -<p>这个例子演示了<code>dropEffect</code> 和 {{domxref("DataTransfer.effectAllowed","effectAllowed")}}属性的用法</p> +这个例子演示了 `dropEffect` 和 {{domxref("DataTransfer.effectAllowed","effectAllowed")}} 属性的用法 -<h3 id="HTML">HTML</h3> +### HTML -<pre class="brush: html"><div> - <p id="source" ondragstart="dragstart_handler(event);" draggable="true"> +```html +<div> + <p id="source" ondragstart="dragstart_handler(event);" draggable="true"> Select this element, drag it to the Drop Zone and then release the selection to move the element. - </p> -</div> -<div id="target" ondrop="drop_handler(event);" ondragover="dragover_handler(event);">Drop Zone</div> -</pre> + </p> +</div> +<div id="target" ondrop="drop_handler(event);" ondragover="dragover_handler(event);">Drop Zone</div> +``` -<h3 id="CSS">CSS</h3> +### CSS -<pre class="brush: css">div { +```css +div { margin: 0em; padding: 2em; } @@ -64,11 +71,12 @@ translation_of: Web/API/DataTransfer/dropEffect #target { border: 1px solid black; } -</pre> +``` -<h3 id="JavaScript">JavaScript</h3> +### JavaScript -<pre class="brush: js">function dragstart_handler(ev) { +```js +function dragstart_handler(ev) { console.log("dragStart: dropEffect = " + ev.dataTransfer.dropEffect + " ; effectAllowed = " + ev.dataTransfer.effectAllowed); // Add this element's id to the drag payload so the drop handler will @@ -92,40 +100,22 @@ function dragover_handler(ev) { // Set the dropEffect to move ev.dataTransfer.dropEffect = "move" } -</pre> +``` -<p>{{EmbedLiveSample('Example', 300, 250)}}</p> +{{EmbedLiveSample('示例', 300, 250)}} -<h2 id="规范">规范</h2> +## 规范 -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">规范</th> - <th scope="col">状态</th> - <th scope="col">备注</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', 'interaction.html#dom-datatransfer-dropeffect','dropEffect')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('HTML5.1', 'editing.html#dom-datatransfer-dropeffect','dropEffect')}}</td> - <td>{{Spec2('HTML5.1')}}</td> - <td>Initial definition</td> - </tr> - <tr> - </tr> - </tbody> -</table> +{{Specifications}} -<h2 id="浏览器兼容性">浏览器兼容性</h2> +## 浏览器兼容性 +{{Compat}} +## 参见 -<p>{{Compat("api.DataTransfer.dropEffect")}}</p> - -<h2 id="另见">另见</h2> - -<p>{{page("/en-US/docs/Web/API/DataTransfer", "See also")}}</p> +- [HTML 拖放 API](/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API) +- [拖拽操作](/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations) +- [推荐拖拽类型](/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API/Recommended_drag_types) +- [拖拽和放置多个项目](/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API/Multiple_items) +- [DataTransfer test - Paste or Drag](https://codepen.io/tech_query/pen/MqGgap) |