adapt-contrib-assessmentResultsTotal-audio

Multiple Assessment Results is an audio enabled presentation component.

It is used to display the total result of all assessment's. It can be used only in conjunction with adapt-contrib-assessment. Feedback and the opportunity to reattempt the assessment may be coordinated with range of scores, and most importantly, with the _scoreToPass variable from Assessment.

Installation

This custom component must be installed manually.

Settings Overview

Important note: do not put the Multiple Assessment Results component in the same article as the assessment itself.

The attributes listed below are used in components.json to configure Multiple Assessment Results, and are properly formatted as JSON in example.json. Visit the Multiple Assessment Results wiki for more information about how they appear in the authoring tool.

Attributes

core model attributes: These are inherited by every Adapt component. Read more.

_component (string): This value must be: assessmentResultsTotalAudio. (One word with uppercase "R".)

_classes (string): CSS class name(s) to be applied to Multiple Assessment Results’ containing div. The class(es) must be predefined in one of the Less files. Separate multiple classes with a space.

_layout (string): This defines the horizontal position of the component in the block. Values can be full, left or right.

instruction (string): This optional text appears above the component. It is frequently used to guide the learner’s interaction with the component.

_isVisibleBeforeCompletion (boolean): Determines whether this component will be visible as the learner enters the assessment article or if it will be displayed only after the learner completes all question components. Acceptable values are true or false. The default is false.

_setCompletionOn (string): Can be set to "inview" or "pass". A a setting of "inview" will cause the component to be marked as completed when it has been viewed regardless of whether or not the assessments are passed, whereas a setting of "pass" will cause the component to be set to completed when this component has been viewed and the assessments have been passed. This setting can be very useful if you have further content on the page that's hidden by trickle which you don't want the user to be able to access until they have passed the assessment. Default is "inview".

_assessmentId (Array): This contains a list of assessments which must match the _id of the assessment for which results should be displayed.

feedback (string): This text is displayed only when both _allowRetry is true and more attempts remain (configured in adapt-contrib-assessment). It may make use of the following variables: {{attemptsSpent}}, {{attempts}}, {{attemptsLeft}}, {{score}}, {{scoreAsPercent}} and {{maxScore}}. These values are populated with data supplied by adapt-contrib-assessment. {{{feedback}}}, representing the feedback assigned to the appropriate band within this component, is also allowed.

_completionBody (string): This text overwrites the standard body attribute upon completion of the assessment. It may make use of the following variables: {{attemptsSpent}}, {{attempts}}, {{attemptsLeft}}, {{score}}, {{scoreAsPercent}} and {{maxScore}}. The variable {{{feedback}}}, representing the feedback assigned to the appropriate band, is also allowed.

_bands (object array): Multiple items may be created. Each item represents the feedback and opportunity to retry for the appropriate range of scores. _bands contains values for _score, feedback, and instruction.

_score (number): This numeric value represents the raw score or percentile (as determined by the configuration of adapt-contrib-assessment) that indicates the low end or start of the range. The range continues to the next highest _score of another band.

feedback (string): This text will be displayed to the learner when the learner's score falls within this band's range. It replaces the {{{feedback}}} variable when the variable is used within _completionBody.

instruction (string): This optional text appears below the feedback. It is frequently used to guide the learner’s interaction with the component.

In the image to the right, numbers are paired with the text's source attributes as follows:

_displayTitle
_bands.feedback
{{scoreAsPercent}}

For a guide on the difference between using two curly braces and three curly braces when working with the variables that are available in this component, see the HTML escaping section of the the Handlebars website

Limitations

No known limitations.

Version number: 3.1.4
Framework versions: 5+
Author / maintainer: DeltaNet, forked from adapt-contrib-assessmentResultsTotal
Accessibility support: WAI AA
RTL support: yes
Cross-platform coverage: Chrome, Chrome for Android, Firefox (ESR + latest version), Edge, IE11, Safari 13+14 for macOS+iOS

deltanet / adapt-contrib-assessmentresultstotal-audio Goto Github PK