1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00

Documentation for the drop_receiving_element helpers :onDrop callback. Closes #11158 [thechrisoshow]

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@8983 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
This commit is contained in:
Pratik Naik 2008-03-05 10:53:04 +00:00
parent be62024c25
commit b1f6bb90b9

View file

@ -117,12 +117,12 @@ module ActionView
# that has this CSS class value will be used as the handle. # that has this CSS class value will be used as the handle.
# #
# <tt>:ghosting</tt>:: Clones the element and drags the clone, leaving the original # <tt>:ghosting</tt>:: Clones the element and drags the clone, leaving the original
# in place until the clone is dropped (defaut is <tt>false</tt>). # in place until the clone is dropped (default is <tt>false</tt>).
# #
# <tt>:dropOnEmpty</tt>:: If set to true, the Sortable container will be made into # <tt>:dropOnEmpty</tt>:: If set to true, the Sortable container will be made into
# a Droppable, that can receive a Draggable (as according to # a Droppable, that can receive a Draggable (as according to
# the containment rules) as a child element when there are no # the containment rules) as a child element when there are no
# more elements inside (defaut is <tt>false</tt>). # more elements inside (default is <tt>false</tt>).
# #
# <tt>:onChange</tt>:: Called whenever the sort order changes while dragging. When # <tt>:onChange</tt>:: Called whenever the sort order changes while dragging. When
# dragging from one Sortable to another, the callback is # dragging from one Sortable to another, the callback is
@ -180,6 +180,34 @@ module ActionView
# #
# You can change the behaviour with various options, see # You can change the behaviour with various options, see
# http://script.aculo.us for more documentation. # http://script.aculo.us for more documentation.
#
# Some of these +options+ include:
# <tt>:accept</tt>:: 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.
#
# <tt>:confirm</tt>:: Adds a confirmation dialog.
#
# Example:
# :confirm => "Are you sure you want to do this?"
#
# <tt>:hoverclass</tt>:: If set, the drop_receiving_element will have this additional CSS class
# when an accepted draggable_element is hovered over it.
#
# <tt>:onDrop</tt>:: 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.
#
# <tt>:with</tt>:: A JavaScript expression specifying the parameters for the XMLHttpRequest.
# Any expressions should return a valid URL query string.
def drop_receiving_element(element_id, options = {}) def drop_receiving_element(element_id, options = {})
javascript_tag(drop_receiving_element_js(element_id, options).chop!) javascript_tag(drop_receiving_element_js(element_id, options).chop!)
end end