Checkbox

Checkbox

Creates a clickable checkbox with a label that toggles on and off when clicked.

Constructor

# new Checkbox(parent, x, y, label, checked, defaultHandler)

Constructor
Parameters:
Name Type Description
parent HTMLElement The element to add this checkbox to.
x number The x position of the checkbox.
y number The y position of the checkbox.
label string The label label of the checkbox.
checked boolean The initial checked state of the checkbox.
defaultHandler function A function that will handle the "click" event.
Source:
Example
const panel = new Panel(document.body, 20, 20, 200, 200);
new Checkbox(panel, 20, 20, "Check it", false, event => console.log(event.target.checked));

Extends

Classes

Checkbox

Members

# checked

Sets and gets the checked state of the checkbox.

# enabled

Sets and gets whether or not this component is enabled. Non-enabled components will be faded out and not respond to events.
Overrides:

# height

Sets and gets the height of this component.
Overrides:

# label

Sets and gets the label shown in the button's label.

# width

Sets and gets the width of this component.
Overrides:

# x

Sets and gets the x position of this component.
Overrides:

# y

Sets and gets the y position of this component.
Overrides:

Methods

# addHandler(handler)

Adds a handler function for the "click" event on this checkbox.
Parameters:
Name Type Description
handler function A function that will handle the "click" event.
Returns:
This instance, suitable for chaining.

# bind(target, prop)

Automatically changes the value of a property on a target object with the main value of this component changes.
Parameters:
Name Type Description
target object The target object to change.
prop string The string name of a property on the target object.
Returns:
This instance, suitable for chaining.

# getChecked()

Gets whether or not this checkbox is checked.
Returns:
Whether or not this checkbox is checked.

# getEnabled()

Gets whether the component is enabled.
Returns:
Whether or not the component is enabled.

# getHeight()

Gets the height of the component.
Overrides:
Returns:
The height of the component.

# getLabel()

Gets the label on this checkbox.
Returns:
The text of the label of this checkbox.

# getWidth()

Gets the width of the component.
Overrides:
Returns:
The width of the component.

# getX()

Gets the x position of the component.
Overrides:
Returns:
The x position of the component.

# getY()

Gets the y position of the component.
Overrides:
Returns:
The y position of the component.

# move(x, y)

Moves the component to a specified position.
Parameters:
Name Type Description
x number The new x position of the component.
y number The new y position of the component.
Overrides:
Returns:
This instance, suitable for chaining.

# rotate(rad)

Rotates the component.
Parameters:
Name Type Description
rad number The number of radians to rotate the component by.
Overrides:
Returns:
This instance, suitable for chaining.

# rotateDeg(deg)

Rotates the component.
Parameters:
Name Type Description
deg number The number of degrees to rotate the component by.
Overrides:
Returns:
This instance, suitable for chaining.

# setChecked()

Sets the checked state of this checkbox.
Returns:
This instance, suitable for chaining.

# setEnabled(enabled)

Sets the enabled state of this component.
Parameters:
Name Type Description
enabled boolean Whether or not the component will be enabled.
Returns:
This instance, suitable for chaining.

# setHeight(height)

Sets the height of this component.
Parameters:
Name Type Description
height number The height of this component.
Overrides:
Returns:
This instance, suitable for chaining.

# setLabel(label)

Sets the label of this checkbox.
Parameters:
Name Type Description
label string The label to set on this checkbox.
Returns:
this instance, suitable for chaining.

# setSize(w, h)

Sizes the component.
Parameters:
Name Type Description
w number The new width of the component.
h number The new height of the component.
Overrides:
Returns:
This instance, suitable for chaining.

# setWidth()

Sets the width of this checkbox. In fact, setting the width does nothing because it is automatically determined by the width of the label.
Overrides:

# setX(x)

Sets the x position of this component.
Parameters:
Name Type Description
x number The x position of this component.
Overrides:
Returns:
This instance, suitable for chaining.

# setY(y)

Sets the y position of this component.
Parameters:
Name Type Description
y number The y position of this component.
Overrides:
Returns:
this instance, suitable for chaining.

# toggle()

Toggles the state of the checkbox between checked and not checked.
Returns:
This instance, suitable for chaining.