VisualNEO Win Plugin Manual

neoDragDropExercise Manual

Plugin ID:com.visualneo.neodragdrop
Suite:VisualNEO UI & Data Suite (Commercial)
Publisher:SinLios
Category:Education / Drag & Drop Exercises
Control:neo-drag-drop-exercise

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

  1. Insert neoDragDrop Exercise from the modern objects palette.
  2. Note the object name, for example neoDragDropDemo.
  3. In the page enter action, call neoDragDropExerciseClear.
  4. Add content using actions specific to the exercise type.
  5. Finish with neoDragDropExerciseStart.

Matching (Association)

TEXT
neoDragDropExerciseClear "neoDragDropDemo"
neoDragDropExerciseAddPair "neoDragDropDemo" "Spain" "Madrid" "" "" "Country: Spain" "10"
neoDragDropExerciseAddPair "neoDragDropDemo" "Italy" "Rome" "" "" "Country: Italy" "10"
neoDragDropExerciseStart "neoDragDropDemo"

Classification

TEXT
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)

TEXT
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

ActionUsage
neoDragDropExerciseClearClears all current content.
neoDragDropExerciseAddPairAdds an item and its matching destination.
neoDragDropExerciseAddCategoryAdds a classification category.
neoDragDropExerciseAddItemToCategoryAdds an item associated with a visible category.
neoDragDropExerciseAddOrderItemAdds a sequence step in its correct position.
neoDragDropExerciseStartStarts or restarts the activity and applies shuffling.
neoDragDropExerciseResetReturns all items to their initial positions.
neoDragDropExerciseCheckChecks current placements.
neoDragDropExerciseGetResultStores detailed score result in [neoDragDropExerciseResult].
neoDragDropExerciseSetLocaleChanges UI locale to auto, en, es, it, de, or ru.
neoDragDropExerciseSetEnabledEnables or disables interaction.
neoDragDropExerciseImportTableImports 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: 0 imposes 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

EventTrigger
itempickedAn item starts being dragged.
itemdroppedAn item is dropped on a target.
correctdropCorrect placement during immediate checking.
incorrectdropIncorrect placement during immediate checking.
attemptAccepted placement attempt.
checkedAnswers are checked.
completedCompletion condition is satisfied.
resetActivity 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

TEXT
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.