<point>
<point>
renders a point on a <graph>
.
Attributes and Properties
Attribute | Type | Values |
---|---|---|
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 |
Property | Type |
---|---|
$p.applyStyleToLabel | boolean |
$p.backgroundColor | text |
$p.constraintUsed | boolean |
$p.coords | coords |
$p.displayDecimals | integer |
$p.displayDigits | integer |
$p.displaySmallAsZero | number |
$p.draggable | boolean |
$p.hideOffGraphIndicator | boolean |
$p.label | label |
$p.labelIsName | boolean |
$p.labelPosition | text |
$p.latex | latex |
$p.layer | integer |
$p.numDimensions | number |
$p.numDimensionsForConstraints | number |
$p.padZeros | boolean |
$p.showCoordsWhenDragging | boolean |
$p.styleDescription | text |
$p.styleDescriptionWithNoun | text |
$p.textColor | text |
$p.textStyleDescription | text |
$p.value | coords |
$p.x | math |
$p.xs | [ math ] |
$p.y | math |
$p.z | math |
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.