DraggableSubsets.pg

$draggable = DraggableSubsets(
    [
        'mouse',        'ebola bacteria',
        'flu virus',    'krill',
        'house cat',    'emu',
        'coyote',       'tapir',
        'hippopotamus', 'elephant',
        'blue whale',   'eagle'
    ],
    [ [], [ 0, 4, 6, 7, 8, 9, 10 ], [ 5, 11 ], [ 1, 2, 3 ] ],
    DefaultSubsets => [
        { label => 'Animals', indices => [ 0 .. 11 ] },
        { label => 'Mammals', indices => [] },
        { label => 'Birds',   indices => [] },
        { label => 'Other',   indices => [] }
    ],
    AllowNewBuckets => 0,
    OrderedSubsets  => 1
);

Setup

The DraggableSubsets method creates a drag and drop object that when inserted into the problem text creates regions called buckets representing sets that contain draggable elements that can be dragged between the buckets (or sets). The syntax for calling it is

$draggable = DraggableSubsets(
    elements,
    correct sets,
    options
);

where elements is a reference to an array of strings which are textual representations of all elements contained in the sets and correct sets is a reference to an array of array references representing the correct subsets with the elements listed by 0-based index from the elements list. There are several options that can be passed. The DefaultSubsets option is used to label and initialize the buckets, and determine where elements are initially. If the AllowNewBuckets option is set to 1, then students can add new buckets. If the OrderedSubsets option is set to 1, then the subsets in the student answers are required to be the in the same order as the subsets in the correct answer.

See draggableSubsets.pl for other options and more details.

Draggable Subsets

Complete Code

POD for Macro Files

PG problem file

Explanation