Components
Created by Smart Sparrow

Matching

The Matching component provides two lists of items where the learner can match an item on one list with one or more items on the corresponding list. This allows the learner to apply their understanding of the relationship between terms or concepts. For instance, one list could be a list of terms while the corresponding list contains the definitions of the terms. The learner has to match the definition of the term with the actual term.

 

Unique ways to use this widget

There are multiple ways you can use this widget to assess learner knowledge. For example:

  • Ask students to match terms with their definitions
  • Ask student to categorize terms
  • Ask students how they think items are related
  • Guide the students with hints as they make their matches

 

Have a play

 

Basic setup instructions

  1. This component can be found in the Author. Insert the widget from the Components tab and resize it to your liking.
  2. With the component selected, Click on Configure and select Options to set it up.
  3. You must change the Mode to Config mode to set up the widget.
  4. Select one of the boxes with the plus symbol to write your first item. You can create as many items in either column as necessary.
  5. Rename the item to something more simple or memorable if necessary. By default, the name of the item will be the first few words of the text.
  6. Change the order if the item list by selecting an item and dragging it or up and down.
  7. Set the correct answer by selecting “Edit Correct State” once all items have been added. The correct answer can be set by selecting an item so that a line appears. Drag the line across to its matching item.
  8. To delete a matching line, select the “x” symbol
  9. When done, select Save.
  10. Once you’re done, open the Options menu and change the Mode to Student.
  11. Have a look at the CAPI table desciption at the bottom of the article for more information on what you can do.

 

Other Options

  • You can add images to your matching activities by pasting the url of your image in the boxes with the + symbol. You can then easily build activities linking images with text or images together.

 

Accessibility

The Matching component can be used to develop activities which can be completed using a keyboard and/or a screen readers.

When using a screen reader, a student will be read a voice instruction explaining how to form a match between items in one list to the corresponding item(s) in the second list. As a student moves through the first list, they will be read each item and the student will have the option to select it using their keyboard. Once the first item is selected, the student will then be able to make a selection from the second list where again the items from this list will be read to the student.

Throughout the activity, a student will be able to perform other functions such as un matching items or reviewing existing matches when using a screen reader.

 

Component Properties

Properties available for creating trap states or configuring your questions.

Property Purpose Type
Items.{itemIndex}.Label
Label
String
Items.{itemIndex}.Links to
Link items ids
Array
Items.{itemIndex}.Link count
Number of links
Number
Items.{itemIndex}.Is Correct
Number of links
Boolean
Items.{itemIndex}.Allow Link Count
Number of allowed links
Number
Sim Settings.Mode
The current screen the widget is showing
Config
Student
Sim Settings.Config JSON
The configuration data for the widget
String
Sim Settings.Custom CSS
Link to or inline custom css
String
Is Correct
If links are correct or not
Boolean
Show Hints
Mark items as correct or incorrect
Boolean
Show Correct
Shows students the correct answer
Boolean
Total Links
Show the total number of links between items
Number
User Modified
Whether or not the widget has been modified
Boolean
Property Purpose Type
Items.{itemIndex}.Label
Label
String
Items.{itemIndex}.Links to
Link items ids
Array
Items.{itemIndex}.Link count
Number of links
Number
Items.{itemIndex}.Is Correct
Number of links
Boolean
Items.{itemIndex}.Allow Link Count
Number of allowed links
Number
Sim Settings.Mode
The current screen the widget is showing
Config
Student
Sim Settings.Config JSON
The configuration data for the widget
String
Sim Settings.Custom CSS
Link to or inline custom css
String
Is Correct
If links are correct or not
Boolean
Show Hints
Mark items as correct or incorrect
Boolean
Show Correct
Shows students the correct answer
Boolean
Total Links
Show the total number of links between items
Number
User Modified
Whether or not the widget has been modified
Boolean
Property Purpose Type
Items.{itemIndex}.Label
Label
String
Items.{itemIndex}.Links to
Link items ids
Array
Items.{itemIndex}.Link count
Number of links
Number
Items.{itemIndex}.Is Correct
Number of links
Boolean
Items.{itemIndex}.Allow Link Count
Number of allowed links
Number
Sim Settings.Mode
The current screen the widget is showing
Config
Student
Sim Settings.Config JSON
The configuration data for the widget
String
Sim Settings.Custom CSS
Link to or inline custom css
String
Is Correct
If links are correct or not
Boolean
Show Hints
Mark items as correct or incorrect
Boolean
Show Correct
Shows students the correct answer
Boolean
Total Links
Show the total number of links between items
Number
User Modified
Whether or not the widget has been modified
Boolean
Property Purpose Type
Items.{itemIndex}.Label
Label
String
Items.{itemIndex}.Links to
Link items ids
Array
Items.{itemIndex}.Link count
Number of links
Number
Items.{itemIndex}.Is Correct
Number of links
Boolean
Items.{itemIndex}.Allow Link Count
Number of allowed links
Number
Sim Settings.Mode
The current screen the widget is showing
Config
Student
Sim Settings.Config JSON
The configuration data for the widget
String
Sim Settings.Custom CSS
Link to or inline custom css
String
Is Correct
If links are correct or not
Boolean
Show Hints
Mark items as correct or incorrect
Boolean
Show Correct
Shows students the correct answer
Boolean

 

Advanced widget setup

Contact our team for help setting up the widget and trap states in your lessons.

Want to work with us to create your own component?
Request services