Reusable Accessible Mapping PlatformColorPickerBrick Class
The ColorPickerBrick prototype. Provides a control to select a color. To instantiate, call new on the ColorPickerBrick prototype.
Imports RAMP Modules:
Uses RAMP Templates:
templates/bricks_template.json
Item Index
Methods
Properties
Events
Methods
clear
()
SimpleInputBrick
chainable
Clears the Brick by setting inputValue to "" and userEntered to false.
Returns:
itself
disable
-
disable -
force
Disables or re-enables the Brick.
Parameters:
Returns:
itself
displayNotice
-
notice -
[noticeTemplate]
Display a (error) notice on the brick.
Parameters:
Returns:
itself
getData
-
[wrap]
Returns ColorPickerBrick's data. Returns different colour representations:
- {String} hex hexcode
- {Array} rgb array of rgb colours (from 0 to 1)
- {Array} rgb_ array of rgb colours (from 0 to 255)
- {Array} hsv array of hsv colours (from 0 to 1)
Parameters:
-
[wrap]Boolean optionalindicates of the payload should be wrapped with a Brick's id; useful when collection information from several Bricks at once.
Returns:
A wrapper object around two properties: inputValue and userEntered
isUserEntered
()
Boolean
Checks if the input value was entered by the user or not.
Returns:
true if the input value was entered by the user; false, otherwise
isValid
()
Boolean
Checks if the SimpleInputBrick is valid. It's considered valid if the input value is not an empty String.
Returns:
true if valid; false if not
new
-
id -
config
Initializes the ColorPickerBrick by generating a specified template and setting defaults. A random colour is picked as when this Brick is instantiated. This Brick fires a CHANGE event on every time the selected colour changes.
Parameters:
-
idStringspecified id of the Brick
-
configObjecta configuration object for the Brick
-
[header]String optionala Brick header
-
[instructions]String optionala configuration object for the Brick
-
[required]Array | Object optionalcollection of rules specifying what external conditions must be valid for the Brick to be enabled
-
[freezeStates]Array optionala set of rules specifying states Brick should be frozen
-
[baseTemplate]String optionala base template name to be used
-
[noticeTemplate]String optionala notice template name to be used
-
[containerClass]String optionala CSS class of the specific brick container
-
[template]String optionala name of the specific Brick template
-
[label]String optionalan input field label. Invisible. Defaults to the Brick's header
-
[placeholder]String optionala placeholder to be displayed inside the input field
-
[pickerPosition]String optionalspecifies positions of the actual color picker (square wheel) control
-
notify
-
eventName -
data
Notifies a listener of a Brick event.
Parameters:
Returns:
itself
on
-
eventName -
listener
Sets a listener on the Brick for a specified eventName.
Parameters:
Returns:
itself
setData
-
data
Sets SimpleInputBrick's data. First calls setInputValue and calls set data on the Brick prototype.
Parameters:
-
dataObjecta wrapper object for the data to be set.
Returns:
itself
setInputValue
-
value -
userEntered
Sets the current value of the input field.
Parameters:
Returns:
itself
setState
-
state
Sets the state of the Brick. Depending on the state, update the visual styles of the input field. Then call the Brick prototype setState function.
Parameters:
-
stateStringa name of the state to set
Returns:
itself
Properties
_isFrozen
Boolean
private
Indicates if the Brick is frozen and cannot be interacted with.
Default: false
_listeners
Object
private
A collection of listeners to be notified of specified Brick events.
Default: {}
containerClass
String
private
A CSS class of the ColorPickerBrick container node.
Default: "colorpicker-brick-container"
freezeStates
Array
private
A set of rules specifying states Brick should be frozen.
Default: []
Example:
[
Bricks.Brick.state.SUCCESS,
Bricks.Brick.state.ERROR
],
pickerPosition
String
private
Specifies positions of the actual color picker (square wheel) control
Default: "top"
required
Array
A collection of rules specifying what external conditions must be valid for the Brick to be enabled. This is not used directly by the Brick itself, but instead by the external object manipulating a collection of Bricks. Two types of rules possible: "all" and "any". Any additional properties needed can be specified.
Default: null
Example:
[
{
type: "all",
check: ["serviceType", "serviceURL"]
}
]
state
Object
A dictionary of Brick events.
Example:
state: {
SUCCESS: "brick/success",
ERROR: "brick/error",
DEFAULT: "brick/default"
}
template
String
private
A name of the default ColorPickerBrick template.
Default: "default_colorpicker_brick_template"
userEntered
Boolean
private
Indicates if the user entered text into the input field or it was entered programmatically
Default: false
Events
Bricks.Brick.event.CHANGE
Published whenever a Brick undergoes some change.
Event Payload:
-
dataObjectanything, usually result of calling getData() on the Brick