`<numberList>`

A list of numbers

<numberList> defines a collection, or list, of <number> components. Some components that accept a <numberList> as an input include <function>, <repeat>, and <award>.

When creating a <numberList>, separate items by spaces, not commas. The component will default to displaying the list with commas.

Attributes and Properties

Attributes for `<numberList>`

Other (8)

asList

boolean. Default value: true. Whether to render the items separated by commas (true) or with no separator (false).

avoidScientificNotation

Whether to render numbers in full decimal form rather than scientific notation.

displayDecimals

Number of decimal places to display when rendering this number.

displayDigits

Number of significant digits to display when rendering this number.

displaySmallAsZero

Threshold below which numbers are displayed as zero.

maxNumber

number. Default value: Infinity. Maximum number of items to retain in the list.

padZeros

Whether to pad displayed numbers with trailing zeros to fill the requested digits/decimals.

unordered

boolean. Default value: false. Whether the order of items in this list should be treated as unordered (e.g. for matching).

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

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

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 `<numberList name="n">`

Other (4)

$n.maxNumber

number. Maximum number of items to retain in the list.

$n.numComponents

number. The number of items in the number list.

$n.numValues

number. The number of numbers in the list.

$n.unordered

boolean. Whether the order of items in this list should be treated as unordered (e.g. for matching).

Common to all components (3)

$n.doenetML

text. The DoenetML source code that produced this component.

$n.hide

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

$n.styleNumber

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

Examples

Example: Defining a `<numberList>` and retrieving a value

The <numberList> component stores a list of “numbers”, or <number> components. Array notation can be used to access an individual element in the list.

Example: A `<numberList>` from multiple `<mathInput/>` components

Combining a number of user-inputs into a <numberList> can be achieved by referencing the named component between the opening and closing tags, separated by spaces.

Example: A `<numberList>` for function evaluation

Here, a <numberList> stores multiple input values to be used in the subsequent code for function evaluation.

Attribute Examples

Attribute Example: unordered

If a <numberList> is defined with the unordered attribute, comparisons (for validation in an <award> or a <boolean> for example) are unordered automatically.

Attribute Example: maxNumber

The maxNumber attribute imposes a limit on the number of numbers that can be stored in the list.

Property Examples

Property Example: numComponents

The numComponents property returns the number of elements stored in a <numberList>.

number objectives

<numberList>