pxt-calliope/docs/reference/input/on-button-pressed.md

48 lines
1.2 KiB
Markdown
Raw Permalink Normal View History

2016-03-26 00:47:20 +01:00
# On Button Pressed
Start an [event handler](/reference/event-handler) (part of the program that will run when something happens, like when a button is pressed).
This handler works when button `A` or `B` is pressed, or `A` and `B` together.
When you are using this function in a web browser, click the buttons on the screen instead of the ones
on the @boardname@.
2016-03-26 00:47:20 +01:00
```sig
input.onButtonPressed(Button.A, () => {})
```
### Example: count button clicks
This example counts how many times you press the `A` button.
Each time you press the button, the [LED screen](/device/screen) shows the `count` variable getting bigger.
2016-03-26 00:47:20 +01:00
```blocks
let count = 0
basic.showNumber(count)
input.onButtonPressed(Button.A, () => {
count++;
basic.showNumber(count);
})
```
### Example: roll dice
2016-03-26 00:47:20 +01:00
2016-05-21 00:36:37 +02:00
This example shows a number from 1 to 6 when you press the `B` button.
2016-03-26 00:47:20 +01:00
```blocks
input.onButtonPressed(Button.B, () => {
let dice = Math.random(6) + 1
2016-03-26 00:47:20 +01:00
basic.showNumber(dice)
})
```
### ~hint
This program adds a `1` to `random(6)` so the numbers on the dice will come out right.
Otherwise, sometimes they would show a `0`.
### ~
2016-03-26 00:47:20 +01:00
### See also
[button is pressed](/reference/input/button-is-pressed), [forever](/reference/basic/forever), [random](/blocks/math)
2016-03-26 00:47:20 +01:00