Confidence Slider is a reflective question component bundled with the Adapt framework.
To respond to the question, the learner positions a slider along a scale. Upon submission, feedback is provided via the Tutor extension, if installed. A second confidence slider can be created and linked to this one. This allows learners to compare his/her confidence to a previous measurement. Feedback may be coordinated according to the selected slider position. In addition, the linked slider may contain comparative feedback. Please note that a confidence slider does not have correct/incorrect answers and so the number of attempts is constrained to 1. If the component should be reset each time the user visits it use the _isResetOnRevisit property.
-
With the Adapt CLI installed, run the following from the command line:
adapt install adapt-contrib-confidenceSliderAlternatively, this component can also be installed by adding the following line of code to the adapt.json file:
"adapt-contrib-confidenceSlider": "*"Then running the command:adapt install(This second method will reinstall all plug-ins listed in adapt.json.) -
If Confidence Slider has been uninstalled from the Adapt authoring tool, it may be reinstalled using the Plug-in Manager.
NOTE: This component has a dependency on adapt-contrib-slider; you must have it installed as well in order for this component to be able to function.
The attributes listed below are used in components.json to configure Confidence Slider, and are properly formatted as JSON in example.json.
In addition to the attributes specifically listed below, question components can implement the following sets of attributes:
- core model attributes: These are inherited by every Adapt component. They have no default values. Like the attributes below, their values are assigned in components.json.
- core buttons: Default values are found in course.json, but may be overridden by Confidence Slider's model in components.json.
_component (string): This value must be: confidenceSlider.
_classes (string): CSS class name to be applied to Confidence Slider’s containing div. The class 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. Acceptable values are 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.
ariaQuestion (string): This will be read out by screen readers instead of reading the title, body & instruction fields when focusing on the group or radiogroup.
disabledBody (string): This optional text appears in place of the body text when the confidence slider to which this one is linked has not been answered.
_attempts (integer): This specifies the number of times a learner is allowed to submit an answer. The default is 1 and must be left at this value.
_shouldDisplayAttempts (boolean): Determines whether or not the text set in remainingAttemptText and remainingAttemptsText will be displayed. These two attributes are part of the core buttons attribute group. The default is false.
_canShowFeedback (boolean): Setting this to false disables feedback, so it is not shown to the user. The default is true.
_canShowMarking (boolean): Setting this to false prevents ticks and crosses being displayed on question completion. If you enable _canShowMarking it will work but will always mark as correct answer. The default is false.
_questionWeight (number): A number which reflects the significance of the question in relation to the other questions in the course. This number is used in calculations of the final score reported to the LMS.
_recordInteraction (boolean) Determines whether or not the learner's answers will be recorded to the LMS via cmi.interactions. Default is true. For further information, see the entry for _shouldRecordInteractions in the README for adapt-contrib-spoor.
_linkedToId (string): The component ID of a slider to which this slider can be linked. This is optional and if set, will disable user interaction until a selection is submitted on the linked slider.
ariaScaleName (string): This will be read out by screen readers when focusing on the scale input (slider handle). An appropriate name should give context to which the scale is a measurement of. The default is confidence.
labelStart (string): Text/characters that appear at the start of the slider scale.
labelEnd (string): Text/characters that appear at the end of the slider scale.
_scaleStart (number): This value is the numeric start of the scale. It is used to calculate the slider's position on the scale. The default is 1.
_scaleEnd (number): This value is the numeric end of the scale. It is used to calculate the slider's position on the scale. The default is 10.
_scaleStep (number): Defines the amount the scale should be incremented by. The default is 1.
_showNumber (boolean): When set to true, a numeric value appears on the marker described in _showScaleIndicator. The value indicates the slider's position on the scale. The default is true. Note that _showScaleIndicator must be set to true in order for this to work.
_showScaleIndicator (boolean): When set to true, a marker for the position of the slider along the scale is shown. If _showNumber is true this marker will contain a numeric value. If _showNumber is false a blank marker is shown.
_showScale (boolean): When set to false, visual indications of the scale—range of numbers and short rules—are not displayed. The default is true.
_showScaleNumbers (boolean): When set to false, numbers are not shown over the scale items. Useful if you have a scale with very many steps where displaying that many numbers would make it look crowded or even unreadable. The default is true.
_shouldStoreResponses (boolean): Optional. You can use this to track the user's responses to a particular Confidence Slider component. This functionality requires the Spoor extension to be installed and _spoor._tracking._shouldStoreResponses (see config.json) set to true.
_feedback (object): If the Tutor extension is enabled, these various texts will be displayed depending on the submitted answer. _feedback contains values for three seperate elements: generic, comparison and threshold feedback. Generic feedback is always presented to the user. Comparison feedback is presented on submission if the slider has been linked to another slider. Threshold feedback is determined according to the range in which the user's selection falls. All feedback elements are optional. Each element can be separated by one or more characters (such as a space) or, more commonly, by some HTML markup.
title (string): The text used as the feedback title. Leave empty if no display title is required.
altTitle (string): The text used to provide an alternative heading for Assistive Technology if no display title is required. Only used if
titleis empty.
feedbackSeparator (string): Optional text/markup that will separate each feedback element.
generic (string): Text that will be shown whichever selection is made.
_comparison (object): Text that will be shown on submission if the slider has been linked to another slider.
lower (string): This text will be shown if the user has selected a lower value than was chosen on the linked slider.
higher (string): This text will be shown if the user has selected a higher value than was chosen on the linked slider.
same (string): This text will be shown if both values are the same.
_threshold (object array): Multiple items may be created. Each item represents the feedback for a range of slider values.
_values (object): Specifies the range of slider values for which the associated text will be included in the feedback.
_low (number): The lower bound of the range (inclusive).
_high (number): The upper bound of the range (inclusive).
text (string): The text that will be included in the feedback if the user's selection falls with the range specified by _values.
Confidence Slider has been assigned a label using the aria-label attribute: ariaRegion. This label is not a visible element. It is utilized by assistive technology such as screen readers. Should the region's text need to be customised, it can be found within the globals object in properties.schema.
Does not currently support a descending step value.
Author / maintainer: Adapt Core Team with contributors
Accessibility support: WAI AA
RTL support: Yes
Cross-platform coverage: Chrome, Chrome for Android, Firefox (ESR + latest version), Edge, IE11, Safari 12+13 for macOS/iOS/iPadOS, Opera