neoDragDropExercise creates matching, classification, and sequencing interactive activities without requiring authors to write JSON. Content is configured using standard VisualNEO Win actions, and the initial appearance is inherited from the VisualNEO style palette.
Quick Start
- Insert neoDragDrop Exercise from the modern objects palette.
- Note the object name, for example
neoDragDropDemo. - In the page enter action, call
neoDragDropExerciseClear. - Add content using actions specific to the exercise type.
- Finish with
neoDragDropExerciseStart.
Matching (Association)
neoDragDropExerciseClear "neoDragDropDemo"
neoDragDropExerciseAddPair "neoDragDropDemo" "Spain" "Madrid" "" "" "Country: Spain" "10"
neoDragDropExerciseAddPair "neoDragDropDemo" "Italy" "Rome" "" "" "Country: Italy" "10"
neoDragDropExerciseStart "neoDragDropDemo"
Classification
neoDragDropExerciseClear "neoDragDropDemo"
neoDragDropExerciseAddCategory "neoDragDropDemo" "Animals" "" ""
neoDragDropExerciseAddCategory "neoDragDropDemo" "Plants" "" ""
neoDragDropExerciseAddItemToCategory "neoDragDropDemo" "Dog" "Animals" "" "" "10"
neoDragDropExerciseAddItemToCategory "neoDragDropDemo" "Rose" "Plants" "" "" "10"
neoDragDropExerciseStart "neoDragDropDemo"
The category name used by neoDragDropExerciseAddItemToCategory must match the visible name added via neoDragDropExerciseAddCategory.
Sequencing (Ordering)
neoDragDropExerciseClear "neoDragDropDemo"
neoDragDropExerciseAddOrderItem "neoDragDropDemo" "1. Prepare materials" "" "" "10"
neoDragDropExerciseAddOrderItem "neoDragDropDemo" "2. Perform experiment" "" "" "10"
neoDragDropExerciseAddOrderItem "neoDragDropDemo" "3. Record results" "" "" "10"
neoDragDropExerciseStart "neoDragDropDemo"
Items are added in the correct target sequence. The plugin can automatically shuffle them when started.
Actions
| Action | Usage |
|---|---|
neoDragDropExerciseClear | Clears all current content. |
neoDragDropExerciseAddPair | Adds an item and its matching destination. |
neoDragDropExerciseAddCategory | Adds a classification category. |
neoDragDropExerciseAddItemToCategory | Adds an item associated with a visible category. |
neoDragDropExerciseAddOrderItem | Adds a sequence step in its correct position. |
neoDragDropExerciseStart | Starts or restarts the activity and applies shuffling. |
neoDragDropExerciseReset | Returns all items to their initial positions. |
neoDragDropExerciseCheck | Checks current placements. |
neoDragDropExerciseGetResult | Stores detailed score result in [neoDragDropExerciseResult]. |
neoDragDropExerciseSetLocale | Changes UI locale to auto, en, es, it, de, or ru. |
neoDragDropExerciseSetEnabled | Enables or disables interaction. |
neoDragDropExerciseImportTable | Imports exercise content from CSV or TSV files. |
All parameters appear in the VisualNEO action wizard. Image selectors accept PNG, JPEG, and BMP; accessible descriptions are optional; default points are 10.
Properties
- Exercise Type: Matching, Classification, or Sequencing. Content actions also automatically set the matching mode.
- Instructions: Text displayed above the activity.
- Answer Checking: Check each placement immediately, check when button is clicked, or practice mode without penalty.
- Shuffle Items: Shuffles items when starting.
- Allow Retry: Allows correcting an incorrect placement.
- Maximum Attempts:
0imposes no limit. - Show Progress and Score: Displays placed items and current score.
- Show Check Button and Show Reset Button: Controls integrated UI buttons.
- Interface Language: Automatic, English, Spanish, Italian, German, or Russian.
- Automatic Text Contrast: Automatically calculates light or dark text based on background color.
Background, border, and text values set to auto inherit from the VisualNEO Win style palette upon first load. Colors for items, targets, accents, success, and errors can be customized independently.
Events
| Event | Trigger |
|---|---|
itempicked | An item starts being dragged. |
itemdropped | An item is dropped on a target. |
correctdrop | Correct placement during immediate checking. |
incorrectdrop | Incorrect placement during immediate checking. |
attempt | Accepted placement attempt. |
checked | Answers are checked. |
completed | Completion condition is satisfied. |
reset | Activity resets to initial state. |
Item events include item ID and text, target, position, success flag, attempts, and points. checked and completed include score, max score, and number of correct placements.
Results
neoDragDropExerciseGetResult "neoDragDropDemo"
AlertBox "Result" "[neoDragDropExerciseResult]"
The detailed result contains mode, status, score, attempts, and placements for each item in structured JSON format.
Demonstration Project
Open demo/neoDragDropExercise-demo.pub in VisualNEO Win. The top buttons load all three exercise modes; Result displays detailed session information.