Reference

<point>

<point> renders a point on a <graph>.

Attributes and Properties

Attributes for <point>
AttributeTypeValues
applyStyleToLabel = "…"boolean"true" "false"
coords = "…"coords
displayDecimals = "…"integer
displayDigits = "…"integer
displaySmallAsZero = "…"number
draggable = "…"boolean"true" "false"
hideOffGraphIndicator = "…"boolean"true" "false"
labelIsName = "…"boolean"true" "false"
labelPosition = "…"text"upperright" "upperleft" "lowerright" "lowerleft" "top" "bottom" "left" "right"
layer = "…"integer
padZeros = "…"boolean"true" "false"
showCoordsWhenDragging = "…"boolean"true" "false"
x = "…"math
xs = "…"[ math ]
y = "…"math
z = "…"math
Props for <point name="p">
PropertyType
$p.applyStyleToLabelboolean
$p.backgroundColortext
$p.constraintUsedboolean
$p.coordscoords
$p.displayDecimalsinteger
$p.displayDigitsinteger
$p.displaySmallAsZeronumber
$p.draggableboolean
$p.hideOffGraphIndicatorboolean
$p.labellabel
$p.labelIsNameboolean
$p.labelPositiontext
$p.latexlatex
$p.layerinteger
$p.numDimensionsnumber
$p.numDimensionsForConstraintsnumber
$p.padZerosboolean
$p.showCoordsWhenDraggingboolean
$p.styleDescriptiontext
$p.styleDescriptionWithNountext
$p.textColortext
$p.textStyleDescriptiontext
$p.valuecoords
$p.xmath
$p.xs[ math ]
$p.ymath
$p.zmath

Example: Default <point>

Here a default <point> is illustrated without any additional attributes.


Example: <point> with sugared coordinates

The initial coordinates of a <point> may be specified between opening and closing tags.


Example: <point> location specified with attributes

Three different ways to specify the coordinates of a <point> using its attributes are illustrated.


Example: A labeled <point>

Point labels can be created either with the shortcut attribute labelIsName or by giving the <point> a <label> child.


Example: Points of different styles

Points with standard styleNumbers one through six are illustrated. If unspecified, styleNumber = 1 is the default value.


Example: <point> constrained to a grid

Points can take <constraints> as children. Several different types of constraints are possible; in this example, the <constrainToGrid/> and <attractToGrid/> constraints are illustrated.


Example: <point> constrained to a <line>

Points can take <constraints> as children. Several different types of constraints are possible. In this case, the <constrainTo> constraint references a named <line>.


Example: An animated <point>

A <point> is animated by paraterizing its coordinates with respect to the <number> t. The parameter is animated using the <animateFromSequence/> component.


Example: Points that break the universe

Although point C depends on point B which depends on point A which, in turn, depends on point C, Doenet can determine that there is actually no circular dependency in their relationship.

This example also illustrates how one can change a point either by dragging it or by changing a <mathInput/> that is bound to one of its coordinates.


Example: draggable

The draggable attribute determines whether the <point> can be dragged around the <graph>. All graphical objects are draggable by default.


Example: x, y

The x and y attributes are used to specify isolated <point> coordinates.


Example: coords

The coords attribute specifies the <point> coordinates.


Example: xs

The xs attribute specifies the point’s location as a list of displacements.


Example: labelPosition

The labelPosition attribute specifies the location of the point’s label. Valid values are upperleft, upperright, top, left, right, lowerleft, bottom, lowerright. The default value is upperright.


Example: showCoordsWhenDragging

By default, a light-grey set of coordinates is shown while the user drags the point. To turn off this default behavior, set the showCoordsWhenDragging attribute to false.


Example: hideOffGraphIndicator

By default, when a <point> is dragged outside the extents of the <graph>, or when a point is located outside the extents, an triangle-shaped indicator appears at the edge of the <graph>. The user can either click this indicator to bring the <point> back to the position of the cursor, or zoom out until the <point> is visible again.

In this example, only one indicator appears initially, since point A has the hideOffGraphIndicator attribute specified. The student would not be aware that point A exists, until zooming out sufficiently far on the graph.


Example: Standard graphical attributes

The uses of the following standard graphical attributes are illustrated: hide, layer, styleNumber, applyStyleToLabel and labelIsName.


Example: Attributes as properties

The above listed <point> attributes are also accessible as properties.


Example: numDimensions *

The numDimensions property renders the number of dimensions required to define the point.


Example: latex

The latex property renders the latex code associated with rendering the coordinates of the <point>.


Example: constraintUsed

The constraintUsed property renders the boolean value corresponding to whether the current location of the <point> is utilizing the specified constraint - in this case, an <attractToGrid/> constraint.