drop_receiving_element
- 1.0.0
- 1.1.6 (0)
- 1.2.6 (0)
- 2.0.3 (0)
- 2.1.0 (34)
- 2.2.1 (0)
- 2.3.8 (0)
- 3.0.0 (-5)
- 3.0.9 (-2)
- 3.1.0
- 3.2.1
- 3.2.8
- 3.2.13
- 4.0.2
- 4.1.8
- 4.2.1
- 4.2.7
- 4.2.9
- 5.0.0.1
- 5.1.7
- 5.2.3
- 6.0.0
- 6.1.3.1
- 6.1.7.7
- 7.0.0
- 7.1.3.2
- 7.1.3.4
- What's this?
drop_receiving_element(element_id, options = {})
public
Makes the element with the DOM ID specified by element_id receive dropped draggable elements (created by draggable_element). and make an AJAX call. By default, the action called gets the DOM ID of the element as parameter.
Example:
<%= drop_receiving_element("my_cart", :url => { :controller => "cart", :action => "add" }) %>
You can change the behaviour with various options, see http://script.aculo.us for more documentation.
Some of these options include:
- :accept - Set this to a string or an array of strings describing the allowable CSS classes that the draggable_element must have in order to be accepted by this drop_receiving_element.
- :confirm - Adds a confirmation dialog. Example:
:confirm => "Are you sure you want to do this?"
- :hoverclass - If set, the drop_receiving_element will have this additional CSS class when an accepted draggable_element is hovered over it.
- :onDrop - Called when a draggable_element
is dropped onto this element. Override this callback with a JavaScript
expression to change the default drop behavour. Example:
:onDrop => "function(draggable_element, droppable_element, event) { alert('I like bananas') }"
This callback gets three parameters: The Draggable element, the Droppable element and the Event object. You can extract additional information about the drop - like if the Ctrl or Shift keys were pressed - from the Event object.
- :with - A JavaScript expression specifying the parameters for the XMLHttpRequest. Any expressions should return a valid URL query string.