Class: Keyboard

Members

callbackContext :Object

The context under which the callbacks are run.

Source - input/Keyboard.js, line 44

enabled :boolean

Keyboard input will only be processed if enabled.

Default Value:

• true

Source - input/Keyboard.js, line 29

event :Object

The most recent DOM event from keydown or keyup. This is updated every time a new key is pressed or released.

Source - input/Keyboard.js, line 34

game :Phaser.Game

Local reference to game.

Source - input/Keyboard.js, line 22

<readonly> lastChar :string

Returns the string value of the most recently pressed key.

Source - input/Keyboard.js, line 538

<readonly> lastKey :Phaser.Key

Returns the most recently pressed Key. This is a Phaser.Key object and it changes every time a key is pressed.

Source - input/Keyboard.js, line 561

onDownCallback :function

This callback is invoked every time a key is pressed down, including key repeats when a key is held down.

Source - input/Keyboard.js, line 49

onPressCallback :function

This callback is invoked every time a DOM onkeypress event is raised, which is only for printable keys.

Source - input/Keyboard.js, line 54

onUpCallback :function

This callback is invoked every time a key is released.

Source - input/Keyboard.js, line 59

pressEvent :Object

The most recent DOM event from keypress.

Source - input/Keyboard.js, line 39

Methods

addCallbacks(context, onDown, onUp, onPress)

Add callbacks to the Keyboard handler so that each time a key is pressed down or released the callbacks are activated.

Parameters:

Name	Type	Argument	Default	Description
context	Object			The context under which the callbacks are run.
onDown	function	<optional>	null	This callback is invoked every time a key is pressed down.
onUp	function	<optional>	null	This callback is invoked every time a key is released.
onPress	function	<optional>	null	This callback is invoked every time the onkeypress event is raised.

Source - input/Keyboard.js, line 110

addKey(keycode) → {Phaser.Key}

If you need more fine-grained control over a Key you can create a new Phaser.Key object via this method. The Key object can then be polled, have events attached to it, etc.

Parameters:

Name	Type	Description
keycode	number	The keycode of the key, i.e. Phaser.Keyboard.UP or Phaser.Keyboard.SPACEBAR

Returns:

Phaser.Key -

The Key object which you can store locally and reference directly.

Source - input/Keyboard.js, line 140

addKeyCapture(keycode)

By default when a key is pressed Phaser will not stop the event from propagating up to the browser. There are some keys this can be annoying for, like the arrow keys or space bar, which make the browser window scroll. You can use addKeyCapture to consume the keyboard event for specific keys so it doesn't bubble up to the the browser. Pass in either a single keycode or an array/hash of keycodes.

Parameters:

Name	Type	Description
keycode	number | array | object	Either a single numeric keycode or an array/hash of keycodes: [65, 67, 68].

Source - input/Keyboard.js, line 268

clearCaptures()

Clear all set key captures.

Source - input/Keyboard.js, line 304

createCursorKeys() → {object}

Creates and returns an object containing 4 hotkeys for Up, Down, Left and Right.

Returns:

object -

An object containing properties: up, down, left and right. Which can be polled like any other Phaser.Key object.

Source - input/Keyboard.js, line 178

destroy()

Stops the Keyboard event listeners from running (keydown and keyup). They are removed from the window. Also clears all key captures and currently created Key objects.

Source - input/Keyboard.js, line 251

isDown(keycode) → {boolean}

Returns true of the key is currently pressed down. Note that it can only detect key presses on the web browser.

Parameters:

Name	Type	Description
keycode	number	The keycode of the key to remove, i.e. Phaser.Keyboard.UP or Phaser.Keyboard.SPACEBAR

Returns:

boolean -

True if the key is currently down.

Source - input/Keyboard.js, line 500

justPressed(keycode, duration) → {boolean}

Returns the "just pressed" state of the key. Just pressed is considered true if the key was pressed down within the duration given (default 250ms)

Parameters:

Name	Type	Argument	Default	Description
keycode	number			The keycode of the key to remove, i.e. Phaser.Keyboard.UP or Phaser.Keyboard.SPACEBAR
duration	number	<optional>	50	The duration below which the key is considered as being just pressed.

Returns:

boolean -

True if the key is just pressed otherwise false.

Source - input/Keyboard.js, line 454

justReleased(keycode, duration) → {boolean}

Returns the "just released" state of the Key. Just released is considered as being true if the key was released within the duration given (default 250ms)

Parameters:

Name	Type	Argument	Default	Description
keycode	number			The keycode of the key to remove, i.e. Phaser.Keyboard.UP or Phaser.Keyboard.SPACEBAR
duration	number	<optional>	50	The duration below which the key is considered as being just released.

Returns:

boolean -

True if the key is just released otherwise false.

Source - input/Keyboard.js, line 477

<internal> processKeyDown(event)

Process the keydown event.

Parameters:

Name	Type	Description
event	KeyboardEvent

Internal:

• This member is internal (protected) and may be modified or removed in the future.

Source - input/Keyboard.js, line 334

<internal> processKeyPress(event)

Process the keypress event.

Parameters:

Name	Type	Description
event	KeyboardEvent

Internal:

• This member is internal (protected) and may be modified or removed in the future.

Source - input/Keyboard.js, line 372

<internal> processKeyUp(event)

Process the keyup event.

Parameters:

Name	Type	Description
event	KeyboardEvent

Internal:

• This member is internal (protected) and may be modified or removed in the future.

Source - input/Keyboard.js, line 395

removeKey(keycode)

Removes a Key object from the Keyboard manager.

Parameters:

Name	Type	Description
keycode	number	The keycode of the key to remove, i.e. Phaser.Keyboard.UP or Phaser.Keyboard.SPACEBAR

Source - input/Keyboard.js, line 161

removeKeyCapture(keycode)

Removes an existing key capture.

Parameters:

Name	Type	Description
keycode	number

Source - input/Keyboard.js, line 292

reset(hard)

Resets all Keys.

Parameters:

Name	Type	Argument	Default	Description
hard	boolean	<optional>	true	A soft reset won't reset any events or callbacks that are bound to the Keys. A hard reset will.

Source - input/Keyboard.js, line 430

start()

Starts the Keyboard event listeners running (keydown and keyup). They are attached to the window. This is called automatically by Phaser.Input and should not normally be invoked directly.

Source - input/Keyboard.js, line 195

stop()

Stops the Keyboard event listeners from running (keydown, keyup and keypress). They are removed from the window.

Source - input/Keyboard.js, line 234

update()

Updates all currently defined keys.

Source - input/Keyboard.js, line 315