-
Notifications
You must be signed in to change notification settings - Fork 0
/
USE.html
90 lines (87 loc) · 22.5 KB
/
USE.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>快速上手 | Vue-Drag-Man | 简洁的Vue拖拽组件</title>
<meta name="description" content="document for Vue-Drag-Man">
<link rel="preload" href="/assets/css/0.styles.837179f8.css" as="style"><link rel="preload" href="/assets/js/app.81b2bbf8.js" as="script"><link rel="preload" href="/assets/js/3.8ecbad55.js" as="script"><link rel="preload" href="/assets/js/5.1c5452aa.js" as="script"><link rel="prefetch" href="/assets/js/1.97204eaa.js"><link rel="prefetch" href="/assets/js/10.430bf4a7.js"><link rel="prefetch" href="/assets/js/11.95673768.js"><link rel="prefetch" href="/assets/js/12.6e457952.js"><link rel="prefetch" href="/assets/js/4.bf0b2d2c.js"><link rel="prefetch" href="/assets/js/6.d4c659db.js"><link rel="prefetch" href="/assets/js/7.5ea43392.js"><link rel="prefetch" href="/assets/js/8.36281f91.js"><link rel="prefetch" href="/assets/js/9.8e688c94.js">
<link rel="stylesheet" href="/assets/css/0.styles.837179f8.css">
</head>
<body>
<div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/" class="home-link router-link-active"><!----> <span class="site-name">Vue-Drag-Man | 简洁的Vue拖拽组件</span></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><a href="/" class="nav-link">介绍</a></div><div class="nav-item"><a href="/USE.html" class="nav-link router-link-exact-active router-link-active">快速上手</a></div><div class="nav-item"><a href="https://juejin.im/user/5d194f8151882517de2ae188/posts" target="_blank" rel="noopener noreferrer" class="nav-link external">
作者主页
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div><div class="nav-item"><a href="https://www.npmjs.com/package/vue-drag-man" target="_blank" rel="noopener noreferrer" class="nav-link external">
NPM
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div> <!----></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"><div class="nav-item"><a href="/" class="nav-link">介绍</a></div><div class="nav-item"><a href="/USE.html" class="nav-link router-link-exact-active router-link-active">快速上手</a></div><div class="nav-item"><a href="https://juejin.im/user/5d194f8151882517de2ae188/posts" target="_blank" rel="noopener noreferrer" class="nav-link external">
作者主页
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div><div class="nav-item"><a href="https://www.npmjs.com/package/vue-drag-man" target="_blank" rel="noopener noreferrer" class="nav-link external">
NPM
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div> <!----></nav> <ul class="sidebar-links"><li><a href="/" class="sidebar-link">介绍</a></li><li><a href="/USE.html" class="active sidebar-link">快速上手</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/USE.html#安装" class="sidebar-link">安装</a></li><li class="sidebar-sub-header"><a href="/USE.html#使用" class="sidebar-link">使用</a></li><li class="sidebar-sub-header"><a href="/USE.html#示例" class="sidebar-link">示例</a></li><li class="sidebar-sub-header"><a href="/USE.html#events" class="sidebar-link">Events</a></li><li class="sidebar-sub-header"><a href="/USE.html#配合echarts的示例" class="sidebar-link">配合echarts的示例</a></li></ul></li><li><a href="/EXAMPLE.html" class="sidebar-link">示例</a></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="快速上手"><a href="#快速上手" class="header-anchor">#</a> 快速上手</h1> <h2 id="安装"><a href="#安装" class="header-anchor">#</a> 安装</h2> <div class="language- extra-class"><pre class="language-text"><code>npm install vue-drag-man --save
</code></pre></div><h2 id="使用"><a href="#使用" class="header-anchor">#</a> 使用</h2> <p><strong>在main.js中引入并注册组件</strong></p> <div class="language-js extra-class"><pre class="language-js"><code><span class="token comment">// main.js</span>
<span class="token keyword">import</span> vueDragMan <span class="token keyword">from</span> <span class="token string">'vue-drag-man'</span>
Vue<span class="token punctuation">.</span><span class="token function">use</span><span class="token punctuation">(</span>vueDragMan<span class="token punctuation">)</span>
</code></pre></div><p><strong>然后在组件中就可以直接使用<code><Drag></code>标签和<code><Drop></code>标签</strong></p> <div class="language-html extra-class"><pre class="language-html"><code><span class="token comment"><!-- 被<Drag>标签包裹的元素会成为"可拖拽"元素 --></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>Drag</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>div</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>drag<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>drag<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>Drag</span><span class="token punctuation">></span></span>
</code></pre></div><div class="language-html extra-class"><pre class="language-html"><code><span class="token comment"><!-- 被<Drop>标签包裹的元素会成为"可放置"元素 --></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>Drop</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>div</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>drop<span class="token punctuation">"</span></span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation"></</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>Drop</span><span class="token punctuation">></span></span>
</code></pre></div><h2 id="示例"><a href="#示例" class="header-anchor">#</a> 示例</h2> <h3 id="基础示例"><a href="#基础示例" class="header-anchor">#</a> 基础示例</h3> <p>将需要被拖拽的元素使用<code><Drag></code>包裹起来, 将需要被放置的区域使用<code><Drop></code>包裹起来即可</p> <div class="language-html extra-class"><pre class="language-html"><code><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>template</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>Drag</span><span class="token punctuation">></span></span>
<span class="token comment"><!-- 被拖拽的目标 --></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>div</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>dragged<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>target<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>Drag</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>Drop</span><span class="token punctuation">></span></span>
<span class="token comment"><!-- 目标放置区域 --></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>div</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>drop-area<span class="token punctuation">"</span></span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation"></</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>Drop</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>template</span><span class="token punctuation">></span></span>
</code></pre></div><p><img src="/assets/img/example.0b790ed5.gif" alt="An image"></p> <h3 id="事件示例"><a href="#事件示例" class="header-anchor">#</a> 事件示例</h3> <p>拖放过程包括6个事件, 回调参数为原生事件对象</p> <div class="language-html extra-class"><pre class="language-html"><code><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>template</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>div</span> <span class="token attr-name">id</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>app<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>Drag</span> <span class="token attr-name">@drag</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>drag<span class="token punctuation">"</span></span> <span class="token attr-name">@dragend</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>dragend<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>div</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>dragged<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>target<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>Drag</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>Drop</span> <span class="token attr-name">@dragenter</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>dragenter<span class="token punctuation">"</span></span> <span class="token attr-name">@dragover</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>dragover<span class="token punctuation">"</span></span> <span class="token attr-name">@dragleave</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>dragover<span class="token punctuation">"</span></span> <span class="token attr-name">@drop</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>drop<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>div</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>drop-area<span class="token punctuation">"</span></span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation"></</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>Drop</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>div</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>template</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>script</span><span class="token punctuation">></span></span><span class="token script"><span class="token language-javascript">
<span class="token keyword">export</span> <span class="token keyword">default</span> <span class="token punctuation">{</span>
name<span class="token punctuation">:</span> <span class="token string">'app'</span><span class="token punctuation">,</span>
methods<span class="token punctuation">:</span> <span class="token punctuation">{</span>
<span class="token function">drag</span><span class="token punctuation">(</span><span class="token parameter">e</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span><span class="token string">'拖放过程中'</span><span class="token punctuation">,</span> e<span class="token punctuation">)</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token function">dragend</span><span class="token punctuation">(</span><span class="token parameter">e</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span><span class="token string">'拖放结束'</span><span class="token punctuation">,</span> e<span class="token punctuation">)</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token function">dragenter</span><span class="token punctuation">(</span><span class="token parameter">e</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span><span class="token string">'源对象 开始进入过程对象范围内'</span><span class="token punctuation">,</span> e<span class="token punctuation">)</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token function">dragover</span><span class="token punctuation">(</span><span class="token parameter">e</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span><span class="token string">'源对象 在过程对象范围内移动'</span><span class="token punctuation">,</span> e<span class="token punctuation">)</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token function">dragleave</span><span class="token punctuation">(</span><span class="token parameter">e</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span><span class="token string">'源对象 离开过程对象的范围'</span><span class="token punctuation">,</span> e<span class="token punctuation">)</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token function">drop</span><span class="token punctuation">(</span><span class="token parameter">el<span class="token punctuation">,</span> e</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span><span class="token string">'源对象 被拖放到目标对象内'</span><span class="token punctuation">,</span> el<span class="token punctuation">,</span> e<span class="token punctuation">)</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</span></span><span class="token tag"><span class="token tag"><span class="token punctuation"></</span>script</span><span class="token punctuation">></span></span>
</code></pre></div><h2 id="events"><a href="#events" class="header-anchor">#</a> Events</h2> <p><strong>源对象(<Drag>)事件</strong></p> <table><thead><tr><th style="text-align:center;">事件名称</th> <th style="text-align:center;">说明</th> <th style="text-align:center;">回调参数</th></tr></thead> <tbody><tr><td style="text-align:center;">dragstart</td> <td style="text-align:center;">源对象开始拖放</td> <td style="text-align:center;">事件对象Event</td></tr> <tr><td style="text-align:center;">drag</td> <td style="text-align:center;">源对象拖放过程中</td> <td style="text-align:center;">事件对象Event</td></tr> <tr><td style="text-align:center;">dragend</td> <td style="text-align:center;">源对象拖放结束</td> <td style="text-align:center;">事件对象Event</td></tr></tbody></table> <br> <p><strong>目标对象(<Drop>)事件</strong></p> <table><thead><tr><th style="text-align:center;">事件名称</th> <th style="text-align:center;">说明</th> <th style="text-align:center;">回调参数</th></tr></thead> <tbody><tr><td style="text-align:center;">dragenter</td> <td style="text-align:center;">源对象开始进入目标对象范围内</td> <td style="text-align:center;">事件对象Event</td></tr> <tr><td style="text-align:center;">dragover</td> <td style="text-align:center;">源对象在目标对象范围内移动</td> <td style="text-align:center;">事件对象Event</td></tr> <tr><td style="text-align:center;">dragleave</td> <td style="text-align:center;">源对象离开目标对象的范围</td> <td style="text-align:center;">事件对象Event</td></tr> <tr><td style="text-align:center;">drop</td> <td style="text-align:center;">源对象被拖放到目标对象内</td> <td style="text-align:center;">拖拽节点Node | 事件对象Event</td></tr></tbody></table> <h2 id="配合echarts的示例"><a href="#配合echarts的示例" class="header-anchor">#</a> 配合echarts的示例</h2> <p>拖拽操作配合其他三方库, 可以产生丰富的效果, 这里提供一个拖放数据生成echarts图表的例子
<img src="/assets/img/bar.eb5f4ed2.gif" alt="An image"> <img src="/assets/img/map.0be95d81.gif" alt="An image"> <img src="/assets/img/relation.ac7899b3.gif" alt="An image"></p></div> <footer class="page-edit"><!----> <!----></footer> <div class="page-nav"><p class="inner"><span class="prev">
←
<a href="/" class="prev router-link-active">介绍</a></span> <span class="next"><a href="/EXAMPLE.html">示例</a>
→
</span></p></div> </main></div><div class="global-ui"></div></div>
<script src="/assets/js/app.81b2bbf8.js" defer></script><script src="/assets/js/3.8ecbad55.js" defer></script><script src="/assets/js/5.1c5452aa.js" defer></script>
</body>
</html>