In the first step, you can set some basic properties of the component,
In the first step, you can set some basic properties of the component,
such as the title, the maximum score, the question text to render
such as the title, the maximum score, the problem text to render
above the background image, the introductory feedback (shown
above the background image, the introductory feedback (shown
initially), and the final feedback (shown after the student
initially), and the final feedback (shown after the learner
successfully completes the drag and drop problem).
successfully completes the drag and drop problem).


...
@@ -109,7 +109,7 @@ image and define the properties of the drop zones. For each zone you
...
@@ -109,7 +109,7 @@ image and define the properties of the drop zones. For each zone you
can specify the text that should be rendered inside it (the "zone
can specify the text that should be rendered inside it (the "zone
label"), how wide and tall it should be, and where it should be placed
label"), how wide and tall it should be, and where it should be placed
on the background image. In this step you can also specify whether you
on the background image. In this step you can also specify whether you
would like zone labels to be shown to students or not, as well as
would like zone labels to be shown to learners or not, as well as
whether or not to display borders outlining the zones. It is possible
whether or not to display borders outlining the zones. It is possible
to define an arbitrary number of drop zones as long as their labels
to define an arbitrary number of drop zones as long as their labels
are unique.
are unique.
...
@@ -120,16 +120,16 @@ In the final step, you define the background and text color for drag
...
@@ -120,16 +120,16 @@ In the final step, you define the background and text color for drag
items, as well as the drag items themselves. A drag item can contain
items, as well as the drag items themselves. A drag item can contain
either text or an image. You can define custom success and error
either text or an image. You can define custom success and error
feedback for each item. The feedback text is displayed in a popup
feedback for each item. The feedback text is displayed in a popup
after the student drops the item on a zone - the success feedback is
after the learner drops the item on a zone - the success feedback is
shown if the item is dropped on the correct zone, while the error
shown if the item is dropped on the correct zone, while the error
feedback is shown when dropping the item on an incorrect drop zone.
feedback is shown when dropping the item on an incorrect drop zone.
Additionally, items can have a numerical value (and an optional error
Additionally, items can have a numerical value (and an optional error
margin) associated with them. When a student drops an item that has a
margin) associated with them. When a learner drops an item that has a
numerical value on the correct zone, an input field for entering a
numerical value on the correct zone, an input field for entering a
value is shown next to the item. The value that the student submits is
value is shown next to the item. The value that the learner submits is
checked against the expected value for the item. If you also specify a
checked against the expected value for the item. If you also specify a
margin, the value entered by the student will be considered correct if
margin, the value entered by the learner will be considered correct if
it does not differ from the expected value by more than that margin
it does not differ from the expected value by more than that margin
(and incorrect otherwise).
(and incorrect otherwise).
...
@@ -192,7 +192,7 @@ Real event example (taken from a devstack):
...
@@ -192,7 +192,7 @@ Real event example (taken from a devstack):
## `edx.drag_and_drop_v2.item.picked_up`
## `edx.drag_and_drop_v2.item.picked_up`
Fired when a student picks up a draggable item.
Fired when a learner picks up a draggable item.
Example ("common" fields that are not interesting in this context have been left out):
Example ("common" fields that are not interesting in this context have been left out):
...
@@ -240,9 +240,9 @@ Real event example (taken from a devstack):
...
@@ -240,9 +240,9 @@ Real event example (taken from a devstack):
## `edx.drag_and_drop_v2.item.dropped`
## `edx.drag_and_drop_v2.item.dropped`
Fired when a student drops a draggable item.
Fired when a learner drops a draggable item.
This event will be emitted when a student drops a draggable item.
This event will be emitted when a learner drops a draggable item.
Example ("common" fields that are not interesting in this context have been left out):
Example ("common" fields that are not interesting in this context have been left out):
...
@@ -251,7 +251,7 @@ Example ("common" fields that are not interesting in this context have been left
...
@@ -251,7 +251,7 @@ Example ("common" fields that are not interesting in this context have been left
...
...
"event": {
"event": {
"input": null,
"input": null,
"is_correct": true, -- False if there is an input in the draggable item, and the student provided the wrong answer. Otherwise true.
"is_correct": true, -- False if there is an input in the draggable item, and the learner provided the wrong answer. Otherwise true.
"is_correct_location": true, -- Whether the draggable item has been placed in the correct location.
"is_correct_location": true, -- Whether the draggable item has been placed in the correct location.
"item_id": 0, -- ID of the draggable item.
"item_id": 0, -- ID of the draggable item.
"location": "The Top Zone", -- Name of the location the item was dragged to.
"location": "The Top Zone", -- Name of the location the item was dragged to.
{{i18n"Optional numerical value (if you set this, students will be prompted for this value after dropping this item)"}}
{{i18n"Optional numerical value (if you set this, learners will be prompted for this value after dropping this item)"}}
</label>
</label>
<inputtype="number"
<inputtype="number"
step="0.1"
step="0.1"
...
@@ -110,7 +110,7 @@
...
@@ -110,7 +110,7 @@
</div>
</div>
<divclass="row advanced">
<divclass="row advanced">
<labelfor="item-{{id}}-numerical-margin">
<labelfor="item-{{id}}-numerical-margin">
{{i18n"Margin ± (when a numerical value is required, values entered by students must not differ from the expected value by more than this margin; default is zero)"}}
{{i18n"Margin ± (when a numerical value is required, values entered by learners must not differ from the expected value by more than this margin; default is zero)"}}