Files
Basalt2/docs/references/elements/Timer.md
2025-09-13 20:28:52 +00:00

54 lines
1.5 KiB
Markdown

# Timer
_The Timer is a non-visual element that can be used to perform actions at specific intervals._
Extends: `BaseElement`
## Properties
|Property|Type|Default|Description|
|---|---|---|---|
|interval|number|1|The interval in seconds at which the timer will trigger its action.|
|action|function|function|The action to be performed when the timer triggers.|
|running|boolean|false|Indicates whether the timer is currently running or not.|
|amount|number|-1|The amount of time the timer should run.|
## Functions
|Method|Returns|Description|
|---|---|---|
|[Timer.new](#timer-new)|table|Creates a new Timer instance|
|[Timer:init](#timer-init-props-basalt)|-|Initializes the Timer instance|
|[Timer:start](#timer-start-self)|Timer|Starts the timer|
|[Timer:stop](#timer-stop-self)|Timer|Stops the timer|
|[Timer:dispatchEvent](#timer-dispatchevent)|-|Dispatches events to the Timer instance|
## Timer.new()
### Returns
* `table` `self` The created instance
## Timer:init(props, basalt)
### Parameters
* `props` `table` The properties to initialize the element with
* `basalt` `table` The basalt instance
## Timer:start(self)
Starts the timer with the specified interval.
### Parameters
* `self` `Timer` The Timer instance to start
### Returns
* `Timer` `self` The Timer instance
## Timer:stop(self)
Stops the timer if it is currently running.
### Parameters
* `self` `Timer` The Timer instance to stop
### Returns
* `Timer` `self` The Timer instance
## Timer:dispatchEvent()