ReferencecascadeMessage

<cascadeMessage>

Placeholder shown inside a `<cascade>` in place of a not-yet-revealed entry

<cascadeMessage> is a continuation placeholder shown inside a <cascade> when the next entry is still hidden. It takes the place of the not-yet-revealed entry until that entry becomes visible, at which point the message disappears.

Use <cascadeMessage> to give the learner a prompt — “Keep going”, “Solve the previous step to continue”, etc. — without revealing the content behind it.

Attributes and Properties

Attributes for <cascadeMessage>

Scoring (9)
aggregateScores

boolean. Default value: false. Whether to aggregate scores of scored descendants into a section credit-achieved value.

colorCorrectness

boolean. Default value: false. Whether to color-code answers in this section based on correctness.

displayDigitsForCreditAchieved

integer. Default value: 3. Number of significant digits to display for the section's credit achieved value.

forceIndividualAnswerColoring

boolean. Default value: false. Whether to force per-answer color-correctness even when section-wide check work is enabled.

sectionWideCheckWork

boolean. Default value: false. Whether to show a single section-wide check-work button instead of per-answer buttons.

showCorrectness

boolean. Default value: false. Whether to display correctness indicators for answers in this section.

submitLabel

text. Default value: Check Work. Label for the section-wide submit button when correctness is shown.

submitLabelNoCorrectness

text. Default value: Submit Response. Label for the section-wide submit button when correctness is not shown.

weight

number. Default value: 1. Relative weight of this section when aggregated by an enclosing scored section.

Common to all components (9)
copy

reference. Create an independent copy of another component by reference. Enter a references a $name.

disabled

boolean. Default value: false. Whether this component is disabled and cannot be interacted with.

extend

reference. Extend another component by reference, inheriting its children and attributes. Enter a reference as $name.

fixed

boolean. Default value: false. Whether this component's value is fixed and cannot be modified.

fixLocation

boolean. Default value: false. Whether this component's location is fixed (preventing it from being moved while still allowing other modifications).

hide

boolean. Default value: false. Whether to hide this component from the rendered output.

isResponse

boolean. Default value: false. Whether this component is treated as a response for the purposes of assessment.

name

text. The name used to reference this component from elsewhere in the document.

styleNumber

integer. Default value: 1. The style number used to select this component's visual styling from the available style definitions.

Properties for <cascadeMessage name="c">

Scoring (6)
$c.aggregateScores

boolean. Whether scores of scored descendants are aggregated into this section's credit value.

$c.displayDigitsForCreditAchieved

integer. Number of significant digits to display for the section's credit achieved value.

$c.sectionWideCheckWork

boolean. Whether to show a single section-wide check-work button instead of per-answer buttons.

$c.submitLabel

text. Label for the section-wide submit button when correctness is shown.

$c.submitLabelNoCorrectness

text. Label for the section-wide submit button when correctness is not shown.

$c.weight

number. Relative weight of this section when aggregated by an enclosing scored section.

Other (7)
$c.creditAchieved

number. Aggregate credit achieved (between 0 and 1) for scored descendants of this section.

$c.disabled

boolean. Whether this component is disabled and cannot be interacted with.

$c.fixed

boolean. Whether this component's value is fixed and cannot be modified.

$c.fixLocation

boolean. Whether this component's location is fixed (preventing it from being moved while still allowing other modifications).

$c.hidden

boolean. Whether this component is hidden from the rendered output.

$c.percentCreditAchieved

number. Aggregate credit achieved as a percentage (between 0 and 100).

$c.text

text. The paragraph's text content.

Common to all components (4)
$c.doenetML

text. The DoenetML source code that produced this component.

$c.hide

boolean. Whether to hide this component from the rendered output.

$c.isResponse

boolean. Whether this component is treated as a response for the purposes of assessment.

$c.styleNumber

integer. The style number used to select this component's visual styling from the available style definitions.

Examples

Example: Between siblings of a <cascade>

While the first step is unanswered, the <cascadeMessage> appears in place of the still-hidden second step. Once the first step is answered correctly, the message disappears and Step 2 is revealed.

Example: Inside sections of a <cascade>

A <cascadeMessage> placed inside a still-hidden section serves as the prompt shown in place of that section’s body. The cascade chooses the first <cascadeMessage> that follows the last completed child, so authoring one per section lets each section carry its own prompt.

Example: Single continuation tail

A single <cascadeMessage> placed at the end of the cascade serves as a generic “more to come” prompt that appears between any pair of still-hidden siblings, and disappears once every preceding child has been completed.

cascadecase