setting.callback.beforeDrag.html 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. <div class="apiDetail">
  2. <div>
  3. <h2><span>Function(treeId, treeNodes)</span><span class="path">setting.callback.</span>beforeDrag</h2>
  4. <h3>Overview<span class="h3_info">[ depends on <span class="highlight_green">jquery.ztree.exedit</span> js ]</span></h3>
  5. <div class="desc">
  6. <p></p>
  7. <div class="longdesc">
  8. <p>Specify callback function to be called before the drag node callback, The return value controls whether the drag node callback will execute.</p>
  9. <p>Default: null</p>
  10. </div>
  11. </div>
  12. <h3>Function Parameter Descriptions</h3>
  13. <div class="desc">
  14. <h4><b>treeId</b><span>String</span></h4>
  15. <p>zTree unique identifier: <b class="highlight_red">treeId</b>, the id of the containing tree.</p>
  16. <h4 class="topLine"><b>treeNodes</b><span>Array(JSON)</span></h4>
  17. <p>A collection of the nodes being dragged</p>
  18. <p class="highlight_red">v3.x allows the drag and drop of multiple sibling nodes, so this parameter's type is changed to Array(JSON).</p>
  19. <p class="highlight_red">If the selected nodes aren't sibling nodes, you can only drag one node.</p>
  20. <h4 class="topLine"><b>Return </b><span>Boolean</span></h4>
  21. <p>return true or false</p>
  22. <p class="highlight_red">If return false, zTree will abort the drag and drop, and will not trigger the 'onDrag / beforeDrop / onDrop' sequence of callbacks.</p>
  23. </div>
  24. <h3>Examples of setting & function</h3>
  25. <h4>1. disable drag completely (by returning false)</h4>
  26. <pre xmlns=""><code>function myBeforeDrag(treeId, treeNodes) {
  27. return false;
  28. };
  29. var setting = {
  30. edit: {
  31. enable: true
  32. },
  33. callback: {
  34. beforeDrag: myBeforeDrag
  35. }
  36. };
  37. ......</code></pre>
  38. </div>
  39. </div>