Referencespan

<span>

A generic inline container

<span> groups inline content into a named or otherwise-attributed region without introducing a line break or paragraph spacing. It is the inline counterpart to <div>.

Attributes and Properties

Attributes for <span>

Scoring (10)
aggregateScores

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

colorAnswersSeparately

boolean. Default value: false. When section-wide check work is enabled, color each answer based on its own correctness rather than the section's overall credit.

colorCorrectness

boolean. Default value: true. Whether to color-code the answers it contains based on correctness.

displayDigitsForCreditAchieved

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

maxNumAttempts

integer. Default value: Infinity. Maximum number of times the section-wide check-work button can be submitted. Once reached, all enclosed answers are disabled.

sectionWideCheckWork

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

showCorrectness

boolean. Default value: true. Whether to display correctness indicators for the answers it contains.

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).

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 <span name="s">

Scoring (7)
$s.aggregateScores

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

$s.displayDigitsForCreditAchieved

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

$s.maxNumAttempts

integer. Maximum number of times the section-wide check-work button can be submitted. Once reached, all enclosed answers are disabled.

$s.sectionWideCheckWork

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

$s.submitLabel

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

$s.submitLabelNoCorrectness

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

$s.weight

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

Other (8)
$s.creditAchieved

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

$s.disabled

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

$s.fixed

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

$s.fixLocation

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

$s.hidden

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

$s.numAttemptsLeft

integer. Remaining number of section-wide submissions before the maximum is reached.

$s.numSubmissions

integer. Number of times the section-wide check-work button has been submitted.

$s.percentCreditAchieved

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

Common to all components (4)
$s.doenetML

text. The DoenetML source code that produced this component.

$s.hide

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

$s.isResponse

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

$s.styleNumber

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

Examples

Example: <span> as a named inline container

A <span> can wrap a portion of inline content so that it can be referenced by name elsewhere in the document.

Example: copying inline content with <span>

Because <span> is inline, its content flows with surrounding text and can be conditionally hidden, copied, or referenced like any other named component.

Attribute Examples

Attribute Example: hide

The hide attribute takes a boolean as input and can be used with any rendered component.

sortsplit