Constructor
new Slider(options)
- Source:
- Mixes In:
- To Do:
-
- check that parameters are valid, e.g. ticks are an array of numbers, etc.
- readOnly
- complete setters, for instance setTicks should change this._isCategorical
- flesh out the skin approach
Parameters:
Name | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
Properties
|
Extends
Members
(static, readonly) Shape :Symbol
- Source:
Properties:
Name | Type | Description |
---|---|---|
DISC |
Symbol | |
TRIANGLE |
Symbol | |
LINE |
Symbol | |
BOX |
Symbol |
Shape of the marker and of the ticks.
Type:
- Symbol
(static, readonly) Skin :any
- Source:
Properties:
Name | Type | Description |
---|---|---|
MARKER_SIZE |
any | |
STANDARD |
any | |
WHITE_ON_BLACK |
any |
Skin.
Type:
- any
(static, readonly) Style :Symbol
- Source:
Properties:
Name | Type | Description |
---|---|---|
RATING |
Symbol | |
TRIANGLE_MARKER |
Symbol | |
SLIDER |
Symbol | |
WHITE_ON_BLACK |
Symbol | |
LABELS_45 |
Symbol | |
RADIO |
Symbol |
Styles.
Type:
- Symbol
borderColor
- Source:
Let borderColor
alias lineColor
to parallel PsychoPy
fillColor
- Source:
Let fillColor
alias markerColor
to parallel PsychoPy
Methods
(protected) _addEventListeners()
- Source:
Add event listeners.
(protected) _estimateBoundingBox()
- Source:
- Overrides:
Estimate the bounding box.
(protected) _getBoundingBox_px() → {PIXI.Rectangle}
- Source:
- Overrides:
Get the bounding box in pixel coordinates
Returns:
the bounding box, in pixel coordinates
- Type
- PIXI.Rectangle
(protected) _getPosition_px() → {Array.<number>}
- Source:
Estimate the position of the slider, taking the compactness into account.
Returns:
- the position of the slider, in pixels
- Type
- Array.<number>
(protected) _getTextStyle()
- Source:
Get the PIXI Text Style applied to the PIXI.Text labels.
(protected) _granularise(rating) → {number}
- Source:
Calculate the rating once granularity has been taken into account.
Parameters:
Name | Type | Description |
---|---|---|
rating |
number | the input rating |
Returns:
the new rating with granularity applied
- Type
- number
(protected) _handlePointerDown()
- Source:
Handle pointerdown event.
(protected) _handlePointerMove()
- Source:
Handle pointermove event.
(protected) _handlePointerUp()
- Source:
Handle pointerup event.
(protected) _isHorizontal() → {boolean}
- Source:
Determine whether the slider is horizontal.
The slider is horizontal is its x-axis size is larger than its y-axis size.
Returns:
whether or not the slider is horizontal
- Type
- boolean
(protected) _onChange(withPixiopt, withBoundingBoxopt) → {function}
- Source:
- Overrides:
Generate a callback that prepares updates to the stimulus. This is typically called in the constructor of a stimulus, when attributes are added with _addAttribute.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
withPixi |
boolean |
<optional> |
false
|
whether or not the PIXI representation must also be updated |
withBoundingBox |
boolean |
<optional> |
false
|
whether or not to immediately estimate the bounding box |
Returns:
- Type
- function
(protected) _posToRating(pos_px) → {number}
- Source:
Convert a [x,y] position, in pixel units, relative to the slider, into a rating.
Parameters:
Name | Type | Description |
---|---|---|
pos_px |
Array.<number> | the [x,y] position, in pixel units, relative to the slider. |
Returns:
the corresponding rating.
- Type
- number
(protected) _ratingToPos(ratings) → {Array.<Array.<number>>}
- Source:
Convert an array of ratings into an array of [x,y] positions (in Slider units, with 0 at the center of the Slider)
Parameters:
Name | Type | Description |
---|---|---|
ratings |
Array.<number> | the array of ratings |
Returns:
the positions corresponding to the ratings (in Slider units, with 0 at the center of the Slider)
- Type
- Array.<Array.<number>>
(protected) _removeEventListeners()
- Source:
Remove event listeners.
(protected) _sanitizeAttributes()
- Source:
Sanitize the slider attributes: check for attribute conflicts, missing values, etc.
(protected) _setupBar()
- Source:
Setup the central bar.
(protected) _setupLabels()
- Source:
Setup the labels.
(protected) _setupMarker()
- Source:
Setup the marker, and the associated mouse events.
(protected) _setupSlider()
- Source:
Setup the PIXI components of the slider (bar, ticks, labels, marker, etc.).
(protected) _setupStyle()
- Source:
Apply a particular style to the slider.
(protected) _setupTicks()
- Source:
Setup the ticks.
(protected) _updateIfNeeded()
- Source:
- Overrides:
Update the stimulus, if necessary.
contains(object, units) → {boolean}
- Source:
- Overrides:
Determine whether an object is inside the bounding box of the stimulus.
Parameters:
Name | Type | Description |
---|---|---|
object |
Object | the object |
units |
string | the units |
Returns:
whether or not the object is inside the bounding box of the stimulus
- Type
- boolean
draw()
- Source:
- Overrides:
Draw this stimulus on the next frame draw.
getRating() → {number|undefined}
- Source:
Get the current value of the rating.
Returns:
the rating or undefined if there is none
- Type
- number | undefined
getRT() → {number|undefined}
- Source:
Get the response time of the most recent change to the rating.
Returns:
the response time (in second) or undefined if there is none
- Type
- number | undefined
hide()
- Source:
- Overrides:
Hide this stimulus on the next frame draw.
isMarkerDragging() → {boolean}
- Source:
Query whether or not the marker is currently being dragged.
Returns:
whether or not the marker is being dragged
- Type
- boolean
recordRating(rating, responseTimeopt, logopt)
- Source:
Set the current rating.
Setting the rating does also change the visible position of the marker.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
rating |
number | the rating |
||
responseTime |
number |
<optional> |
the reaction time |
|
log |
boolean |
<optional> |
false
|
whether of not to log |
refresh()
- Source:
- Overrides:
Force a refresh of the stimulus.
release(logopt)
- Source:
- Overrides:
Release the PIXI representation, if there is one.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
log |
boolean |
<optional> |
false
|
whether or not to log |
reset()
- Source:
Reset the slider.
setAutoDraw(autoDraw, logopt)
- Source:
- Overrides:
Setter for the autoDraw attribute.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
autoDraw |
boolean | the new value |
||
log |
boolean |
<optional> |
false
|
whether to log |
setDepth(depth, logopt)
- Source:
- Overrides:
Setter for the depth attribute.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
depth |
Array.<number> |
0
|
order in which stimuli is rendered, kind of css's z-index with a negative sign. |
|
log |
boolean |
<optional> |
false
|
whether of not to log |
setMarkerPos(displayedRating, logopt)
- Source:
Setter for the markerPos attribute.
Setting markerPos changes the visible position of the marker to the specified rating but does not change the actual rating returned by the slider.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
displayedRating |
number | the displayed rating |
||
log |
boolean |
<optional> |
false
|
whether of not to log |
setOri(ori, logopt)
- Source:
- Overrides:
Setter for the orientation attribute.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
ori |
number |
0
|
the orientation in degree with 0 as the vertical position, positive values rotate clockwise. |
|
log |
boolean |
<optional> |
false
|
whether of not to log |
setPos(pos, logopt)
- Source:
- Overrides:
Setter for the position attribute.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
pos |
Array.<number> | position of the center of the stimulus, in stimulus units |
||
log |
boolean |
<optional> |
false
|
whether of not to log |
setRating(rating, logopt)
- Source:
Setter for the rating attribute.
Setting the rating does not change the visible position of the marker.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
rating |
number | the rating |
||
log |
boolean |
<optional> |
false
|
whether of not to log |
setReadOnly(readOnlyopt, logopt)
- Source:
Setter for the readOnly attribute.
Read-only sliders are half-opaque and do not provide responses.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
readOnly |
boolean |
<optional> |
true
|
whether or not the slider is read-only |
log |
boolean |
<optional> |
false
|
whether of not to log |
setSize(size, logopt)
- Source:
- Overrides:
Setter for the size attribute.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
size |
undefined | null | number | Array.<number> | the stimulus size |
||
log |
boolean |
<optional> |
false
|
whether of not to log |