====== Interactivity > Matching texts ======

A page that requires the learner to match pairs of items. One set of items is presented in a fixed column on the left side of the screen. Items to be matched with these are presented one by one in random order; after you have made a match, the next item appears at the top of the page. Task completion can be checked at any point, and items in an incorrect category can be dragged into another column before checking again.

===== Example demo =====

{{url>https://xot.xerte.org.uk/xapi_launch.php?template_id=116&group=xertepagetypes#matchingtexts}}

or view at [[https://xot.xerte.org.uk/xapi_launch.php?template_id=116&group=xertepagetypes#matchingtexts| Xerte Page Types > Interactivity: Matching Texts]] (opens in new tab).

===== Editor Interface =====

{{:xerte-inter-matchingtexts-editor.jpg?600&direct}}

==== Top Level: Core Properties ====

^ Property ^ Description ^ Type ^ Additional information ^
| Page Title | Text that appears in header of published page | Text |   |
| Instructions | Content that appears at the top of the page | Text+ (Toolbar) | Use this to give the context or instructions for the task.  Other content (e.g. images, audio, video) can be embedded here. |
| Feedback | Feedback revealed after hitting **Submit **button. | Text+ (Toolbar) |   |
| Attempts Before Hint | Number of incorrect matches before a hint is given | Text | Default - "3" |


==== Top Level: Optional Properties ====

=== Page-specific ===

^ Property ^ Description ^ Type ^ Tooltip ^
| Mark at End | Needed for Tracking - matches can only be checked after all matches have been made | Tick Box |   |
| Tracking Score Weight | Allows the task on the page to be weighted relative to other scored pages in the project.  | Text  | See the [[:trackingandweighting|Tracking and Weighting ]]page for more information on weighting.  |

=== General ===

See [[:optional_properties#General optional properties|General Optional Properties]]


==== Top Level: Language Options ====

^ Property ^ Description ^ Type ^ Additional information ^
| Correct message | Text which appears, after clicking on Check Button, if all matches are correct.  | Text | Default - "Correct answers are shown"  |
| Check Button Label | Text on button for checking matches.  | Text | Default - "Submit" |
| All Wrong Text | Text which appears if all matches are incorrect. | Text | Default  -"You have not placed any labels correctly. Try again."  You might want to rephrase this  *None of your matches are correct. Try again".  |
| {i} out of {n} Text | Gives score for page |   | Default - "You have scored {i} out of {n}. Try again." |
| All Wrong Text Tracking | Text if all matches are incorrect, which appears if the project has been deployed as SCORM or LTI/xAPI |   | Default - "You have not placed any labels correctly." You might want to rephrase this  *None of your matches are correct." |
| {i} out of {n} Text Tracking | Text giving score, which appears if the project has been deployed as SCORM or LTI/xAPI |   | Default - "You have scored {i} out of {n}." |
| Incomplete Text | Text which appears if one or more matches remain to be attempted. |   | Default - "Complete the exercise." |

Add **New Sentence** for each match you need.


==== Sentence: Core Properties ====

^ Property ^ Description ^ Type ^ Tooltip ^
| Part 1 | Fixed content for matches, which appears to learners in the left pane | Text+ (Toolbar) | Can be text or an image.  |
| Part 2 | Draggable item to be matched with Part 1 | Text+ (Toolbar) | Can be text or an image. |
| Hint | A hint which appears after a set number of incorrect matches | Text+ (Toolbar) | Delete the default text if you do not want to use a hint.  |

There are **no Language Options** for sentences, and only **one Optional Property**. You can add **Audio Feedback**, by uploading an audio file through the Media Browser.


===== Further information =====

This page can be tracked.

:!: Matching is fiddly for learners if they have to scroll up and down to access all drop zones.  Dragging and scrolling at the same time does not work consistently. Items can be dropped temporarily into any drop zone and then re-dragged after scrolling, but this adds an additional layer of complication. Zooming out solves the problem, but may impact on readability.  In practice, 3 - 5 matches is an optimum for one page.  If more than 5 matches need to be made, consider designing the task over 2 or more pages.

{{tag>pagetype interactivity}}