TN8 Item Styleguide ::: Gap Match

Gap Match

Presentation Options

Match interaction are those that operate in much the same way as multiple choice interaction, however the presentation is such that the student must move the items from an initial bay of selections into the proper bay locations. These interactions are the electronic kin to pen-and-paper matching questions where draw lines connecting items in a list on one side of the page to the corresponding items on the other side of the page.

A match interaction is comprised of two sets of of items (i.e., simpleAssociableChoice items) grouped within simpleMatchSet tags. The first set defines the draggers which will begin in a single origin bay. The second set defines the various target bays in which the draggers can be placed. Each dragger can be moved into a target bay to create a directedPair answer.

Starting with TN8 version 8.3, the draggers will maintain their initial order within the origin bay if they are removed from a target bay, dropped outside of the various defined bays, or returned to the origin bay.

gapMatchInteraction's in TN8 were completely revamped in the Fall of 2013, with much-improved usability and performance in comparison to earlier implementations. In addition to new gap styling options, you can also specify cloning rules for the gapText choices.

Note: With this implementation of gapMatchInteraction, a target gap may only hold up to one source dragger. You cannot override this setting.

By default, the Gaps in a gapMatchInteraction have a width of 100 pixels. You can override each individual gap width by placing a class on the gap: gap-width-<insert width> where the width is in pixels. In the example below, each of the two gaps are specified with the class class="gap-width-80px" to make them 80 pixels wide instead of the default 100 pixels.

Display

There is one presentation option for gap match items that can you can use to format the layout of the source draggers relative to the target bays. This presentation option is set using the interaction's class attribute.

<gapMatchInteraction class="choices-top"> : choices appear above the target bays (default)
<gapMatchInteraction class="choices-bottom"> : choices appear below the target bays
<gapMatchInteraction class="choices-left"> : choices appear to the left of target bays
<gapMatchInteraction class="choices-right"> : choices appear to the right of target bays

Minimum Associations

There is now an option for gap match items to set the minimum amount of associations (minAssociations) the student must make before the question is considered 'Answered', and until the minAssociations have been met the item status will remain 'Not Answered'.

If minAssociations is undefined, then the default is set to 1 and the item is considered answered if one association exists.
If minAssociations is specified as 0, then the item is also considered answered if only one association exists.
If minAssociations is any number greater than 1, the student must make that number of associations before the item is considered answered.

<gapMatchInteraction responseIdentifier="RESPONSE" minAssociations=2>

Ignore Answer

If a gap match interaction is inside a composite item there is an option to have the gap match interaction be ignored when the answered status of the item is being determined. To do this, add the class ignore-answered to the interactions class attribute.
Example: <gapMatchInteraction responseIdentifier="RESPONSE" class="ignore-answered">

Get Responses:

[ Click Get Responses ]

Item XML

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<assessmentItem xmlns="http://www.imsglobal.org/xsd/imsqti_v2p1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
adaptive="false" identifier="gapMatch" timeDependent="false" title="Richard III (Take 1)"
xsi:schemaLocation="http://www.imsglobal.org/xsd/imsqti_v2p1 http://www.imsglobal.org/xsd/imsqti_v2p1.xsd">
  <responseDeclaration baseType="directedPair" cardinality="multiple" identifier="RESPONSE">
    <correctResponse>
      <value>W G1</value>
      <value>Su G2</value>
    </correctResponse>
    <mapping defaultValue="-1" lowerBound="0">
      <mapEntry mapKey="W G1" mappedValue="1" />
      <mapEntry mapKey="Su G2" mappedValue="2" />
    </mapping>
  </responseDeclaration>
  <outcomeDeclaration baseType="float" cardinality="single" identifier="SCORE" />
  <itemBody>
    <gapMatchInteraction responseIdentifier="RESPONSE">
      <prompt>Identify the missing words in this famous quote from
      Shakespeare's Richard III.</prompt>
      <gapText identifier="W" matchMax="1">winter</gapText>
      <gapText identifier="Sp" matchMax="1">spring</gapText>
      <gapText identifier="Su" matchMax="1">summer</gapText>
      <gapText identifier="A" matchMax="1">autumn</gapText>
      <blockquote>
        <p>Now is the <gap identifier="G1" class="gap-width-80px"/>of our discontent <br />
        Made glorious <gap identifier="G2" class="gap-width-80px"/>by this sun of York;<br />
        And all the clouds that lour'd upon our house<br />
        In the deep bosom of the ocean buried.</p>
      </blockquote>
    </gapMatchInteraction>
  </itemBody>
  <responseProcessing template="http://www.imsglobal.org/question/qti_v2p1/rptemplates/map_response" />
</assessmentItem>