Documentation

Flash Cards

Description

In the Flash Cards module, you can create cards with varied content such as text, images, and audio, which are different at the front and back of the card. Each card can be marked as a favourite and graded by the student as correct or wrong in the activity mode.

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
Cards A list of card items in which you define the front and back of each card.
Property name Description
Front The content displayed on the front side of the card.
Back The content displayed on the back side of the card. It is shown when the user clicks the front side of the card.
Audio Front The audio file in MP3 format to be displayed on the front side of the card.
Audio Back The audio file in MP3 format to be displayed on the back side of the card.
Disable Loop Disables the loop mode, so that the "previous" button won't turn to the first card and the "next" button won't turn to the last one.
Enable Favourites Enables marking cards as favourite. When enabled, the button is displayed on each card.
Hide Previous and Next Buttons Makes Previous and Next Buttons invisible.
Show Activity Buttons Displays Activity Buttons that allow marking the cards as correct or wrong. The buttons also allow users to reset the cards' state.
Is Activity When enabled, the module sends the score data depending on how many cards are marked as correct and wrong by using the Activity Buttons.
Send event only on card changed When checked, only the card change event will be sent.
Lang attribute This property allows defining the language for this module (different than the language of the lesson).
Speech texts List of speech texts: Card, Out of, Favourite, Audio, Correct, Wrong, Reset, Selected, Deselected, Card has been reset, Turned. This text will be read by the Text to Speech module after the user performs a certain action.
Randomize order When enabled, the order of cards will be randomized every time the module is loaded.

Supported commands

Command name Params Description
show - Shows the module if it is hidden.
hide - Hides the module if it is visible.
nextCard - Turns to the next card. If the "Disable Loop" property is enabled, it stops at the last card.
prevCard - Turns to the previous card. If the "Disable Loop" property is enabled, it stops at the first card.
reset - Resets everything to the initial state.
resetFavourites - Resets favourite cards' selection.
showOnlyFavourites - Displays only the cards marked as favourite.
showAllCards - Displays all cards, favourite or not.
countFavourites - Returns the number of cards marked as favourite.
play cardNumber, reverse Plays the audio file of the indicated card and side. If no argument is provided, the method will play the audio associated with the currently visible card and side. If there is no audio file associated with the selected card and side, the method does nothing. The reverse argument should be a boolean (only if used within an Advanced Connector script or a custom addon, but not an onClick property of another addon), or a string with a value of "front", "reverse", "true", or "false".
pause - Pauses the audio currently being played.
stop - Stops (pauses and resets the progress) the audio currently being played.

Events

Field name Description
Item card number.
Value favourite/unfavourite/playing/pause/ended/front/back.

CSS classes

Class name Description
.flashcards-wrapper Main module container.
.flashcards-main Wrapper of everything but the panel with card counter.
.flashcards-panel Panel with card counter.
.flashcards-prev, .flashcards-next Buttons on the sides of the module.
.flashcards-card Main card container.
.flashcards-card-audio-wrapper Audio button wrapper.
.flashcards-card-audio-button Audio button.
.flashcards-card-audio-button.playing Audio button playing state.
.flashcards-card-audio-button.disabled Audio button disabled state (while loading audio).
.flashcards-card-front, .flashcards-card-back Front and back containers.
.flashcards-card-contents Front and back content.
.flashcards-button-favourite Favourite button.
.flashcards-button-favourite.flashcards-button-selected Favourite button selected state.
.flashcards-buttons Activity mode grading buttons wrapper.
.flashcards-button Activity mode grading button.
.flashcards-button.flashcards-button-selected Activity mode grading button selected state.