From b1f6bb90b9e0e4fe2d153559c2fe07d16e8729fa Mon Sep 17 00:00:00 2001 From: Pratik Naik Date: Wed, 5 Mar 2008 10:53:04 +0000 Subject: 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 --- .../action_view/helpers/scriptaculous_helper.rb | 34 ++++++++++++++++++++-- 1 file changed, 31 insertions(+), 3 deletions(-) (limited to 'actionpack/lib') diff --git a/actionpack/lib/action_view/helpers/scriptaculous_helper.rb b/actionpack/lib/action_view/helpers/scriptaculous_helper.rb index 69fab27ac8..60e285b722 100644 --- a/actionpack/lib/action_view/helpers/scriptaculous_helper.rb +++ b/actionpack/lib/action_view/helpers/scriptaculous_helper.rb @@ -100,7 +100,7 @@ module ActionView # out child elements as candidates. # # :scroll:: Determines whether to scroll the list during drag - # operationsif the list runs past the visual border. + # operations if the list runs past the visual border. # # :tree:: Determines whether to treat nested lists as part of the # main sortable list. This means that you can create multi- @@ -117,12 +117,12 @@ module ActionView # that has this CSS class value will be used as the handle. # # :ghosting:: Clones the element and drags the clone, leaving the original - # in place until the clone is dropped (defaut is false). + # in place until the clone is dropped (default is false). # # :dropOnEmpty:: If set to true, the Sortable container will be made into # a Droppable, that can receive a Draggable (as according to # the containment rules) as a child element when there are no - # more elements inside (defaut is false). + # more elements inside (default is false). # # :onChange:: Called whenever the sort order changes while dragging. When # dragging from one Sortable to another, the callback is @@ -180,6 +180,34 @@ module ActionView # # 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. def drop_receiving_element(element_id, options = {}) javascript_tag(drop_receiving_element_js(element_id, options).chop!) end -- cgit v1.2.3