Documentation
Image gap
Description
An Image gap module is an empty box which should be filled in with a relevant item (image) from an Image source module. Each gap and each image are separate modules – Image gap and Image source respectively. In order to indicate a correct answer, it is required to put the image source module ID in the Answer ID section.
Properties
The list starts with the common properties, learn more about them by visiting the Modules description section. The other available properties are described below.
Property name | Description |
---|---|
Answer ID | This property serves for inserting the ID of the corresponding answer in the Image source module |
Is activity | This property allows to define whether an image gap module is an activity or not. When it is not defined as an activity, the answers given are not taken into account in the overall result. It is helpful for e.g. simulations. |
onCorrect | This property indicates the events sent when a gap's state is changed to correct. |
onWrong | This property indicates the events sent when a gap's state is changed to wrong. |
onEmpty | This property indicates the events sent when a gap's state is changed to empty. |
Is Disabled | Allows disabling the module so that the user is not able to interact with it. |
Block wrong answers | With this option checked, wrong answers are removed and the "on wrong" event is sent. |
Supported commands
Command name | Params | Description |
---|---|---|
markGapAsCorrect | index – 1-based gap index in text | Marks gap as correct. |
markGapAsWrong | index – 1-based gap index in text | Marks gap as wrong. |
markGapAsEmpty | index – 1-based gap index in text | Marks gap as empty. |
isAttempted | – | Returns True if a gap is filled in. |
disable | – | Disables the module. |
enable | – | Enables the module. |
getImageId | – | Returns the image ID in a gap. |
isAllOK | – | Returns true if an image in a gap is correct. |
Show Answers
This module is fully compatible with Show Answers module and displays correct answers when adequate event is sent.
CSS classes
Class name | Description |
---|---|
.ic_imageGap | indicates the look of the items included in the source list |
.ic_imageGap-filled | indicates the look of an image gap with an image source placed in it |
.ic_imageGap-correct | indicates the look of an image gap with a correct answer |
.ic_gapImage-wrong | indicates the look of an image gap with a wrong answer |
.ic_gapImageFilled-disabled | indicates the look of a disabled image gap |
.ic_gapImageFilled-empty | indicates the look of an image gap with an empty answer |
.ic_imageGap-correct-answer | indicates the look of an image gap with the correct answer displayed |
Examples
2.1. Image gap
.ic_imageGap{
cursor: pointer;
border: 2px solid #d5dddf;
background-color: #fdfbf2
}
2.2. Image gap filled
.ic_imageGap-filled{
cursor: pointer;
border: 2px solid #d5dddf;
background-color: #fdfbf2;
box-shadow: 2px 2px 3px #406d93;
}
2.3. Image gap filled — correct
.ic_imageGap-correct{
border: 2px solid green;
}
2.4. Image gap filled — wrong
.ic_imageGap-wrong{
border: 2px solid red;
}
Demo presentation
Demo presentation contains examples of the addon's usage.