<orbitalDiagramInput/>

<orbitalDiagramInput/> is a Subject-Specific component that renders an interactive tool for student entry of orbital diagrams.

Attributes and Properties

Examples

Example: Default <orbitalDiagramInput/>

<atom atomicNumber="6" name="carbon"/>
 
<label for="$userDiagram">Draw the orbital diagram for <alert>carbon</alert>. At the left side of each row, include the label for the sublevel shown (1s, 2s, 2p, etc.)</label>
<orbitalDiagramInput name="userDiagram"/>
 
<answer>
  <award>
    <when>$userDiagram = $carbon.orbitalDiagram
    </when>
  </award>
</answer>
 
<solution>
$carbon.orbitalDiagram
</solution>

The default <orbitalDiagramInput/> contains one row with an empty label. Students complete the diagram by typing in the correct sublevel into the label, and using the buttons to add “box” entry fields and arrows to complete the diagram. Additional rows are also added/removed with the buttons shown above the diagram. Check the solution provided and experiment with the buttons to get a feel for how the tool behaves.

Attribute Examples

Attribute Example: prefill

<atom atomicNumber="5" name="boron"/>
<atom atomicNumber="9" name="fluorine"/>
 
<label for="$userDiagram">Add electrons to the orbital diagram for boron shown below in order to make the orbital diagram for fluorine.</label>
<orbitalDiagramInput name="userDiagram" prefill="(ud) (ud) (u, , )" prefillLabel="1s 2s 2p"/>
 
<answer>
  <award>
    <when>$userDiagram = $fluorine.orbitalDiagram
    </when>
  </award>
</answer>
 
<solution>
<p>The orbital diagram for <alert>fluorine</alert></p>
$fluorine.orbitalDiagram
</solution>

The prefill attribute of the <orbitalDiagramInput/> component takes as its input either (1) an array of arrow directions listed by row or (2) the orbitalDiagram property of a named <atom> component. The first input method is illustrated above.

To enter the array of arrow directions, use “u” for an up arrow and “d” for a down arrow. Each row is listed in distinct parentheses. To prefill empty boxes, you can include comma-separated spaces within a row.

Attribute Example: prefill (2nd method)

<atom atomicNumber="5" name="boron"/>
<atom atomicNumber="9" name="fluorine"/>
 
<label for="$userDiagram">Add electrons to the orbital diagram for boron shown below in order to make the orbital diagram for fluorine.</label>
<orbitalDiagramInput name="userDiagram" prefill="$boron.orbitalDiagram"/>
<answer>
  <award>
    <when>$userDiagram = $fluorine.orbitalDiagram
    </when>
  </award>
</answer>
<solution>
<p>The orbital diagram for <alert>fluorine</alert></p>
$fluorine.orbitalDiagram
</solution>

The prefill attribute of the <orbitalDiagramInput/> component takes as its input either (1) an array of arrow directions listed by row or (2) the orbitalDiagram property of a named <atom> component. The second input method is illustrated above.

Attribute Example: prefillLabel

<atom atomicNumber="9" name="fluorine"/>
 
<label for="$userDiagram">Add electrons to the blank orbital diagram shown below in order to make the orbital diagram for fluorine.</label>
<orbitalDiagramInput name="userDiagram" prefill="() () ( , , )" prefillLabel="1s 2s 2p"/>
<answer>
  <award>
    <when>$userDiagram = $fluorine.orbitalDiagram
    </when>
  </award>
</answer>
<solution>
<p>The orbital diagram for <alert>fluorine</alert></p>
$fluorine.orbitalDiagram
</solution>

The prefillLabel attribute can be used to specify a prefill of the labels for each row of the <orbitalDiagramInput/>. The input for this attribute is a list of text labels, beginning with the label for the bottom row.

Property Examples

Property Example: value

The value property of the <orbitalDiagramInput/> returns a static copy of the user’s entered diagram values that is updated with each click interaction.

Property Example: rows

The rows property of the <orbitalDiagramInput/> returns the row values entered in the user’s diagram, rearranged such that the most recently entered rows appear on the bottom of the diagram and the first row entered appears on the top of the diagram.

Property Example: numRows

The numRows property of the <orbitalDiagramInput/> returns the number of rows entered into the diagram by the user.

Property Example: selectedBoxIndex

The selectedBoxIndex property of the <orbitalDiagramInput/> returns the index number of the diagram box of the active row (numbered from left to right) that is currently highlighted by the user.