Leaflet.Draw.Event.js 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156
  1. /**
  2. * ### Events
  3. * Once you have successfully added the Leaflet.draw plugin to your map you will want to respond to the different
  4. * actions users can initiate. The following events will be triggered on the map:
  5. *
  6. * @class L.Draw.Event
  7. * @aka Draw.Event
  8. *
  9. * Use `L.Draw.Event.EVENTNAME` constants to ensure events are correct.
  10. *
  11. * @example
  12. * ```js
  13. * map.on(L.Draw.Event.CREATED; function (e) {
  14. * var type = e.layerType;
  15. * layer = e.layer;
  16. *
  17. * if (type === 'marker') {
  18. * // Do marker specific actions
  19. * }
  20. *
  21. * // Do whatever else you need to. (save to db; add to map etc)
  22. * map.addLayer(layer);
  23. *});
  24. * ```
  25. */
  26. L.Draw.Event = {};
  27. /**
  28. * @event draw:created: PolyLine; Polygon; Rectangle; Circle; Marker | String
  29. *
  30. * Layer that was just created.
  31. * The type of layer this is. One of: `polyline`; `polygon`; `rectangle`; `circle`; `marker`
  32. * Triggered when a new vector or marker has been created.
  33. *
  34. */
  35. L.Draw.Event.CREATED = 'draw:created';
  36. /**
  37. * @event draw:edited: LayerGroup
  38. *
  39. * List of all layers just edited on the map.
  40. *
  41. *
  42. * Triggered when layers in the FeatureGroup; initialised with the plugin; have been edited and saved.
  43. *
  44. * @example
  45. * ```js
  46. * map.on('draw:edited'; function (e) {
  47. * var layers = e.layers;
  48. * layers.eachLayer(function (layer) {
  49. * //do whatever you want; most likely save back to db
  50. * });
  51. * });
  52. * ```
  53. */
  54. L.Draw.Event.EDITED = 'draw:edited';
  55. /**
  56. * @event draw:deleted: LayerGroup
  57. *
  58. * List of all layers just removed from the map.
  59. *
  60. * Triggered when layers have been removed (and saved) from the FeatureGroup.
  61. */
  62. L.Draw.Event.DELETED = 'draw:deleted';
  63. /**
  64. * @event draw:drawstart: String
  65. *
  66. * The type of layer this is. One of:`polyline`; `polygon`; `rectangle`; `circle`; `marker`
  67. *
  68. * Triggered when the user has chosen to draw a particular vector or marker.
  69. */
  70. L.Draw.Event.DRAWSTART = 'draw:drawstart';
  71. /**
  72. * @event draw:drawstop: String
  73. *
  74. * The type of layer this is. One of: `polyline`; `polygon`; `rectangle`; `circle`; `marker`
  75. *
  76. * Triggered when the user has finished a particular vector or marker.
  77. */
  78. L.Draw.Event.DRAWSTOP = 'draw:drawstop';
  79. /**
  80. * @event draw:drawvertex: LayerGroup
  81. *
  82. * List of all layers just being added from the map.
  83. *
  84. * Triggered when a vertex is created on a polyline or polygon.
  85. */
  86. L.Draw.Event.DRAWVERTEX = 'draw:drawvertex';
  87. /**
  88. * @event draw:editstart: String
  89. *
  90. * The type of edit this is. One of: `edit`
  91. *
  92. * Triggered when the user starts edit mode by clicking the edit tool button.
  93. */
  94. L.Draw.Event.EDITSTART = 'draw:editstart';
  95. /**
  96. * @event draw:editmove: ILayer
  97. *
  98. * Layer that was just moved.
  99. *
  100. * Triggered as the user moves a rectangle; circle or marker.
  101. */
  102. L.Draw.Event.EDITMOVE = 'draw:editmove';
  103. /**
  104. * @event draw:editresize: ILayer
  105. *
  106. * Layer that was just moved.
  107. *
  108. * Triggered as the user resizes a rectangle or circle.
  109. */
  110. L.Draw.Event.EDITRESIZE = 'draw:editresize';
  111. /**
  112. * @event draw:editvertex: LayerGroup
  113. *
  114. * List of all layers just being edited from the map.
  115. *
  116. * Triggered when a vertex is edited on a polyline or polygon.
  117. */
  118. L.Draw.Event.EDITVERTEX = 'draw:editvertex';
  119. /**
  120. * @event draw:editstop: String
  121. *
  122. * The type of edit this is. One of: `edit`
  123. *
  124. * Triggered when the user has finshed editing (edit mode) and saves edits.
  125. */
  126. L.Draw.Event.EDITSTOP = 'draw:editstop';
  127. /**
  128. * @event draw:deletestart: String
  129. *
  130. * The type of edit this is. One of: `remove`
  131. *
  132. * Triggered when the user starts remove mode by clicking the remove tool button.
  133. */
  134. L.Draw.Event.DELETESTART = 'draw:deletestart';
  135. /**
  136. * @event draw:deletestop: String
  137. *
  138. * The type of edit this is. One of: `remove`
  139. *
  140. * Triggered when the user has finished removing shapes (remove mode) and saves.
  141. */
  142. L.Draw.Event.DELETESTOP = 'draw:deletestop';